ホワイトラベルのソーシャルメディアAPI: 投稿、コメント、DMを自社ブランドのSaaSに追加
easyCoexistenceのPartner APIを使うと、SaaSは投稿、コメントへの返信、DMの機能を自社製品に、接続ページにあなたの名前を表示したまま追加できます。顧客はあなたの名前が表示されるホスト型の接続ページで接続し、バックエンドはPOST /channels/{id}/postsで投稿を公開します。コメントとDMはあなたのWebhookに届き、製品側から各ネットワークのAPIを通じて返信できます。ネットワークのサインイン画面と、そのページの注釈1件には、easyCoexistenceの名前が表示されます。
partner_nameとしてホスト型接続ページに表示できる製品名の最大長。アカウント名は既定で表示されます。
POST /channels/{id}/postsで投稿を予約できる最長期間。publish_atは現在から1分以上先の時刻を指定します。
人からのメッセージの後、ほとんどのユーザー操作についてInstagramが定める標準のメッセージ送信可能期間。相手が先に書き込む必要があります。
コメントから何時間後まで、Instagramアカウントはそのコメント投稿者に1回限りの非公開返信を送れるか。
SaaSは何を自社ブランドで提供できますか?
顧客が日常的に使う機能はすべてです。投稿作成画面、受信トレイ、通知はすべてあなたの画面で、お使いのec_live_キーと、そのキーで取得するネットワークの認証情報をもとに動作します。顧客がeasyCoexistenceのアカウントを作成する必要はありません。各機能は、Partner APIの1つの要素に対応します:
顧客に何が表示され、どこにeasyCoexistenceの名前が現れますか?
ホスト型の接続ページには、あなたの名前が表示され、easyCoexistenceのロゴは表示されません。ただし、ネットワークは常にアクセスを求めるアプリを表示するため、以下の4箇所ではeasyCoexistenceの名前が残ります。顧客が説明のないままこの名前に出会わないよう、事前に把握しておいてください。
- WhatsAppの番号を接続する際にMetaのEmbedded Signupのポップアップに表示される、要求元アプリの名前。これは変更できません。
- Instagram、Facebook、TikTok、YouTube、LinkedInの同意画面に表示される、easyCoexistenceのアプリ名。
- ホスト型ページの注釈1件。ネットワークがその名前を表示する前に、名前の意味を説明します。
- ホスト型ページのアドレス。easycoexistence.comのドメインです。
自社の作成画面から投稿するにはどうしますか?
作成画面からは、チャネルごとにPOST /channels/{id}/postsへリクエストを1件送信します。リクエストには、テキスト、HTTPSリンクまたはPOST /mediaから得たmedia_idとしてのメディア、そして後で公開する場合のpublish_atを含めます。キューに入る前に各ネットワークのルールが確認されるため、InstagramやTikTokが拒否する投稿は、理由とともにすぐに返されます。Idempotency-Keyヘッダーを送信すると、再送されたリクエストは2重投稿ではなく同じ投稿を返します。LinkedInの投稿は、製品内の担当者が各投稿を承認してから公開されます。
curl -X POST https://easycoexistence.com/api/v1/channels/$CHANNEL_ID/posts \
-H "Authorization: Bearer $EC_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: post_8812" \
-d '{
"text": "Our autumn menu starts Friday.",
"media": [{ "url": "https://cdn.example.com/menu.jpg", "type": "image" }],
"publish_at": "2026-11-07T09:00:00-03:00"
}'コメントとDMはどのように製品に届きますか?
Webhook経由で、アカウントごとに1つの送信先が設定されます。PUT /channels/{id}/webhookでSNSアカウントをあなたのエンドポイントに向け、そのアカウント用の署名シークレットが返されます。easyCoexistenceは、各イベントを届いた時点で転送します。イベントはX-EC-Signatureで署名され、コピーは保持されません。Instagramはコメント、メンション、DMを送信し、Facebookページはフィード、Messenger、メンションのイベントを送信し、TikTokはcomment.updateを送信します。WhatsAppの番号のメッセージは、Metaからwebhook_urlに直接送られます。
製品からはどのように返信しますか?
各ネットワーク自身のAPIを通じて、GET /channels/{id}?credentials=1で取得したトークンを使って返信します。そのため、返信は顧客のアカウントを投稿者として表示します。返信ボタンが行う呼び出しは次のとおりです:
- Instagramのコメント: messageを付けてPOST /<
IG_COMMENT_ID>/repliesを送信。 - InstagramのDM: 相手のIDとテキストを付けてPOST /<
IG_ID>/messagesを送信。相手の最後のメッセージから24時間以内に限ります。 - Instagramのコメントへの非公開返信: 同じエンドポイントを、recipientに
comment_idを指定して使用。各コメントにつき1回、コメントから7日以内に限ります。 - TikTokのコメント: business/comment/reply/create/を呼び出し、公開返信を投稿します。
- WhatsApp: 顧客自身のビジネス用トークンを使い、番号の
send_endpointに送信します。
よくある間違い
- Metaのポップアップ内で顧客に自社の名前を約束すること。Metaは、アクセスを要求するアプリ、つまりeasyCoexistenceのアプリ名を表示します。接続前に、顧客に表示される内容を伝えてください。
- Instagramの、24時間を過ぎたDMに対して返信ボタンを提供すること。期間は既に終了しています。製品で誰かが返信できるようにする前に、相手の最後のメッセージの時刻を確認してください。
- 誰も確認しないスケジュールからLinkedInの投稿を公開すること。LinkedInのAPI規約は自動投稿を制限しているため、製品が送信する前に、担当者が各LinkedIn投稿を承認するようにしてください。
- すべてのチャネルのイベントを1つのシークレットで検証すること。各SNSアカウントは、転送するイベントに独自のシークレットで署名します。このシークレットはPUT /channels/{id}/webhookで一度だけ返されます。
easyCoexistenceは、投稿とコメントやDMへの返信を、お客様のWhatsAppの番号、およびInstagram、Facebook、TikTok、YouTube、LinkedInのアカウント、さらに今後追加されるチャネルの中で、各ネットワークの公式APIを通じて製品内に提供します。接続ページにはあなたの名前が表示され、すべての接続は24時間365日監視されます。料金は接続1件あたり月額US$ 9からUS$ 0.75まで、接続を増やすほど下がります。最初の3日間は無料です。
よくある質問
ホスト型の接続ページを自社ドメインで動かせますか?
いいえ。ページはeasycoexistence.comで動作し、partner_nameから取得した名前を表示します。顧客は、あなたのアプリからのリダイレクトまたは新しいタブでページに移動し、完了するとredirect_urlに戻ります。
顧客はeasyCoexistenceのアカウントが必要ですか?
いいえ。顧客は、製品から渡されたリンクを開き、ネットワークでサインインして、あなたのアプリに戻ります。各接続はあなたのアカウントに属し、課金もそのアカウントに対して行われます。
顧客はネットワーク自身のアプリを引き続き使えますか?
はい。接続はあなたの製品へのAPIアクセスを追加するだけです。アカウントはInstagram、TikTokなどのアプリで引き続き利用でき、WhatsAppの番号はCoexistenceを通じてWhatsApp Businessアプリに残ります。
自社製品内でのeasyCoexistenceの料金はいくらですか?
接続済みアカウント1件につき月額US$ 9からUS$ 0.75で、全体の件数の帯域によって決まります。最初の3日間は無料です。顧客への価格はご自身で設定できます。
続きを読む
最初のチャンネルを 2 分で接続しましょう。
プラットフォームの審査を待つ必要はありません。WhatsApp、Instagram、TikTok などのチャンネルを接続して、AI に投稿、返信、レポートを任せてみてください。
- 3 日間無料
- いつでも解約可能
- 公式 API のみ使用
- 24/7 監視
確認日