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

代理店向けソーシャルメディア API:顧客のアカウントを自社のソフトウェアから運用

代理店向けソーシャルメディア API を使うと、代理店自身のソフトウェアから、顧客ごとのアカウントの接続、投稿、返信、レポート作成を行えます。easyCoexistence の Partner API では、顧客の WhatsApp の電話番号と Instagram、Facebook、TikTok、YouTube、LinkedIn のアカウントが、顧客 ID を付けたホスト型リンクから代理店のアカウントに加わります。1 つの API キーで、それらすべての予約投稿、振り分け、監視ができます。

200 characters

接続セッションが受け付ける external_ref の最大長。代理店が顧客に付けた ID で、各接続に保存されます。

1 hour

ホスト型の接続リンクが、開いた顧客に対して有効な期間。

Advanced Access

App Review とビジネス認証を経た後に、Meta アプリが、自社で所有または管理していない Instagram プロアカウントを扱うために必要な条件。

ADMINISTRATOR

メンバーが rw_organization_admin 権限を使うために必要な LinkedIn ページのロール。ページの管理とレポートの読み取りを行います。

End of cycle

代理店が 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 つの料金帯に収まります。

One client's accounts
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 で実現する

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 日間は無料です。

続きを読む

エージェンシー向け easyCoexistence:顧客のアカウントを一か所で顧客が開く接続リンクで WhatsApp、Instagram、TikTok などを集め、1 つの AI エージェントで一括運用できます。API でソーシャルメディアのスケジューラーを構築する方法: キュー、メディア、投稿ステータスeasyCoexistence の投稿 API で予約投稿を構築。予約は最大 90 日先まで、ステータスは 6 種類。SaaS でソーシャル機能を再販する: 接続 1 件あたり US$ 9 から US$ 0.75 の利益率SaaS が接続 1 件あたり US$ 9 から US$ 0.75 まででソーシャル機能を再販する場合の利益率を、定額と接続単位の例で示します。SaaS を Ayrshare、Zernio、Unipile から easyCoexistence へ移行:コードで変わる点easyCoexistence への移行で変わるコード。接続、channel_id、投稿、署名付きイベントを解説。AI エージェント SaaS のアーキテクチャ:WhatsApp、Instagram、TikTok で顧客のお客様に返信する顧客のお客様に返信する AI エージェント SaaS の五層構成を、接続から送信まで順に説明します。ユーザーが WhatsApp、Instagram、TikTok のアカウントをアプリに接続できるようにする方法ユーザーの WhatsApp 番号とソーシャルアカウントを接続するホスト型リンク。リクエスト、リダイレクト、ステータス、有効期限、再試行を説明します。

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

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

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

確認日