顧客の WhatsApp、Instagram、TikTok 向け API トークンの取得方法
easyCoexistence の Partner API は、GET と ?credentials=1 を 1 回呼び出すだけで、接続済みの顧客の API トークンと ID を返します。WhatsApp 番号の場合、/connections/{id} は waba_id、phone_number_id、Graph API のベース URL、送信エンドポイント、そして顧客自身のビジネストークンを返します。ソーシャルアカウントの場合、/channels/{id} はそのネットワークの API ベース、そのネットワーク上のアカウント ID、そして更新済みのアクセストークンを返すため、各ジョブの開始時に取得してください。
WhatsApp 番号の場合は GET /connections/{id}、ソーシャルアカウントの場合は GET /channels/{id} に認証情報を追加します。
YouTube チャンネルの API 呼び出しで使われる、Google ユーザーのアクセストークンの有効期間。
API for Business から取得する TikTok アカウントのアクセストークンの有効期間。リフレッシュトークンの有効期間は 1 年です。
更新された長期 Instagram トークンが有効な期間。カウントは更新日から始まります。
Meta の長期 Page アクセストークンには有効期限がありませんが、特定の条件下で無効になることがあります。
接続の認証情報を返すのはどの呼び出しですか?
リソース自体の GET に ?credentials=1 を付け、ec_live_ キーをベアラートークンとして認証します。WhatsApp 番号は /connections/{id}、ソーシャルアカウントは /channels/{id} にあり、それぞれ独自の ID 空間を持ちます。接続リダイレクトは、番号には connection_id、ソーシャルアカウントには channel_id を返します。GET /connections と GET /channels で一覧を取得でき、?external_ref= を指定すると、どちらの一覧も 1 人の顧客に絞り込めます。パラメータがなければ、同じ呼び出しでもトークンを含まない接続が返されます。
# A WhatsApp number
curl "https://easycoexistence.com/api/v1/connections/$CONNECTION_ID?credentials=1" \
-H "Authorization: Bearer $EC_API_KEY"
# A social account
curl "https://easycoexistence.com/api/v1/channels/$CHANNEL_ID?credentials=1" \
-H "Authorization: Bearer $EC_API_KEY"WhatsApp 番号の認証情報の呼び出しは何を返しますか?
接続そのものと、credentials オブジェクトを返します。waba_id と phone_number_id は、Meta の Graph API 上の WhatsApp Business Account と番号を識別し、token_ready は顧客のトークンが保存されているかを示します。credentials の中では、graph_api_base と send_endpoint に Graph API のバージョンが既に含まれており、access_token は、顧客が接続したときに Meta が発行した、その顧客に限定されたビジネストークンです。送信、テンプレート管理、メディアのアップロード、ビジネスプロフィールの編集は、アプリのバックエンドから Meta を直接呼び出して行います。
- status: connected, degraded, disconnected, banned, suspended, removed, unknown のいずれかです。
quality_ratingとmessaging_tier: Meta の品質評価(GREEN など)と番号の階層(TIER_1Kなど)。webhook_url: Meta が番号のメッセージを送る Webhook の URL。未設定の場合は null。disconnected_reason、last_checked_at、last_event_at、created_at: 記録がある場合の Meta による切断理由と、ISO 8601 形式のタイムスタンプです。
{
"id": "<CONNECTION_ID>",
"external_ref": "customer_4821",
"connect_session_id": "cs_…",
"phone": "+55 11 9…",
"name": "Clínica Sorriso",
"waba_id": "<WABA_ID>",
"phone_number_id": "<PHONE_NUMBER_ID>",
"status": "connected",
"quality_rating": "GREEN",
"messaging_tier": "TIER_1K",
"platform_type": "…",
"token_ready": true,
"webhook_url": "https://hooks.example.com/wa/<long-random-secret>",
"disconnected_reason": null,
"last_checked_at": "2026-10-31T09:00:00.000Z",
"last_event_at": "2026-10-31T08:41:12.000Z",
"created_at": "2026-10-20T14:03:55.000Z",
"credentials": {
"graph_api_base": "https://graph.facebook.com/v25.0",
"send_endpoint": "https://graph.facebook.com/v25.0/<PHONE_NUMBER_ID>/messages",
"access_token": "EAAG…",
"note": "The customer's own business token, scoped to their assets. …"
}
}ソーシャルネットワークごとの認証情報の呼び出しは何を返しますか?
チャンネルの表示内容は GET /channels/{id} と同じで、id、channel、external_ref、name、username、external_id、status、token_ready に加えて credentials オブジェクトを返します。どのネットワークの credentials も、platform、API ベース、そのネットワーク上のアカウント ID、access_token、token_expires_at、token_note、呼び出し例を含みます。ID のフィールドと、各ネットワークが必要とするその他の項目は、ネットワークごとに異なります:
なぜトークンを保存せず、ジョブごとに取得するのですか?
ソーシャルのトークンには 1 日以内に入れ替わるものがあり、認証情報の呼び出しは、その時点で有効なトークンを必ず返すためです。YouTube の Google トークンは 1 時間、TikTok のトークンは 1 日で期限が切れますが、easyCoexistence はどちらも期限が切れる前に更新します。Instagram のトークンは 60 日間有効で、それより十分前に更新され、新しいトークンが発行されます。Facebook の Page トークンは、Page が接続されている限り期限切れになりません。ジョブの開始時に 1 回リクエストすることで、期限切れのトークンでネットワークを呼び出すことがなくなります。
WhatsApp 番号のトークンは保存すべきですか?
はい。これは Meta の Embedded Signup が発行するビジネストークンで、Meta はそれをオンボーディングされた顧客に限定しています。ダッシュボードには表示されないため、リファレンスでは利用側での保存が求められています。再接続によって新しいトークンが発行されることがあるため、connection.connected イベントを受け取るたびに読み直してください。停止または削除された番号のトークンは、もう提供されません。番号が応答を続けていても Meta が受け付けなくなった顧客トークンは無効化され、token_ready が false になります。
token_ready と token_missing は何を意味しますか?
token_ready は、顧客トークンが保存されていて、接続が有効なときに true になります。番号の場合、接続直後は false になることがあります。Meta が顧客のトークンを発行せずに Embedded Signup を完了する場合があるためです。その場合、ホスト型ページは顧客にもう一度手続きを求め、イベントのエンドポイントは connection.token_missing を受け取ります。顧客がこれをスキップすると、番号は ID が有効なのでメッセージを受信できますが、送信はできません。その顧客に対して新しい接続セッションを開始するとトークンが発行されます。ただし、既に機能しているトークンを置き換えることはありません。ソーシャルチャンネルには token_missing がありません。サインインのたびに顧客自身のトークンが得られるため、token_ready は status に従います。
接続にトークンがない場合、何が返されますか?
エラーではなく、access_token が null で、対処方法を示す note を含む 200 が返されます。対象は、token_ready が false の番号、停止または削除された番号、status が connected ではないチャンネルです。チャンネルの場合、note は新しい接続セッションを開始するよう求めます。404 not_found は、その ID がご利用のアカウントにないことを意味します。502 credentials_unavailable は、その時点で新しいソーシャルトークンを取得できなかったことを意味します。再試行してください。繰り返す場合は、チャンネルの status を確認してください。
よくある間違い
- YouTube や TikTok のトークンを設定ファイルにキャッシュすること。YouTube は 1 時間以内、TikTok は 1 日以内に期限が切れるため、ジョブの開始ごとに認証情報のエンドポイントを呼び出し、更新は easyCoexistence に任せてください。
- token_ready が false の番号から送信すること。Meta の呼び出しに使える顧客トークンがありません。その顧客に対して新しい接続セッションを開いてください。これによりトークンが発行されます。
- Authorization ヘッダーを付けて TikTok を呼び出すこと。TikTok の Business API はトークンを Access-Token ヘッダーで受け取り、すべてのリクエストにアカウントの business_id を付けます。
- ベアラートークンだけで LinkedIn を呼び出すこと。LinkedIn は required_headers に記載された LinkedIn-Version と X-Restli-Protocol-Version ヘッダーも必要とし、パス内の URN は URL エンコードしてください。
easyCoexistence は、顧客の WhatsApp 番号と、Instagram、Facebook、TikTok、YouTube、LinkedIn のアカウントを接続し、今後も対応チャンネルを増やしていきます。要求に応じて、各接続の認証情報をアプリのバックエンドに渡し、ソーシャルのトークンを更新して、すべての接続を 24 時間 365 日監視します。接続 1 件あたり月額 US$ 9 から、接続を増やすほど下がり US$ 0.75 まで。最初の 3 日間は無料トライアルです。
よくある質問
WhatsApp のトークンは顧客自身のものですか?
はい。顧客が Embedded Signup で接続したときに Meta が発行するビジネストークンで、その顧客に限定されます。easyCoexistence のシステムトークンは公開されることはなく、token_ready が true のときにのみトークンが返されます。
ソーシャルのアクセストークンの有効期間はどのくらいですか?
YouTube は 1 時間、TikTok は 1 日、Instagram は最長 60 日で、Facebook の Page トークンは期限切れになりません。easyCoexistence は入れ替わるトークンを更新するため、認証情報の呼び出しのたびに、今使える有効なトークンが返されます。
各ネットワークで自分専用の開発者アプリが必要ですか?
いいえ。顧客は easyCoexistence 独自のアプリを通じて、Meta、TikTok、Google、LinkedIn にサインインします。認証情報の呼び出しにより、そのネットワークの API を直接呼び出すためのトークンがアプリのバックエンドに渡されます。
Claude や ChatGPT などのアシスタントも同じ認証情報を読めますか?
はい。MCP サーバーでご利用アカウントにサインインすると、番号には get_api_credentials、ソーシャルアカウントには get_social_credentials を呼び出せます。これらは Partner API と同じ認証情報を返します。
続きを読む
最初のチャンネルを 2 分で接続しましょう。
プラットフォームの審査を待つ必要はありません。WhatsApp、Instagram、TikTok などのチャンネルを接続して、AI に投稿、返信、レポートを任せてみてください。
- 3 日間無料
- いつでも解約可能
- 公式 API のみ使用
- 24/7 監視
確認日