Coexistence で Typebot のフローを WhatsApp 上で動かす

接続した番号の値を入れる Typebot の項目はどれですか？

Typebot の WhatsApp ウィザードは、ボットの「Share」タブにあり、app secret、System User Token、WABA ID、電話番号 ID の 4 つを求めます。

このうち 3 つは、接続の画面でそのまま確認できます。ダッシュボードには、番号ごとの WABA ID、電話番号 ID、アクセストークンが表示されます。アシスタントに取得を任せる場合は、get_api_credentials ツールが同じ値を返します。それぞれ対応する項目に貼り付けてください。

app secret だけは空欄にします。Typebot が受信データに対して app secret を使うのは、Meta が配信ごとに付ける X-Hub-Signature-256 ヘッダーの検証だけです。Tech Provider 経由で接続した番号では、Meta は提供元の app secret で署名します。この値は共有されないため、ここに何かを入力すると、Typebot は正規のメッセージをすべて拒否してしまいます。空欄にしておけば、Typebot はこの検証を行わず、配信を受け付けます。

Typebot のコールバック URL と Verify Token はどこに設定しますか？

設定先は、Meta アプリのダッシュボードではなく、番号の Webhook の送信先です。

Typebot のウィザードは、Callback URL と Verify Token をご自身の Meta アプリの WhatsApp 設定に貼り付けるよう案内します。しかし EasyCoexistence を通じた Coexistence では、ご自身のアプリは関与しません。Meta は番号のイベントを、その接続に設定された送信先へ届けます。そのため、Typebot の最後のステップで 2 つの値をコピーし、ダッシュボードまたは set_webhook_destination で送信先として設定してください。

その後、Meta が確認用の GET リクエストを Typebot に送り、Typebot が challenge を返します。以降、番号宛てのメッセージはすべてボットに届きます。Typebot の Verify Token は一度しか使えません。確認が成功した時点で、Typebot のデータベースから削除されます。後で送信先を設定し直す場合は、先にウィザードをやり直して新しいトークンを発行してください。

24 時間ウィンドウに対して、ボットはどう動きますか？

Typebot は、先に連絡してきた相手に返信します。そのため、ほとんどのメッセージはカスタマーサービスウィンドウの内側に収まります。Meta はお客様が書き込むたびに 24 時間のウィンドウを開き、その間はテンプレートなしで、あらゆるサービスメッセージを送信できます。返信しかしないボットは、最も扱いやすいケースです。

注意が必要なのは、待機を含むフローです。Wait ブロックや、お客様が 1 日以上応答しなかった後に再開するセッションでは、ウィンドウ外でフリーテキストを送ろうとします。Meta はこれをエラー 131047 で拒否します。Typebot のセッション有効期限のタイムアウトは、初期値が 4 時間で、最大 48 時間まで変更できます。この設定は、戻ってきたお客様の会話を新しいチャットとして始める時点を決めるもので、Meta がメッセージを受け付けるかどうかとは関係ありません。

Coexistence なので、チームは WhatsApp Business アプリですべての会話を確認でき、ボットに任せたくない場面では携帯電話からいつでも対応を引き継げます。

よくある間違い

• Meta アプリの app secret を Typebot に貼り付けること。配信は Tech Provider の secret で署名されているため、Typebot は署名が無効だとして、すべてのメッセージを拒否します。
• 古い Typebot の Verify Token を再利用すること。確認に成功すると削除されるため、送信先を設定し直すときはウィザードで新しいトークンが必要です。
• コールバック URL を共有すること。署名の検証をしない構成では、URL を知っていればリクエストを送れてしまいます。パスワードと同じように扱ってください。

よくある質問

続きを読む