IBM Cloud Docs
WhatsApp との統合

WhatsApp との統合

IBM Cloud

WhatsApp のメッセージングと統合すると、アシスタントは、顧客がいる場所で顧客とメッセージを交換できるようになります。

WhatsApp は高速かつシンプルで安全なメッセージングを無料で提供しており、世界中の電話で使用可能であるため、多くの顧客が利用しています。 WhatsApp は、電話用インターネット接続してメッセージを送信するので、顧客は SMS 料金を回避できます。

この統合では、Twilio をプロバイダーとして使用して、アシスタントと WhatsApp の間に接続を作成します。

開始前に

Whatsapp をアシスタントと統合するには、Twilio と少なくとも開発者の役割にアクセスできる必要があります。 詳しくは、 Twilio の役割の違いを参照してください。

  1. Twilio Web サイトにアクセスします。

  2. アカウントを作成します。

  3. **「開発」タブで「電話番号」**をクリックします。

  4. 説明に従って電話番号を取得します。

    Twilio の電話番号を取得すると、音声、SMS、MMS が自動的にサポートされます。 新しい電話番号がアクティブな番号として表示されます。 複数の電話番号をプロビジョニングしてから、それらの番号の許可を並行して取得するプロセスを踏むことを検討してください。 番号が前に別の事業で使用されていた場合は (例えば、過去に使用されていた番号を Twilio から割り当てられた場合など)、WhatsApp はその番号を拒否します。

後でもう一度参照できるように、この Twilio の Web ページを Web ブラウザー・タブで開いたままにしておきます。

WhatsApp で Twilio 番号を有効にする許可を WhatsApp に要求

WhatsAppは、同社のネットワーク上で顧客とやりとりを希望するすべての企業を審査する厳格なプロセスを設けています。 WhatsApp, (旧Facebook)は、Metaが所有するサービスであり、Metaのビジネスディレクトリにビジネス情報を登録する必要があります。

  1. 登録するには、 Meta Business Toolsページにアクセスし 、「新しいアカウントを作成」 をクリックします。 指示に従ってアカウントを作成します。

  2. Meta Business Manager IDを取得してください。 設定で、 ビジネス情報のタブをクリックします。 ページの上部にビジネスマネージャーIDが表示されています。

  3. WhatsAppのウェブページを使用して、Twilioの番号WhatsAppで有効にしてください。これは、2025年1月1日時点で、Metaが公式にサポートしている唯一の方法であり、お客様の WhatsApp への移行をサポートします。 詳細については、 WhatsApp 技術プロバイダープログラムの概要 をご覧ください。

    以下の値を指定するためのヒント。

    • Twilio アカウント SID (Twilio Account SID): Twilio サイトでホーム・アイコンをクリックしてプロジェクト・ダッシュボードに移動し、SID を見つけます。

    • メタビジネスマネージャーID: 前のステップで作成したアカウントのIDを追加します。

    • 顧客向けセルフサービスによるオンボーディングを提供していますか?: 番号を選択してください。 Tech Provider Programを採用することで、お客様の顧客は、Metaの WhatsApp 製品を使用して WhatsAppにサインアップできるようになります。

  4. **「送信」**をクリックします。

WhatsAppに提出物の評価と承認のための時間を与えてください。 リクエストが承認されるまで最大 7 日間かかることがあります。

統合のセットアップ

統合をセットアップするには、次の手順を実行します。

  1. **「統合」**ページに移動します。それには、左側のメニューにある統合アイコン (統合アイコン) をクリックします。

  2. **「追加」*「WhatsApp with Twilio」*タイルでクリックします。

  3. 「確認」 をクリックします。

  4. Twilio サイトで左上のメニューにあるアカウント名をクリックして、アカウント・ダッシュボードに移動します。

    以下の値をコピーして一時的に保管し、次のステップで WhatsApp with Twilio 統合セットアップ・ページに貼り付けることができるようにします。

    • Account SID (アカウント SID)
    • Auth token (認証トークン)
  5. WhatsApp with Twilio 統合セットアップ・ページに戻ります。 **「次へ」**をクリックして、WhatsApp with Twilio 統合セットアップのステップ 1 に進みます。

  6. アカウント SID 情報を入力します。 **「次へ」**をクリックして、WhatsApp with Twilio 統合セットアップのステップ 2 に進みます。

  7. 認証トークン情報を入力します。 **「次へ」**をクリックして、WhatsApp with Twilio 統合セットアップのステップ 3 に進みます。

  8. **「Webhook URI」**フィールドから値をコピーします。

    この Webhook URI を使用すれば、以下のセクションで統合をテストできます。

  9. 「完了 (Finish)」 をクリックします。

認証に必要なフィールドが変更された場合は、関連フィールドのすべての項目に入力し、再度検証する必要があります。

統合のテスト

WhatsApp による申請の承認を待っている間、Twilioのサンドボックスを使用して統合をテストすることができます。 サンドボックスを使用すると、共有の事前準備されたTwilioテスト番号を使用して、サンドボックスに参加している番号に事前承認済みのテンプレートメッセージを送信および受信することができます。

実稼働環境では、Twilio サンドボックスを使用しないでください。 サンドボックスのセッションの有効期間は 3 日間です。

  1. サンドボックスを作成するには、 Twilioコンソールウェブページに移動し、Twilioの認証情報でログインします。 「Activate Your Sandbox (サンドボックスをアクティブ化)」 プロンプトが表示されます。 サンドボックスを作成することに同意し、選択内容を確認します。

  2. 説明に従ってサンドボックスを作成します。

  3. デバイスからサンドボックス電話番号に WhatsApp メッセージを送信してサンドボックスに接続します。

  4. **「開発」タブで「メッセージング」>「設定」>「WhatsApp サンドボックス設定 (WhatsApp sandbox settings)」**をクリックします。

  5. 「サンドボックス構成 (Sandbox Configuration)」 セクションで、既にコピーしてある Webhook URI を*「メッセージが着信したとき (When a message comes in)」*フィールドに貼り付けます。 「保存」 をクリックします。

  6. Twilio のサンドボックスに割り当てられている共有の電話番号に、WhatsApp からメッセージを送信して、統合をテストできます。

完全かつ詳細な情報については WhatsAppの Twilioサンドボックスの使い方」 をご覧ください。

製品統合の完了

WhatsApp WhatsAppへのアクセスを許可した後、サンドボックス番号の代わりに専用のTwilio電話番号を使用するように統合を更新します。

  1. Twilio での WhatsApp 統合セットアップ・ページで**「Webhook」**セクション (基本セットアップタブ) までスクロールします。 **「WhatsApp Web フック (WhatsApp Webhook)」**フィールドの値をコピーします。

  2. Twilio アカウント Web ページに移動し、コピーした Webhook を Twilio 構成に追加して、Twilio で WhatsApp 統合への接続を完了します。

顧客にアシスタントへの迅速なアクセスを提供

Web ページに、顧客がクリックしたらアシスタントと WhatsApp で会話することができるアイコンを追加できます。

Web ページにアイコンを追加するには、次の手順を実行します。

  1. WhatsApp with Twilio 統合のセットアップ・ページで、**「Click to chat (クリックしてチャットする)」**タブをクリックします。

  2. **「事前入力メッセージ (Pre-filled message)」**フィールドに、会話を開始するために WhatsApp が顧客の代わりにアシスタントに送信するテキストを追加します。

    アシスタントが回答できることがわかっているメッセージを、役に立つような方法で指定してください。

  3. 組み込みリンクをコピーして Web ページに追加します。 アイコンの機能について説明するテキストをアイコンの前に追加することを検討してください。 例えば、Have a question? Ask watsonx Assistant for helpというアイコンの <span> エレメントの前に <span> HTML タグを追加することができます。

    ユーザーが Web ページでこのアイコンをクリックすると、アシスタントに接続されている WhatsApp メッセージング・セッションが開き、指定したテキストがユーザーのテキスト・フィールドに追加され、すぐに送信できる状態になります。

アクションに関する考慮事項

最良の顧客エクスペリエンスを提供するために、WhatsApp 統合の機能を念頭においてアクションを設計してください。

  • 1,600 文字を超えるテキスト応答は、複数の応答に分割されます。
  • テキスト応答に HTML 要素を含めないでください。
  • Twilio 統合機能付きの WhatsApp は、 エージェントに接続 応答タイプで開始されるチャット転送には対応していません。
  • マークダウン構文を使用する場合は、「サポートされるマークダウン構文」 の表を参照してください。
  • テキスト応答にハイパーテキスト・リンクを含める場合は、URL を直接指定してください。 リンクのマークダウン構文は使用しません。 例えば、Contact us at https://www.ibm.com.のように指定します。
サポートされるマークダウン構文
フォーマット 構文
イタリック We're talking about _practice_. 私たちは練習 について話し合っています。
太字 There's *no* crying in baseball. 野球で泣くことはしません