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

SaaS 向け統合ソーシャルメディア API: WhatsApp、Instagram、Facebook、TikTok、YouTube、LinkedIn などを 1 つの連携で

easyCoexistence の Partner API を使うと、SaaS は顧客の WhatsApp、Instagram、Facebook、TikTok、YouTube、LinkedIn などのチャネルを 1 つの連携で扱えます。API キー 1 つと接続セッションの呼び出し 1 回で接続でき、同じ呼び出しで一覧の取得、最新の認証情報の再取得、Webhook の設定、署名付きのステータスイベントの受信ができます。さらに投稿用エンドポイント 1 つで Instagram、Facebook、TikTok、LinkedIn に投稿できます。返信は、各ネットワーク自身の API に顧客のトークンを使って直接送られます。

1 key

Partner API キーは easyCoexistence アカウントごとに発行され、そのアカウントが接続するすべての番号と SNS アカウントはそのアカウントに属します。

US$ 9 to US$ 0.75

料金は接続 1 件あたりの月額で、WhatsApp 番号も SNS アカウントも同じ額です。接続数が増えるほど下がります。

100 posts

API で投稿できる Instagram アカウントの件数は、直近 24 時間の範囲で数えられます。カルーセルは 1 件として数えます。

15 a day

TikTok に API 経由で投稿できる動画は、アカウントごとに 1 分あたり最大 6 件です。

24 hours

WhatsApp のカスタマーサービスウィンドウは、ユーザーのメッセージから始まります。閉じた後は、承認済みのテンプレートしか送信できません。

1 つの連携でカバーされる範囲は?

ネットワークを問わず共通の作業は、ec_live_ 形式の API キー 1 つを使って https://easycoexistence.com/api/v1 から行います。コードはこれらの呼び出しを一度覚えれば足ります。顧客の TikTok アカウントも Instagram アカウントと同じ扱いになり、同じエラー、同じ ID、同じ署名付きイベントが届きます:

ConnectPOST /connect-sessions, with channel set to the network
ListGET /connections for numbers, GET /channels for social accounts
Credentials?credentials=1 on either, with tokens renewed for you
WebhooksPUT /connections/{id}/webhook or PUT /channels/{id}/webhook
Status eventsconnection.* and channel.*, signed, with your external_ref
PostsPOST /channels/{id}/posts, now or at publish_at
RemoveDELETE on the connection or the channel

各ネットワークがそれぞれ決める範囲は?

そのネットワークの API が許す範囲です。easyCoexistence はどのアカウントも同じ方法で接続、更新、監視しますが、製品で提供できる機能は各ネットワーク独自のルールに従います。そのため DM、コメントイベント、投稿の種類はネットワークごとに異なります:

WhatsAppMessages and replies on the Cloud API, templates outside the 24-hour window
InstagramPosts, carousels, Reels and Stories; comments; replies to DMs
FacebookPage posts; comments; replies to Messenger DMs
TikTokVideo and photo posts; public replies to comments; no DMs
YouTubeUploads and comments through YouTube's own API; no DMs
LinkedInPosts a person approves, text with an image or a link; no DMs

番号と SNS アカウントを別のリソースとするのはなぜ?

保持するものが異なるためです。番号には電話番号、WhatsApp Business アカウント、Meta のレーティングがあり、SNS アカウントにはハンドルとネットワーク ID があります。そのため番号は /connections に、SNS アカウントは /channels にあり、それぞれ独自の ID、独自のリダイレクトパラメータ(connection_id または channel_id)、独自のイベント名を持ちます。WhatsApp だけの連携は、要求しない限りチャネルに触れることはなく、共通するのは接続の呼び出しだけです。

複数ネットワークにまたがる投稿の呼び出しはどう動きますか?

リクエストの本文はどこでも同じで、text、media、link、publish_at のほか、一部のネットワークだけが読むフィールドがあります。たとえば Instagram の ig_type、TikTok の title と disable_comment、LinkedIn の image_alt です。各ネットワークの制限は、投稿がキューに入る前に確認されます:

  • Instagram: 画像または動画 1 件、または 2〜10 件のカルーセル。JPEG 画像のみ。link フィールドはなし。本文は 2,200 文字まで。
  • Facebook: テキスト、リンク、画像 1 件または動画 1 件。本文は 63,206 文字まで。
  • TikTok: 動画 1 件、または JPEG か WebP の画像 1 〜 35 枚の写真投稿。link はなし。本文は 2,200 文字まで。
  • LinkedIn: 画像 1 件またはリンク 1 件を付けたテキスト(リンクにはタイトルが必要)。動画は不可。本文は 3,000 文字まで。

easyCoexistence はあなたのコードとネットワークの間に入りますか?

手間が省ける場合に限ります。接続、トークンの更新、コメントと DM のイベントの転送、投稿キューの実行です。返信、読み取り、その他の処理は、あなたのバックエンドから顧客のトークンを使って各ネットワークの API に直接送られます。また Meta は番号宛てのメッセージを直接あなたのサーバーに配信します。ネットワークが新しく追加した機能は、ラッパーの提供を待つことなく、そのネットワークが公開した時点からコードで利用できます。

新しいネットワークが加わるとどうなりますか?

同じ呼び出しに、新しい channel の値として加わる形です。接続セッションでそのネットワークを指定すると、そのアカウントが GET /channels に表示され、イベントは channel.* の名前で届き、各アカウントの料金は他の接続と同じです。アカウントがまだ利用できないチャネルを指定すると、400 channel_unavailable が返され、そのメッセージにはアカウントで利用可能なチャネルの一覧が含まれます。

設定方法

  1. Create a keyIn the dashboard under Profile, Developers, create the ec_live_ key and store it in your backend's secrets.
  2. Save a cardAdd a card to the account, since connect sessions answer 402 billing_required until one is saved.
  3. Connect each customerCreate a connect session with the channel and your customer's id as external_ref, and send the customer to its url.
  4. Set the webhooksGive each number a webhook_url and each social account a destination with PUT /channels/{id}/webhook.
  5. Post and replyPublish with POST /channels/{id}/posts and reply through each network's API with fresh credentials.

よくある間違い

  • TikTok、YouTube、LinkedIn の DM 機能を作ること。これらの接続には DM がないため、そこではコメントへの返信を計画し、DM への返信は WhatsApp、Instagram、Messenger に限ってください。
  • メディアなしで Instagram に投稿すること。Instagram は画像または動画を必要とし、キューに入る前にリクエストが拒否されるため、ネットワークごとにメディアを添付してください。
  • channel_id と connection_id を種類を区別せず同じ列に保存すること。これらは ID の異なる別のリソースなので、各値がどちらのものかを区別して保持してください。
  • 確認なしのフィードから LinkedIn に投稿すること。LinkedIn の API 利用規約は自動投稿を制限しているため、LinkedIn の投稿は必ず人が事前に承認してください。
EasyCoexistence で実現する

easyCoexistence は、SaaS に対して、顧客の WhatsApp 番号と、Instagram、Facebook、TikTok、YouTube、LinkedIn のアカウントを 1 つの連携で扱えるようにします。さらに多くのチャネルにも対応していきます。接続リンク、認証情報、Webhook、ステータスイベント、投稿を、各ネットワークの公式 API 上で提供し、すべての接続を 24 時間 365 日監視します。料金は接続 1 件あたり月額 US$ 9 から US$ 0.75 まで、接続を増やすほど下がります。最初の 3 日間は無料です。

よくある質問

1 つのエンドポイントで全ネットワークのイベントを受け取れますか?

はい。各チャネルの送信先を同じ URL に設定し、本文の platform と account_id でルーティングしてください。WhatsApp 番号のメッセージは Meta からその番号の webhook_url に届き、その URL は同じサーバーにできます。

Meta、TikTok、Google、LinkedIn に自分のアプリを登録する必要はありますか?

いいえ。顧客は easyCoexistence のアプリを通じて各ネットワークにサインインし、あなたのバックエンドは各ネットワークの API を呼び出すのに必要なトークンを受け取ります。

投稿エンドポイントはどのネットワークに投稿しますか?

Instagram、Facebook のページ、TikTok、LinkedIn です。YouTube の動画は、チャネルの認証情報を使って YouTube 独自の API からアップロードされます。

easyCoexistence の統合 API の料金はいくらですか?

どのネットワークでも同じです。接続 1 件あたり月額 US$ 9 から US$ 0.75 までで、接続の総数の帯域によって決まります。最初の 3 日間は無料です。

続きを読む

最初のチャンネルを 2 分で接続しましょう。

プラットフォームの審査を待つ必要はありません。WhatsApp、Instagram、TikTok などのチャンネルを接続して、AI に投稿、返信、レポートを任せてみてください。

  • 3 日間無料
  • いつでも解約可能
  • 公式 API のみ使用
  • 24/7 監視

確認日