ログイン無料トライアルを開始
easyCoexistence 公式 API

顧客の 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、そして更新済みのアクセストークンを返すため、各ジョブの開始時に取得してください。

?credentials=1

WhatsApp 番号の場合は GET /connections/{id}、ソーシャルアカウントの場合は GET /channels/{id} に認証情報を追加します。

1 hour

YouTube チャンネルの API 呼び出しで使われる、Google ユーザーのアクセストークンの有効期間。

1 day

API for Business から取得する TikTok アカウントのアクセストークンの有効期間。リフレッシュトークンの有効期間は 1 年です。

60 days

更新された長期 Instagram トークンが有効な期間。カウントは更新日から始まります。

No expiry

Meta の長期 Page アクセストークンには有効期限がありませんが、特定の条件下で無効になることがあります。

接続の認証情報を返すのはどの呼び出しですか?

リソース自体の GET に ?credentials=1 を付け、ec_live_ キーをベアラートークンとして認証します。WhatsApp 番号は /connections/{id}、ソーシャルアカウントは /channels/{id} にあり、それぞれ独自の ID 空間を持ちます。接続リダイレクトは、番号には connection_id、ソーシャルアカウントには channel_id を返します。GET /connections と GET /channels で一覧を取得でき、?external_ref= を指定すると、どちらの一覧も 1 人の顧客に絞り込めます。パラメータがなければ、同じ呼び出しでもトークンを含まない接続が返されます。

Credentials for a number and for a social account
# 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 形式のタイムスタンプです。
GET /connections/{id}?credentials=1
{
  "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 のフィールドと、各ネットワークが必要とするその他の項目は、ネットワークごとに異なります:

Instagramgraph_api_base https://graph.instagram.com/v25.0 and account_id_on_meta, the Instagram account's ID. A user token, refreshed before its 60 days run out.
Facebookgraph_api_base https://graph.facebook.com/v25.0 and account_id_on_meta, the Page ID. A Page token that does not expire while the Page stays connected.
TikTokapi_base https://business-api.tiktok.com/open_api/v1.3 and business_id. A day-long token, sent in an Access-Token header with business_id on each call.
YouTubeapi_base https://www.googleapis.com/youtube/v3, analytics_api_base for YouTube Analytics v2, and channel_id. An hour-long Google token, sent as a bearer token.
LinkedInapi_base https://api.linkedin.com/rest, author_urn for the Page or profile, and required_headers with LinkedIn-Version and X-Restli-Protocol-Version 2.0.0.

なぜトークンを保存せず、ジョブごとに取得するのですか?

ソーシャルのトークンには 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 で実現する

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 監視

確認日