history Webhook

何が届くか

WhatsApp Business アプリでその番号がすでに受信していた 1 対 1 のメッセージ履歴が転送されます。何年も使ってきた番号でも、ソフトウェアが何もない状態から始めずに済みます。

グループ会話は含まれません。Coexistence 番号ではグループ会話は API から完全に除外されます。また、アプリ独自の機能であるラベル、クイック返信、挨拶メッセージ、不在メッセージにも API 相当の機能はなく、デバイス上に残ります。

このフィールドは Coexistence 番号にだけ存在します。通常の方法でオンボーディングした番号には移行すべきアプリの履歴がないため、届くものもありません。

なぜ 1 回だけ発生するか

この転送は継続的な機能ではなく、オンボーディングの一部だからです。

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

期限もあります。同期はオンボーディング後 24 時間以内に開始する必要があり、それ以降に試行すると 2593108 が返されます。どちらかを逃した場合は、番号を切断して最初からフローをやり直す必要があります。

ハンドラーでの処理方法

一度だけ届き、大量になる可能性があるバッチとして扱い、メッセージ経路に追加される通常のトラフィックとは分けて処理してください。

• すぐに受け付けて非同期で処理します。他の配信と同じ方法です。
• メッセージ ID で重複排除します。オンボーディングの前後では、history と通常のメッセージが重なる可能性があります。
• 届かない場合も想定します。担当者が履歴を拒否した番号では何も届かないため、連携はどちらの場合でも動作する必要があります。
• オンボーディングをこれに依存させません。転送が完了する前でも接続は利用できます。

よくある間違い

• 履歴が存在することを前提に連携を構築すること。履歴なしで接続される番号は多数あります。
• 2593107 の後に同期を再試行すること。1 回限りのイベントなので、再試行しても同じエラーが返されます。
• 連携作業の開始まで履歴の選択を保留すること。通常、その時点では 24 時間の期限が過ぎています。

よくある質問

続きを読む