easyCoexistence
ログイン無料トライアルを開始
Meta Tech Provider

smb_app_state_sync Webhook

smb_app_state_sync は WhatsApp Business アプリ自体の状態を伝えます。主な内容は、Coexistence 番号の接続時に行われる連絡先同期です。会話を伝える history とは別で、Coexistence 番号にのみ存在します。

2

Coexistence 固有の同期フィールドは、このフィールドと history です。

24 hours

オンボーディング後、同期を開始する必要がある期間です。

0

Coexistence なしでオンボーディングした番号に相当するものです。

何を伝えるか

アプリ側の状態です。実際には、企業が電話に登録していた連絡先を指します。

WhatsApp 番号を持つ連絡先はすべてプラットフォームに同期できます。そのため、何年も企業の電話に登録されている顧客を新しい番号として扱わず、ソフトウェアで認識できます。これは会話そのものとは別です。会話は history フィールドに届きます。一方は連絡先一覧、もう一方は会話記録なので、2 つは分かれています。

history と同様に、これは Coexistence にのみ存在します。一度もアプリに登録されていない番号には、同期するアプリ状態がありません。

何を伝えないか

アプリ独自の操作機能です。これらはプラットフォーム側に対応する情報がありません。

  • 端末上に保存され、ソフトウェアから読み取れないラベル
  • クイックリプライ、あいさつメッセージ、不在メッセージ
  • カタログ、注文、ステータス
  • チャネル、音声通話やビデオ通話の履歴

連携において重要な理由

初日から、誰がメッセージを送っているかをシステムが把握できるかどうかを左右するためです。

連絡先同期がなければ、受信メッセージは名前のない電話番号として届き、顧客情報との照合はシステム側の課題になります。同期があれば、企業自身の連絡先一覧を利用でき、照合の大部分が済んだ状態になります。

企業が同期を拒否したり、同期期間を逃したりする可能性があるため、両方のケースを想定しておく価値があります。連絡先が存在すると仮定した連携では、開いた人に大量の番号だけが表示されることになります。

よくある間違い

  • 連絡先が必ず存在すると考えること。企業は同期を拒否したり、同期期間を逃したりできます。
  • このペイロードにラベルやクイックリプライが含まれると考えること。これらは端末に残ります。
  • 連絡先一覧ではなく会話を伝える history と混同すること。
EasyCoexistence で実現する

EasyCoexistence は運用フィールドをサブスクライブし、オンボーディングの手順を記録します。そのため、番号が同期したかどうかをタイムラインで確認できます。

よくある質問

これは history の同期と同じですか？

いいえ。こちらは主に連絡先などのアプリ状態を伝えます。history は会話を伝えます。

複数回実行されますか？

初回同期はオンボーディング時に一度だけ行われます。history と同じ 24 時間の期間内に実行されます。

ラベルは取得できますか？

いいえ。ラベルはアプリの機能で、API 上の相当機能はありません。

通常の Cloud API 番号にも存在しますか？

いいえ。通常の Cloud API 番号には、同期する WhatsApp Business アプリの状態がありません。

続きを読む

The account_update webhook, and every disconnection reasonaccount_update reports connection state changes. The full list of disconnection reasons Meta sends, what each means, and which ones are recoverable.The account_alerts webhookMeta's general alerting channel for a business account. What arrives here, and why it is a prompt to look rather than a state change.Which WhatsApp features stop working after CoexistenceDisappearing messages, view once, live location and broadcast lists are switched off on a connected number. What each one means in practice.WhatsApp error 2593107: synchronization limit exceededError 2593107 means the contact and chat history sync has already run for this number. It can only happen once, and re-onboarding is the only reset.

始める準備はできましたか？

WhatsApp Coexistence の設定は数分で完了し、数か月もかかりません。スマートフォン上のアプリも引き続き使えます。

無料トライアルを始める

確認日

smb_app_state_sync