Intégrations
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 nouveau message : l'option Unibox sur votre forfait. Consultez Prérequis du déclencheur.
Connecter votre compte#
Ajoutez Wbiztool à un Zap
Dans Zapier, créez un Zap et recherchez Wbiztool comme application de déclenchement ou d'action.
Connectez-vous
Lorsque Zapier vous demande de connecter un compte, saisissez les identifiants demandés, à savoir votre clé API et votre Client ID, 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.
Déclencheur de nouveau message WhatsApp#
Ce déclencheur lance votre Zap chaque fois qu'un message est reçu sur votre numéro 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.
Prérequis du déclencheur#
- Option Unibox. Sans elle, 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 WhatsApp connecté. Le déclencheur est rattaché à l'un de vos numéros connectés.
Données du déclencheur#
Les messages réels ressemblent à ceci :
{
"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"
}
}
L'exemple que Zapier charge pendant la configuration du déclencheur contient les mêmes champs message et contact (sauf message.forwarding_score), mais pas webhook_id, whatsapp_client_id, whatsapp_phone ni organisation. Ces champs n'apparaissent pour l'association qu'après l'arrivée d'un vrai message. L'exemple utilise aussi des valeurs fictives : numéros de téléphone avec +, whatsapp_timestamp en millisecondes et status à delivered.
| Champ | Description |
|---|---|
event | message_received pour les messages entrants, message_sent pour les messages envoyés depuis votre numéro. |
message.type | chat pour le texte. Les messages médias utilisent des types comme image, video, audio, ptt (message vocal), document et sticker. |
message.content | Le texte. Pour les médias, un court libellé comme « 📸 Image ». |
message.direction | incoming ou outgoing. |
message.from / message.to | from est toujours le contact et to votre numéro, même pour les messages sortants. Utilisez message.direction pour les distinguer. |
contact.is_group | true lorsque le message provient d'un groupe. Les messages de groupe incluent aussi group.name. |
Dans les messages réels, les numéros de téléphone n'ont pas de +, message.whatsapp_timestamp est exprimé en secondes et message.status vaut généralement pending. Certains messages contiennent des champs supplémentaires : message.media (nom, type et taille du fichier) pour les médias, message.quoted_message_id pour les réponses et group pour les messages de groupe. Consultez Écouteurs webhook pour d'autres exemples.
Exemple : enregistrer les messages entrants dans Google Sheets#
- Déclencheur : Wbiztool, New WhatsApp Message.
- Filter by Zapier : continuer uniquement si
message.directioncorrespond exactement àincoming. - Action : Google Sheets, Create Spreadsheet Row. Associez
contact.phoneà une colonne Phone,contact.nameà une colonne Name etmessage.contentà une colonne Message.
Envoyer des messages WhatsApp depuis un Zap#
Pour envoyer un message, ajoutez Wbiztool comme action et choisissez l'une des actions listées sur la page Wbiztool de Zapier. Associez le numéro de téléphone du destinataire et le texte du message à des données des étapes précédentes.
Vous pouvez aussi appeler directement l'API avec Webhooks by Zapier :
| Paramètre | Valeur |
|---|---|
| Action event (événement d'action) | POST |
| URL | https://wbiztool.com/api/v1/send_msg/ |
| Payload type (type de payload) | json ou form |
| Data (données) | client_id, api_key, whatsapp_client, country_code, phone, msg |
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#
| Problème | Ce qu'il faut vérifier |
|---|---|
Invalid API key | La clé a été supprimée ou mal saisie. Créez-en une nouvelle dans Paramètres → Clés API et reconnectez le compte. |
Unibox add-on subscription required | Achetez l'option Unibox dans Facturation et forfaits, puis réactivez le Zap. |
No available WhatsApp clients | Aucun numéro n'a été défini sur le déclencheur, et tous les numéros connectés ont déjà un écouteur Unibox, ou aucun numéro n'est connecté. Cela inclut l'écouteur que Wbiztool a créé la première fois que vous avez activé ce Zap : désactiver un Zap ne le supprime pas, donc le réactiver (par exemple après avoir modifié le Zap) peut échouer. Supprimez un écouteur dont vous n'avez plus besoin, comme celui-ci, dans les écouteurs Unibox, ou connectez un autre numéro dans les paramètres WhatsApp. |
Invalid WhatsApp client | Le numéro défini sur le déclencheur n'est pas connecté actuellement. Reconnectez-le dans les paramètres WhatsApp. |
| Le Zap est activé mais ne se déclenche pas | Votre numéro WhatsApp doit rester connecté pour que les nouveaux messages soient détectés. Vérifiez l'écouteur dans les écouteurs Unibox. |
Zapier affiche une erreur lorsque vous désactivez le Zap, comme Listener not found ou une erreur serveur | Il s'agit d'un problème connu. Vérifiez l'écouteur dans les écouteurs Unibox pour voir si son URL de webhook a été supprimée. |
