WhatsAppビジネスコネクタ構成ガイド | サーバーサイドコネクター

API情報

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

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

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

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

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

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

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

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

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

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

続行をクリックしてコネクタアクションを構成します。アクションの名前を入力し、ドロップダウンメニューからアクションタイプを選択します。

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

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

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