Zapier連携

ZapierのWbiztoolアプリを使うと、WhatsApp番号を普段お使いの他のアプリと接続できます。WhatsAppメッセージが届いたときにZapを開始したり、他のアプリで何かが起きたときにWhatsAppメッセージを送信したりできます。

始める前に#

• WhatsApp設定でWhatsApp番号を接続済みのWbiztoolアカウント。
• 設定 → APIキーで確認できる クライアントID と APIキー。
• 新着メッセージトリガーを使う場合：プランに Uniboxアドオン が必要です。トリガーの要件をご覧ください。

アカウントを接続する#

1. ZapにWbiztoolを追加する

   ZapierでZapを作成し、トリガーまたはアクションのアプリとして Wbiztool を検索します。

2. サインインする

   Zapierからアカウントの接続を求められたら、求められた認証情報（設定 → APIキーで確認できるAPIキーとクライアントID）を入力します。

Zapierが使用するワークスペースは、APIキーによって決まります。複数のワークスペースに参加している場合は、接続したいワークスペースで作成したキーを使用してください。

新着WhatsAppメッセージトリガー#

このトリガーは、WhatsApp番号でメッセージを受信するたびにZapを開始します。新しいチャットをCRMに追加する、メッセージをチームのチャンネルに投稿する、会話をスプレッドシートに記録する、といった用途に使用できます。

トリガーの要件#

• Uniboxアドオン。 アドオンがないと、Zapをオンにしたときに Unibox add-on subscription required で失敗します。請求・プランで購入してください（Uniboxで使うWhatsApp番号1つあたり月額$20または年額$200）。
• 接続済みのWhatsApp番号。 トリガーは、接続済みの番号の1つに紐づけられます。

トリガーのデータ#

実際のメッセージは次のようになります。

{
  "event": "message_received",
  "timestamp": "2026-09-16T10:31:12.482913+00:00",
  "webhook_id": 42,
  "whatsapp_client_id": "678",
  "whatsapp_phone": "919812345678",
  "message": {
    "id": "[email protected]_3EB0C1A2B3D4E5F60718",
    "type": "chat",
    "content": "Hi, is my order #4821 out for delivery?",
    "from": "919876543210",
    "from_name": "Aman",
    "to": "919812345678",
    "timestamp": "2026-09-16T10:29:58+00:00",
    "whatsapp_timestamp": 1789554598,
    "direction": "incoming",
    "status": "pending",
    "is_forwarded": false,
    "forwarding_score": 0
  },
  "contact": {
    "whatsapp_id": "[email protected]",
    "phone": "919876543210",
    "name": "Aman",
    "is_group": false,
    "is_business": false
  },
  "organisation": {
    "id": "5021",
    "name": "Acme Stores"
  }
}

トリガーの設定中にZapierが読み込むサンプルには、同じ message と contact のフィールドがあります（message.forwarding_score を除く）が、webhook_id、whatsapp_client_id、whatsapp_phone、organisation は含まれません。これらのフィールドは、実際のメッセージが届いた後でマッピングに表示されます。また、サンプルではプレースホルダーの値が使われており、電話番号には + が付き、whatsapp_timestamp はミリ秒単位、status は delivered になっています。

実際のメッセージでは、電話番号に + は付かず、message.whatsapp_timestamp は秒単位で、message.status は通常 pending です。一部のメッセージには追加のフィールドが含まれます。メディアの場合は message.media（ファイル名、種類、サイズ）、返信の場合は message.quoted_message_id、グループメッセージの場合は group です。その他の例についてはWebhookリスナーをご覧ください。

例：受信メッセージをGoogle Sheetsに記録する#

1. トリガー： Wbiztoolの New WhatsApp Message（新しいWhatsAppメッセージ）。
2. Filter by Zapier： message.direction が incoming と完全に一致する場合にのみ続行します。
3. アクション： Google Sheetsの Create Spreadsheet Row（スプレッドシートの行を作成）。contact.phone をPhone列に、contact.name をName列に、message.content をMessage列にマッピングします。

ZapからWhatsAppメッセージを送信する#

メッセージを送信するには、Wbiztoolをアクションとして追加し、ZapierのWbiztoolページに記載されているアクションのいずれかを選びます。受信者の電話番号とメッセージのテキストを、前のステップからマッピングします。

Webhooks by Zapier を使ってAPIを直接呼び出すこともできます。

各フィールドの意味は任意の自動化ツールからWhatsAppメッセージを送信するを、すべてのオプションはメッセージ送信をご覧ください。

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