WhatsApp エラー 2593107：同期上限を超えました

ここでいう同期とは何ですか？

Coexistence の番号にある既存の連絡先と会話履歴を API 側へ移行する手順です。これにより、企業が何年も使ってきた番号でも、ソフトウェアが何もない状態から始めずに済みます。

この機能があるのは Coexistence の場合だけです。通常の方法でオンボーディングした番号には、移行すべき過去のアプリ履歴がないため、同期するものがありません。Coexistence の番号には両方があり、Meta は番号の接続時に一度だけ移行できるようにしています。

そのため、Cloud API を長く使ってきた人でも、このエラーにはなじみがない場合があります。これまで使ったことのないオンボーディング方式に属するエラーだからです。

なぜ一度しか実行できないのですか？

これは継続的な機能ではなく、オンボーディングの一部として接続時に行う判断だからです。Meta はこの判断を一度きりのものとして扱います。

Embedded Signup の途中で、企業の担当者は既存のチャット履歴を共有するかどうかを尋ねられます。「はい」と答えると、同期を実行できるようになります。後から再び有効にする設定も、同期を繰り返すエンドポイントもありません。そのため、2 回目の呼び出しでは、解除されるレート制限ではなく、このエラーが返されます。

実際には、その場での選択が見た目以上に重要です。オンボーディングを急いで進め、拒否のほうが安全に感じて履歴を共有しない選択をすると、完全な切断と再接続を行わない限り、その判断をやり直せません。

本当にもう一度必要になった場合はどうなりますか？

番号を切断してから再接続する必要があります。これは設定変更ではなく、実際の操作です。

再接続すると、電話でのコードスキャンを含め、Embedded Signup が最初から実行されます。そのため、履歴を受け入れる新たな機会が得られます。WhatsApp Business アプリはその間も影響を受けないため、企業のデータが失われることはありません。ただし、バックグラウンドで静かに完了する操作ではなく、誰かが電話を操作する必要があります。

計画しておくべき点が 1 つあります。切断すると Webhook の配信先が削除されます。配信先は番号ではなく、アプリのサブスクリプションにある上書き設定として登録されているためです。再接続すると送信と監視は復元されますが、何らかの処理で再登録しない限り、自社サーバーへの配信は戻りません。

よくある間違い

• 同期を再試行すること。これは一度だけの処理なので、再試行しても成功せず、同じエラーが返されます。
• 慎重になるため、オンボーディング中にチャット履歴を拒否すること。その選択をやり直すには、番号を再接続するしかありません。
• Webhook の配信先を復元する計画なしに再接続すること。配信先はアプリと一緒に削除されます。

よくある質問

続きを読む