Intégration Zapier

L'application WbizTool sur Zapier relie votre numéro WhatsApp aux autres applications que vous utilisez. Lancez un Zap à l'arrivée d'un message WhatsApp, ou envoyez un message WhatsApp lorsqu'un événement se produit dans une autre application.

Avant de commencer#

• Un compte WbizTool avec un numéro WhatsApp connecté dans les paramètres WhatsApp.
• Votre Client ID et votre clé API, disponibles dans Paramètres → Clés API.
• Pour le déclencheur de message entrant : l'option Unibox sur votre forfait. Consultez Prérequis du déclencheur.

Connecter votre compte#

1. Ajoutez WbizTool à un Zap

   Dans Zapier, créez un Zap et recherchez WbizTool comme application de déclenchement ou d'action.

2. Connectez-vous

   Lorsque Zapier vous demande de connecter un compte, saisissez votre Client ID et votre clé API, disponibles dans Paramètres → Clés API.

La clé API détermine l'espace de travail utilisé par Zapier. Si vous appartenez à plusieurs espaces de travail, utilisez une clé créée dans l'espace de travail que vous souhaitez connecter. Si le Client ID ou la clé API est incorrect, Zapier affiche l'erreur lors de la connexion, par exemple Auth Error: invalid api key.

Déclencheur de message WhatsApp entrant#

Ce déclencheur lance votre Zap chaque fois que quelqu'un envoie un message à l'un de vos numéros WhatsApp. Utilisez-le pour ajouter de nouvelles discussions à un CRM, publier des messages dans un canal d'équipe ou consigner les conversations dans un tableur.

1. Choisissez le déclencheur

   Choisissez WbizTool comme application et Incoming WhatsApp Message (message WhatsApp entrant) comme événement déclencheur.

2. Choisissez un numéro WhatsApp

   Sous WhatsApp Number (numéro WhatsApp), choisissez le numéro connecté dont les messages entrants doivent lancer le Zap. La liste affiche les numéros de téléphone connectés dans votre espace de travail.

3. Testez le déclencheur

   Cliquez sur Test trigger (tester le déclencheur). Zapier charge les derniers messages reçus sur ce numéro, pour que vous puissiez associer de vrais champs aux étapes suivantes. Si le numéro n'a encore reçu aucun message, Zapier affiche un message d'exemple à la place.

4. Activez le Zap

   Publiez le Zap. WbizTool se connecte automatiquement à Zapier. Vous n'avez besoin d'ajouter d'URL de webhook nulle part dans WbizTool.

Prérequis du déclencheur#

• Option Unibox. Le déclencheur ajoute votre numéro à la boîte de réception Unibox (comme numéro de boîte). Sans l'option, l'activation du Zap échoue avec Unibox add-on subscription required. Achetez-la dans Facturation et forfaits : 20 $/mois ou 200 $/an par numéro WhatsApp utilisé dans Unibox.
• Un numéro de boîte libre. Si le numéro n'est pas encore dans la boîte de réception, il utilise l'un des numéros de boîte autorisés par votre option. Un numéro déjà dans la boîte de réception n'en utilise pas un autre.
• Rôle Owner ou Éditeur. La clé API doit appartenir à un Owner (Administrateur) ou à un Éditeur de l'espace de travail.
• Un numéro WhatsApp connecté. Le numéro doit rester connecté pour que les nouveaux messages soient détectés.

Fonctionnement du déclencheur avec vos numéros de boîte de réception#

• Seuls les messages entrants lancent le Zap. Les messages envoyés depuis votre numéro ne le font pas.
• Seuls les messages reçus après l'activation du Zap sont transmis. Les messages plus anciens ne sont pas renvoyés.
• Si le numéro est déjà dans la boîte de réception avec votre propre URL de webhook, le webhook de Zapier prend sa place tant que le Zap est activé. Lorsque vous désactivez le Zap, votre URL de webhook, votre secret et vos paramètres d'événements sont rétablis.
• Si vous supprimez un Zap sans l'avoir désactivé, WbizTool cesse de lui envoyer des messages dès que Zapier signale que le Zap n'existe plus.
• Dans Numéros de la boîte, le webhook du numéro affiche un badge Zapier. Si vous cliquez à cet endroit sur Arrêter ou Supprimer pour ce numéro, le Zap reste activé dans Zapier mais ne reçoit plus aucun message, et la page vous avertit d'abord. Pour arrêter le Zap, désactivez-le plutôt dans Zapier. Pour que les messages arrivent de nouveau après la suppression de l'écouteur, désactivez puis réactivez le Zap dans Zapier.

Consultez Webhooks de messages entrants pour comprendre le fonctionnement des numéros de la boîte et des webhooks.

Données du déclencheur#

Chaque exécution du Zap reçoit un message, comme celui-ci :

{
  "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",
    "lid": null,
    "phone_hidden": false,
    "name": "Aman",
    "is_group": false,
    "is_business": false
  },
  "organisation": {
    "id": "5021",
    "name": "Acme Stores"
  }
}

Certains messages contiennent des champs supplémentaires : message.media (nom, type et taille du fichier, et url, un lien de téléchargement valable 7 jours) pour les médias, message.quoted_message_id pour les réponses et group pour les messages de groupe. Pour conserver un fichier, copiez-le dans ces 7 jours (par exemple avec une étape d'envoi vers Google Drive ou Dropbox).

Exemple : enregistrer les messages entrants dans Google Sheets#

1. Déclencheur : WbizTool, Incoming WhatsApp Message.
2. Action : Google Sheets, Create Spreadsheet Row (créer une ligne de feuille de calcul). Associez Contact Phone à une colonne Phone, Contact Name à une colonne Name et Message Content à une colonne Message.

Envoyer des messages WhatsApp depuis un Zap#

Ajoutez WbizTool comme action et choisissez l'un de ces événements d'action :

Dans chaque action, choisissez le numéro d'envoi sous WhatsApp Number. Saisissez le numéro de téléphone du destinataire avec l'indicatif du pays, comme 919876543210, ou indiquez l'indicatif dans le champ facultatif Country Code (indicatif du pays), comme 91. Send WhatsApp Message on Group n'a ni téléphone ni indicatif ; il demande plutôt le Group Name (nom du groupe).

Lorsque WbizTool ne peut pas accepter un message, l'étape échoue et Zapier affiche la raison, par exemple WbizTool: Invalid phone number ou WbizTool: Not enough credits. Une étape réussie signifie que le message a été mis en file d'attente. WbizTool l'envoie ensuite depuis votre numéro connecté.

Vous pouvez aussi appeler directement l'API avec Webhooks by Zapier :

Consultez Envoyer des messages WhatsApp depuis n'importe quel outil d'automatisation pour la signification de chaque champ, et l'API d'envoi de messages pour toutes les options.

Dépannage#