third-party-integrations

サードパーティ連携

val で外部サービスを使用する場合は、次の順序に従ってください。手順を省略したり、学習データの記憶だけを頼りに連携コードを書いたりしないでください。Val Town のガイドには、プラットフォーム固有のパターンや必須の回避策が記載されており、学習データには含まれていません。

ワークフロー

1. まず Val Town のガイドを取得します。 ガイドは https://docs.val.town/guides/ 以下にありますが、スラッグが必ずしもサービス名だけとは限りません。カテゴリの下にまとめられているもの（例：databases/neon-postgres/、browser-automation/kernel/）や、サブページにあるもの（slack/agent/）もあります。URL を推測しないでください。https://docs.val.town/sitemap-0.xml からドキュメントのサイトマップを取得し（すべてのドキュメント URL が記載されています）、該当するサービスに一致する guides/… のエントリーを見つけて、そのページを取得してから連携コードを書いてください。
2. ユーザーが認証情報を取得できるよう支援します。 API キーの作成画面への直接リンク、または OAuth の設定手順を提示してください。ユーザーに探させないでください。
3. 機能を構築する前に、最小限のスクリプトで接続をテストします（レコードを 1 件返す単一の fetch／SDK 呼び出し）。これにより、認証や設定の問題と機能のバグを切り分けられます。
4. シークレットは環境変数に保存します。 Deno.env.get("KEY_NAME") で読み取り、README に必要な環境変数を記載して、ユーザー（または val をリミックスする人）が設定できるようにします。ユーザーが設定する必要のある環境変数を参照する場合は、事前入力済みの Val Town 環境変数エディターへの完全な URL を、次の正確な形式で独立した行に記載してください：👉 Add KEY_NAME here: https://www.val.town/x/HANDLE/VAL_NAME/environment-variables?key=KEY_NAME。URL はリンクテキストの背後に隠さず、見える状態にしてください。これが行動喚起になります。

利用可能なガイド

現在、専用ガイドがあるサービスです。すべてを網羅しているわけではないため、最新情報は手順 1 のサイトマップを参照してください。

• メッセージング／チャット： Slack、Discord、Telegram
• 決済： Stripe
• メール： Gmail（ユーザーのアカウントを使った送信向け。組み込みメールを使う場合は、代わりに std/email を使用してください。email スキルを参照）
• Google： Google Sheets
• 外部データベース： Neon Postgres、Supabase、Upstash（SQLite には組み込みの std/sqlite を使用してください。sqlite-storage スキルを参照）
• ブラウザー自動化： Kernel（Playwright に推奨）、Browserbase、Steel、Browserless
• ソース管理／ウェブフック： GitHub（ウェブフックを含む）
• コンテンツ／出力： RSS フィード、PDF 生成、ウェブスクレイピング
• 通知： プッシュ通知
• 認証： OAuth プロバイダー（Val Town アカウントでログインする場合は、代わりに std/oauth を使用してください）

重要な理由

連携コードは、モデルが最もよく幻覚を起こす箇所です。API は変更され、認証フローは改訂され、プラットフォームの制約（ファイルシステムなし、サブプロセスなし）によって単純なアプローチが機能しないことがあります。プラットフォームで現在動作する方法については、Val Town のガイドが信頼できる情報源です。