コンパニオン経由のWhatsAppキャプチャ

あなた自身でホストするコンパニオンブリッジを使って、担当者のWhatsApp Businessのすべての会話をそのままConversationsのタイムラインに取り込みます。任意機能で、デフォルトは無効、利用規約の同意が必要です。

このコネクタは、あなたの組織がホストするコンパニオンブリッジによってキャプチャされた担当者のWhatsApp Businessのメッセージを、Conversationsのタイムラインに取り込みます。メッセージは他の会話と同じ場所に届くため、AIによる要約、インサイト、フォローアップの監視は既にその上で機能します。

始める前に:利用規約に関する注意

仕組み

• あなたの環境でコンパニオンブリッジ(オープンソースのWhatsApp Webサービス)を実行します。
• コンパニオンはQRコードでWhatsApp Businessとペアリングし、送受信メッセージをリッスンします。
• メッセージごとに、コンパニオンはあなたの組織の取り込みURLに署名付きPOSTを送信します。
• メッセージは保存され、電話番号によって連絡先またはリードに紐づけられます(番号が不明な場合は新しいリードを作成)。その後、Conversationsのタイムラインに表示されます。

接続方法

1. 設定、連携に進み、「WhatsApp:コンパニオン経由でキャプチャ」カードを開きます。
2. 強力なペアリング用シークレットを設定し、同意チェックボックス(利用規約のリスクを理解しました)にチェックを入れます。「保存」をクリックします。
3. 表示された取り込みURLをコピーし、同じペアリング用シークレットと共にコンパニオンに設定します。
4. カードに戻り、「有効化」をクリックします。同意にチェックが入り保存されていないと、キャプチャは受け付けられません。

コネクタが無効な間、または同意が保存されていない間は、取り込みURLはすべてのPOSTを拒否します。これにより、注意事項に同意しないまま何かをキャプチャしてしまうことはありません。

POST形式(コンパニオンの契約仕様)

コンパニオンは1件またはバッチのメッセージを送信し、ペアリング用シークレット(HMAC-SHA256)でボディに署名して、X-Sellio-Signatureヘッダーに sha256=<hex> の形式で付与します。

POST /api/inbound/whatsapp-capture/YOUR_TOKEN
X-Sellio-Signature: sha256=<hmac-sha256 of the body with the secret>
Content-Type: application/json

{
  "messages": [
    {
      "messageId": "unique-message-id",
      "from": "15551230000",
      "to": "15559990000",
      "direction": "in",
      "body": "message text",
      "timestamp": 1700000000,
      "name": "Contact name"
    }
  ]
}

messageIdにより、同じメッセージが再送されても重複になりません。directionは「in」(受信)または「out」(担当者による送信)です。timestampは秒またはミリ秒を受け付け、タイムラインの並び順に使用されます。

この記事をシステム内で開く →