代理店向けソーシャルメディア API:顧客のアカウントを自社のソフトウェアから運用
代理店向けソーシャルメディア API を使うと、代理店自身のソフトウェアから、顧客ごとのアカウントの接続、投稿、返信、レポート作成を行えます。easyCoexistence の Partner API では、顧客の WhatsApp の電話番号と Instagram、Facebook、TikTok、YouTube、LinkedIn のアカウントが、顧客 ID を付けたホスト型リンクから代理店のアカウントに加わります。1 つの API キーで、それらすべての予約投稿、振り分け、監視ができます。
接続セッションが受け付ける external_ref の最大長。代理店が顧客に付けた ID で、各接続に保存されます。
ホスト型の接続リンクが、開いた顧客に対して有効な期間。
App Review とビジネス認証を経た後に、Meta アプリが、自社で所有または管理していない Instagram プロアカウントを扱うために必要な条件。
メンバーが rw_organization_admin 権限を使うために必要な LinkedIn ページのロール。ページの管理とレポートの読み取りを行います。
代理店が API で削除した顧客の接続について、課金が止まるタイミング。
代理店の顧客は、API でどう整理されますか?
代理店が付ける顧客 ID で整理されます。すべての接続セッションで external_ref として送ると、そのセッションが作成する各電話番号とアカウントに残り、ステータスイベントのたびに返されます。GET /channels?external_ref=client_118 でその顧客のソーシャルアカウントを一覧でき、&channel=instagram を付けると 1 つのネットワークに絞り込めます。GET /connections?external_ref=client_118 では、その顧客の WhatsApp の電話番号を一覧できます。すべての顧客は代理店の 1 つのアカウントにまとまり、1 つの ec_live_ キーのもとに置かれるため、件数全体が 1 つの料金帯に収まります。
curl "https://easycoexistence.com/api/v1/channels?external_ref=client_118" \
-H "Authorization: Bearer $EC_API_KEY"
curl "https://easycoexistence.com/api/v1/connections?external_ref=client_118" \
-H "Authorization: Bearer $EC_API_KEY"顧客はどのようにアクセスを渡しますか?
代理店が送るリンクを通じてです。channel にネットワークを、external_ref に顧客の ID を、partner_name に代理店名を指定して POST /connect-sessions を送ると url が返ります。顧客はそのリンクを開き、各ネットワークの同意画面でサインインします。WhatsApp の電話番号の場合は、Meta のポップアップを開いて QR コードを読み取ります。完了すると、代理店の redirect_url に戻ります。Facebook や LinkedIn でのサインインでは複数のページが一度に接続されることがあり、各ページがそれぞれ独立した接続になるため、顧客の依頼内容と一覧を照らし合わせてください。
代理店は顧客のために、どのように投稿しますか?
代理店自身の承認フローからです。代理店のソフトウェアは、顧客の承認が出るまで下書きを保管し、承認された投稿を 1 件ずつ、publish_at を付けて POST /channels/:id/posts に送ります。publish_at は最大 90 日先まで指定できます。GET /channels/:id/posts で 1 つのアカウントのカレンダーを取得でき、status でフィルターした GET /posts では、全顧客の承認待ちの投稿を確認できます。post.published と post.failed で、アカウントマネージャーに結果を伝えられます。LinkedIn の投稿は必ず個人の承認を通すことになっており、代理店の承認ステップがその役割を果たします。
代理店は、顧客のコメントや DM にどう返信しますか?
アカウントごとに振り分けられる 1 つの受信箱からです。PUT /channels/:id/webhook で、各 Instagram アカウント、Facebook ページ、TikTok アカウントの転送先を設定します。転送される各コメント、メンション、DM には account_id が含まれ、それが顧客に対応付けられます。WhatsApp の電話番号宛てのメッセージは、Meta から、その番号に設定された webhook_url に届きます。返信は、GET /channels/:id?credentials=1 で得た認証情報を使って、各ネットワークの API から送られます。代理店のチームは、同じアカウントの MCP コネクターを通じて、Claude や ChatGPT で顧客をまたいで作業することもできます。
代理店は、顧客ごとのレポートをどう作成しますか?
各ネットワーク独自の分析データから、顧客アカウントの認証情報を使って取得します。Instagram と Facebook のインサイトは Meta の Graph API から、TikTok のものは TikTok のビジネス向け API から、YouTube のものは YouTube Analytics から取得します。YouTube Analytics の基盤となるベース URL は認証情報に含まれています。LinkedIn のものは、統計用のエンドポイントから取得します。代理店のレポートジョブは、実行のたびに各アカウントの最新の認証情報を取得し、対象期間の数値を取り込んで、顧客の external_ref の下に保存します。
代理店は、顧客のアカウントに対応が必要なことをどう知りますか?
署名付きのステータスイベントからです。channel.disconnected と connection.disconnected には顧客の external_ref が含まれるため、代理店のソフトウェアは、その顧客のアカウントマネージャーに通知したり、顧客に新しい接続リンクを送ったりできます。すべての接続は 24 時間体制で監視されており、接続が切れた場合は代理店のオーナーにもメールが届きます。顧客がネットワークの設定でアクセスを取り消した場合も、同じように通知されます。
顧客が離脱したとき、API では何が起きますか?
代理店の退会処理ジョブが、external_ref で顧客の接続を一覧し、各接続に対して DELETE /channels/:id と DELETE /connections/:id を呼び出します。課金は請求サイクルの終わりで停止し、削除されたチャネルの予約投稿はキャンセルされ、削除されたソーシャルアカウントのトークンは破棄されます。WhatsApp の電話番号は、顧客が WhatsApp Business アプリで切断するまで Cloud API に残ります。
よくある間違い
- 承認前に顧客の投稿をキューに入れること。キューに入った投稿は、時刻になるとそれ以上のチェックなしで公開されます。下書きは代理店の承認ステップで保留し、承認された後にのみ送ってください。
- Partner API キーを顧客ポータルのフロントエンドに置くこと。このキーはアカウント上のすべての顧客の認証情報に届くため、代理店のサーバーで保管してください。
- 顧客の YouTube チャンネルや LinkedIn ページのコメントイベントを待つこと。easyCoexistence はどちらのコメントイベントも受け取らないため、レポートや受信箱のジョブは各ネットワークの API から読み取ってください。
easyCoexistence は、代理店自身のソフトウェアに、顧客の WhatsApp の電話番号と Instagram、Facebook、TikTok、YouTube、LinkedIn のアカウントを 1 つの API で扱える環境を提供します。さらに、顧客ごとにタグを付けたホスト型の接続リンク、投稿キュー、転送されるコメントや DM、レポート用の最新の認証情報、24 時間体制の接続監視にも対応しています。今後もチャネルは追加されます。料金は接続 1 件あたり月額 US$ 9 から US$ 0.75 まで、接続を増やすほど下がります。最初の 3 日間は無料です。
よくある質問
顧客も easyCoexistence のアカウントが必要ですか?
いいえ。顧客はホスト型リンクを開いてサインインするだけです。接続は代理店のアカウントに加わり、そこで課金され、監視されます。
代理店は顧客ごとに別々の API キーを使い分けられますか?
1 つのアカウントには 1 つのキーがあります。キーを分けるには、それぞれ別の easyCoexistence アカウントが必要になり、どちらも最初の料金帯から課金されます。そのため多くの代理店は、external_ref で顧客を分けて管理しています。
顧客は接続時に代理店の名前を見られますか?
はい。ホストされたページには partner_name で送られた名前が表示されます。ネットワーク自身の同意画面では、アクセスを求めているアプリとして easyCoexistence の名前が表示されます。
代理店にとって easyCoexistence の料金はいくらですか?
顧客の接続 1 件あたり月額 US$ 9 から US$ 0.75 まで、代理店が顧客を増やすほど下がります。どのネットワークでも同じ料金で、最初の 3 日間は無料です。
続きを読む
最初のチャンネルを 2 分で接続しましょう。
プラットフォームの審査を待つ必要はありません。WhatsApp、Instagram、TikTok などのチャンネルを接続して、AI に投稿、返信、レポートを任せてみてください。
- 3 日間無料
- いつでも解約可能
- 公式 API のみ使用
- 24/7 監視
確認日