WhatsAppビジネスコネクタ構成ガイド

API情報

このコネクタは以下のベンダーAPIを使用します：

コネクタマーケットプレイスにアクセスして新しいコネクタを追加します。コネクタを追加する一般的な手順については、コネクタについてを参照してください。

コネクタを追加した後、以下の構成を構成します：

アクセストークン：（必須）Facebookシステムユーザーのアクセストークン。
コネクタをアクセストークンを使用して認証する場合、ビジネスシステムユーザーのアクセストークンを使用することをお勧めします。ユーザーアクセストークンとは異なり、頻繁に期限切れになり、数時間ごとに再生成が必要なのに対し、ビジネスシステムユーザートークンは有効期限が長く（通常は最大60日）、より安定した信頼性の高い認証方法を提供します。ビジネスシステムユーザーアクセストークンを取得するには、Facebookビジネスマネージャーでシステムユーザーを作成し、必要なアセットと権限を割り当て、その後Facebookアプリダッシュボードでトークンを生成する必要があります。詳細な手順については、WhatsApp: WhatsApp Business Platform用システムユーザーアクセストークンの取得を参照してください。

コネクタの構成が完了したら、完了をクリックします。

WhatsApp Business APIでは、主に以下の2種類のメッセージタイプがあります：

テンプレートメッセージはWhatsAppによって事前に承認されており、アラート、更新情報、再エンゲージメントメッセージなど、ビジネスからの会話を開始するために設計されています。これらのメッセージには変数を含めることができ、ビジネスから24時間以内に連絡がなかったユーザーにメッセージを送る場合に必要です。
テキストベースのメッセージはセッションベースであり、24時間のウィンドウ内でユーザーからのメッセージに応答するためにのみ使用できます。これらはダイナミックな会話コンテンツに対してより大きな柔軟性を提供しますが、勧誘のためには使用できません。

24時間のウィンドウ外で会話を開始する場合や通知を送信する場合はテンプレートメッセージを使用し、ユーザーとのアクティブなセッション中にリアルタイムのやり取りを維持するためにテキストベースのメッセージを使用します。

テンプレートメッセージを送信する前に、テンプレートを作成する必要があります。詳細については、WhatsApp: WhatsApp Businessアカウント用メッセージテンプレートの作成を参照してください。

アクション名	AudienceStream	EventStream
テキストメッセージを送信	✓	✓
メッセージテンプレートを送信	✓	✓

コネクタアクションの構成を続けるには、続行をクリックします。アクションの名前を入力し、アクションタイプを選択します。

次のセクションでは、各アクションのパラメータとオプションの構成方法について説明します。

パラメータ	説明
送信元	メッセージを送信する電話番号ID。
送信先	メッセージを送信するWhatsApp IDまたは電話番号。詳細については、WhatsApp: 電話番号、フォーマットを参照してください。
メッセージ	メッセージのテキストで、URLやフォーマットを含むことができます。使用例については、WhatsApp: テキストメッセージの送信を参照してください。
プレビューURL	テキストメッセージ内のURLプレビューを許可または無効にするブール値（`true`または`false`）。詳細については、WhatsApp: テキストメッセージでのURLの送信を参照してください。

パラメータ	説明
送信元	メッセージを送信する電話番号ID。
送信先	メッセージを送信するWhatsApp IDまたは電話番号。詳細については、WhatsApp: 電話番号、フォーマットを参照してください。
メッセージテンプレート	メッセージテンプレートを提供します。使用例については、WhatsApp: メッセージテンプレートの送信を参照してください。テンプレートは有効なJSONオブジェクト形式を期待します。メッセージテンプレート変数セクションで指定されたテンプレート変数を使用することができます。詳細については、コネクタテンプレートについてを参照してください。
メッセージテンプレート変数	メッセージテンプレートのデータ入力としてテンプレート変数を提供します。詳細については、コネクターテンプレート変数を参照してください。ドット表記（例：`items.name`）でネストされたテンプレート変数を名前付けします。ネストされたテンプレート変数は通常、データレイヤーリスト属性から構築されます。