WhatsAppビジネスコネクタ構成ガイド
この記事では、WhatsAppビジネスコネクタの構成方法について説明します。
API情報
このコネクタは以下のベンダーAPIを使用します:
- API名:Facebook Graph API - WhatsApp Business API
- APIバージョン:v13.0
- APIエンドポイント:
https://graph.facebook.com
- ドキュメント:WhatsApp Business Platform Cloud 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 )でネストされたテンプレート変数を名前付けします。ネストされたテンプレート変数は通常、データレイヤーリスト属性から構築されます。 |
最終更新日 :: 2025年July月2日