任意の自動化ツールからWhatsAppメッセージを送信する

ほとんどの自動化プラットフォームには、HTTPリクエストを送信するアクションがあり、多くの場合 HTTP Request、API request、Outgoing webhook などと呼ばれています。このアクションの送信先をWbiztoolのメッセージ送信エンドポイントに設定すると、ワークフローが実行されるたびに、接続済みの番号からWhatsAppメッセージが送信されます。

このページでは、まず設定方法を説明し、その後Pabbly Connect、Albato、Activepieces、Makeでアクションがどこにあるかを紹介します。

始める前に#

Wbiztoolアカウントから次の3つの値が必要です。

• 設定 → APIキーで確認できる クライアントID と APIキー。
• WhatsApp設定に表示されている、送信元の番号の WhatsAppクライアントID。番号は接続されている必要があります。切断中に送信したメッセージはキューで待機します。

詳しくは認証をご覧ください。

HTTPアクションを設定する#

1. HTTPリクエストのアクションを追加する

   トリガー（新しいフォームの入力、スプレッドシートの新しい行、新規注文など）の後に、お使いのプラットフォームのHTTPリクエストまたはAPIリクエストのアクションを追加します。

2. メソッドとURLを設定する

   メソッドは POST、URLは https://wbiztool.com/api/v1/send_msg/ にします。認証情報はボディに含めるため、認証（authentication）は「なし」のままにします。

3. ボディの形式を選ぶ

   ツールで選択できる場合は JSON を選びます。Form data（フォームフィールド）でも動作するため、ツールで扱いやすいほうを使用してください。追加のヘッダーは必要ありません。

4. ボディのフィールドを追加する

   下の表のフィールドを追加します。認証情報は固定値として入力し、phone と msg はトリガーのデータからマッピングします。

5. ステップをテストする

   テストデータでステップを1回実行します。レスポンスに "status": 1 が含まれていれば、メッセージはキューに追加されています。

ボディのフィールド#

番号ではなくWhatsAppグループに送信するには、phone の代わりに group_name を送信します。グループに送信をご覧ください。その他のすべてのオプションはメッセージ送信に記載されています。

JSONボディの例#

大文字の値を置き換え、プレースホルダーをトリガーのフィールドにマッピングします。トリガーのデータを挿入する具体的な方法はツールによって異なりますが、ほとんどのツールではデータピッカーからフィールドをクリックして挿入できます。

{
  "client_id": 12345,
  "api_key": "YOUR_API_KEY",
  "whatsapp_client": 678,
  "msg_type": 0,
  "country_code": "91",
  "phone": "PHONE_FROM_TRIGGER",
  "msg": "Hi NAME_FROM_TRIGGER, thanks for your order. We will update you here on WhatsApp."
}

グループに送信するには、phone と country_code の代わりに group_name を指定します。

{
  "client_id": 12345,
  "api_key": "YOUR_API_KEY",
  "whatsapp_client": 678,
  "msg_type": 0,
  "group_name": "Sales Team Mumbai",
  "msg": "New lead: NAME_FROM_TRIGGER, PHONE_FROM_TRIGGER"
}

画像を送信するには、msg_type を 1 にして img_url を追加します。msg は画像のキャプションになります。ファイルの場合は、msg_type を 2 にして file_url と file_name を追加します。

{
  "client_id": 12345,
  "api_key": "YOUR_API_KEY",
  "whatsapp_client": 678,
  "msg_type": 2,
  "country_code": "91",
  "phone": "PHONE_FROM_TRIGGER",
  "file_url": "https://example.com/invoices/INV-1042.pdf",
  "file_name": "INV-1042.pdf",
  "msg": "Here is your invoice."
}

レスポンス#

リクエストが成功すると、次の内容が返されます。

{
  "status": 1,
  "message": "Created",
  "msg_id": 9817263
}

"status": 1 は、メッセージがキューに追加されたことを意味し、まだ送信されたわけではありません。問題がある場合、APIはHTTP 400 とともに、"status": 0 と Auth Error: invalid api key や Invalid phone number などの message を返します。ツールによっては 400 レスポンスでワークフローが停止するため、ステップの出力を開いて message を確認してください。すべての一覧はメッセージ送信 → エラーに記載されています。

メッセージが実際に送信されたタイミングを知るには、webhook URL（たとえば同じツール内のWebhookトリガー）を指定します。そのURLには、msg_id と、SENT または FAILED が設定された status を含むフォームエンコードの POST が届きます。Webhookをご覧ください。

Pabbly Connect#

1. APIアクションを追加する

   ワークフローにアクションステップを追加し、アプリ API (Pabbly) とアクションイベント Execute API Request を選びます。

   

2. リクエストを設定する

   Action Event Method を POST、API Endpoint URL を https://wbiztool.com/api/v1/send_msg/、Payload Type を Form Data またはJSON、Authentication を No Auth に設定します。

   

3. パラメーターを設定する

   Set Parameters にチェックを入れ、ボディのフィールドごとに1行ずつ追加します：client_id、api_key、whatsapp_client、phone、country_code、msg、msg_type。phone と msg はトリガーからマッピングします。

   

   テスト用の番号にはすでに国番号が含まれているため、スクリーンショットでは country_code を省略しています。

4. 保存してテストリクエストを送信する

   レスポンスに "status": 1 が含まれていることを確認します。

Albato#

1. HTTPアクションを追加する

   オートメーションにアクションを追加し、HTTP Request/Outgoing webhook を選んでから、その Send request アクションを選びます。たとえば、Google Sheetsの New row created トリガーを使うと、新しい行ごとにメッセージを送信できます。

   

2. コネクションを作成する

   コネクションに「Wbiztool」などの名前を付けます。URLとして https://wbiztool.com/api/v1/send_msg/ を入力し、コンテンツタイプをJSONに設定できます。

3. フィールドをマッピングする

   URL を https://wbiztool.com/api/v1/send_msg/（空欄の場合はコネクションのURLが使用されます）、Request method を POST に設定します。Request parameters に client_id、api_key、whatsapp_client、msg_type、country_code、phone、msg を追加し、phone と msg はトリガーのフィールドから選びます。

   

   

   スクリーンショットでは msg の代わりに message を使っていますが、これでも動作します。テスト用の番号にはすでに国番号が含まれているため、country_code は省略しています。

4. テストして開始する

   テストを実行し、レスポンスに "status": 1 が含まれていることを確認してから、オートメーションを開始します。

   

Activepieces#

1. HTTPピースを追加する

   トリガーの後の + をクリックし、HTTP → Send HTTP request を選びます。

2. リクエストを設定する

   Method を POST、URL を https://wbiztool.com/api/v1/send_msg/ に設定します。Body Type として JSON または Form Data を選びます。

   

3. ボディのフィールドを追加する

   フィールドごとに1つの項目を追加します。Data Selector を使って、トリガーの値を phone と msg に挿入します。phone にすでに国番号が含まれている場合（例：919876543210）は、country_code を省略できます。

4. ステップをテストする

   Test Step をクリックしてレスポンスに "status": 1 が含まれていることを確認し、フローを公開します。

Make#

Makeの HTTP モジュールの Make a request アクションを使用します。メソッドを POST、URLを https://wbiztool.com/api/v1/send_msg/、ボディの形式をJSON（raw、コンテンツタイプ application/json）またはフォームデータに設定し、上記のボディのフィールドを入力します。

トラブルシューティング#