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

マルチテナント対応のソーシャルメディア API:1 つの API キーで多数の顧客アカウント

easyCoexistence の Partner API は、設計段階からマルチテナントに対応しています。お使いのアカウントに発行された ec_live_ キー 1 つで、多数の顧客の WhatsApp 番号とソーシャルアカウントを接続・管理できます。各接続には顧客の ID が external_ref として付き、その顧客専用のトークンを保持し、独自の Webhook 送信先を持ち、署名付きのステータスイベントにも含まれます。そのため GET /channels?external_ref= で、1 人の顧客のアカウントだけを一覧表示できます。

200 characters

接続セッションが受け取る external_ref の最大長:顧客に付けた、お使い独自の ID で、作成される接続に保存されます。

1 key

easyCoexistence アカウントが同時に保持する API キーの数。キーを分けると、アカウントと請求も分かれます。

50 open

1 つのアカウントが同時に開ける接続セッションの数。あわせて、新規セッションは 1 時間あたり 100 件までです。

5 minutes

署名付きイベントのタイムスタンプを拒否すべき経過時間。HMAC は定数時間で比較します。

1 つのアカウントで、多数の顧客をどのように扱いますか?

お使いの easyCoexistence アカウントはお使いのプロダクトを表し、各顧客は持ち込む接続に付けるタグとして扱われます。顧客は独自のアカウントを作らず、お使いのキーを目にすることもありません。課金もお使いの側で行います。

Your accountOne ec_live_ key, one bill, one status events URL
Your customerYour own id, sent as external_ref
NumberA WhatsApp number at /connections
ChannelA social account at /channels
DestinationA webhook per number or channel

顧客ごとに接続へどのようにタグを付けますか?

接続セッションに external_ref を送信します。この値は、セッションが作成する番号やチャネルに保存され、リダイレクト先 URL に付加され、そのステータスイベントにも含まれます。Facebook や LinkedIn のサインインで複数の Facebook ページが接続される場合は、それぞれにタグが付きます。1 人の顧客のアカウントを確認するには、いずれかの一覧を絞り込んでください:

One customer's social accounts and numbers
curl "https://easycoexistence.com/api/v1/channels?external_ref=customer_4821" \
  -H "Authorization: Bearer $EC_API_KEY"

curl "https://easycoexistence.com/api/v1/connections?external_ref=customer_4821" \
  -H "Authorization: Bearer $EC_API_KEY"

顧客のトークンはどのように分離されますか?

各接続は、その顧客自身のトークンを保持します。WhatsApp 番号のトークンは、Embedded Signup で Meta が発行する、その顧客のアセットに限定されたビジネストークンです。ソーシャルアカウントのトークンは、そのオーナーが付与したものです。認証情報はお使いのキーを通してのみ取得でき、お使いのバックエンドから呼び出します。お使いのアカウントに存在しない ID には 404 not_found を返します。ジョブが属する顧客の接続を先に検索してからトークンを取得してください。そうすることで、あるテナントの処理が別のテナントのアカウントで実行されることはありません。

顧客ごとに Webhook はどのように動作しますか?

アカウントごとに送信先は 1 つで、お使いが選びます。チャネルすべてを 1 つの URL に向け、本文の account_id で振り分けるか、顧客ごとに個別の URL を設定できます。各チャネルは PUT /channels/{id}/webhook で設定した独自のシークレットで署名するため、account_id からどのシークレットで検証すればよいかが分かります。番号宛てのメッセージは、WhatsApp Business Account に設定された webhook_url へ Meta から届くため、phone_number_id で振り分けてください。

ステータスイベントでは、どの顧客に関するものかをどのように示しますか?

お使いの external_ref を含めることで示します。アカウントごとに 1 つのイベント URL で、connection.* と channel.* のイベントを受け取ります。各イベントには接続またはチャネルのビューが含まれ、external_ref も含まれます。post.published と post.failed は、投稿とそのチャネルを伝えます。イベントには、アカウント独自のシークレットによる署名が X-EC-Signature ヘッダーで付き、エンドポイントが失敗すると再送されます。そのため、配信 ID ごとに一度だけ処理してください。

何人の顧客を、どれだけ速く登録できますか?

アカウントごとに、同時に開ける接続セッションは 50 件、新規セッションは 1 時間あたり 100 件です。Meta は初回の WhatsApp オンボーディングをすべて、すべての easyCoexistence アカウントで共有されるアプリ全体の上限に数えます。上限があるため、ある 1 つのプラットフォームの一括インポートがその枠を使い切ることはありません。顧客が接続しようとするタイミングでセッションを作成してください。上限に達すると 429 cap_reached または rate_limited が返されます。

顧客のアカウントが別の場所ですでに接続されている場合はどうなりますか?

そのサインインは拒否されます。ソーシャルアカウントは、一度に 1 つの easyCoexistence アカウントにしか接続できません。そのため、easyCoexistence を利用する別のサービスがそのアカウントを保持している場合、セッションの last_error にその旨が表示されます。顧客はそのサービス側で削除するか、別のアカウントでサインインします。お使いのアカウント内であれば、顧客は必要な数だけアカウントを接続でき、それぞれに同じ external_ref のタグが付きます。

顧客 1 人の利用を終了するにはどうしますか?

external_ref で顧客の接続とチャネルを一覧し、それぞれに DELETE を送信します。番号を削除すると、Meta における easyCoexistence のアクセス権が取り消され、監視も停止します。チャネルを削除すると、ネットワーク側でアクセス権が取り消され、キューに残っている投稿もキャンセルされます。各接続の課金は、その請求サイクルの終了時に止まります。その顧客の他の接続は、他のテナントの接続と同様に影響を受けません。

よくある間違い

  • external_ref にメールアドレスを使うこと。メールアドレスは変わることがあり、この値は各接続に保存されるため、お使いのデータベースで安定した ID を使ってください。
  • 転送されたイベントを、誤ったテナントのシークレットで検証すること。本文の account_id でシークレットを検索してください。各チャネルは独自のシークレットで署名するためです。
  • 顧客全員に一度に接続リンクを送ること。アカウントごとに開ける接続セッションは 50 件だけなので、顧客は数回に分けて招待してください。
  • 顧客を自社データベースからだけ削除すること。その顧客の接続は、API で 1 件ずつ削除されるまで、アカウントと請求に残ります。
EasyCoexistence で実現する

easyCoexistence なら、1 つの API キーで顧客ベース全体を扱えます。顧客の WhatsApp 番号、Instagram、Facebook、TikTok、YouTube、LinkedIn のアカウント、そのほかのチャネルを、顧客 ID のタグ付きで管理できます。各接続には独自のトークン、Webhook、署名付きイベントがあり、すべての接続は 24 時間 365 日監視されます。接続ごとに月額 US$ 9 から、接続を増やすほど下がり US$ 0.75 まで。最初の 3 日間は無料です。

よくある質問

顧客ごとに easyCoexistence アカウントが 1 つずつ必要ですか?

いいえ。1 つのアカウントとそのキーで、多数の顧客の接続を保持でき、external_ref で区別します。アカウントを分けるのは、請求を分けたいときだけです。

顧客同士で、お互いのアカウントを見られますか?

easyCoexistence を通じては見られません。顧客はお使いのキーを持たず、自分専用の接続リンクだけを開きます。各顧客がお使いのプロダクト内で何を見るかは、お使いのコードで決まります。

顧客ごとに別の Webhook URL を設定できますか?

はい。番号とチャネルはそれぞれ独自の送信先を持てるため、顧客専用の URL も、account_id で振り分ける共通の URL も使えます。

マルチテナントのアカウントは、どのように課金されますか?

全顧客の接続をまとめて、接続ごとに課金されます。接続ごとに月額 US$ 9 から US$ 0.75 までで、接続の合計数が属する区分によって決まります。最初の 3 日間は無料です。

続きを読む

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

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

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

確認日