Intégration n8n

Envoyez des messages WhatsApp depuis vos workflows n8n. Par exemple, écrivez à un nouveau prospect depuis un webhook, confirmez une commande de votre boutique ou envoyez une alerte lorsqu'une vérification échoue.

Il existe deux façons de vous connecter :

• Le community node Wbiztool (n8n-nodes-wbiztool) : des nodes prêts à l'emploi avec un champ pour chaque option.
• Le node HTTP Request intégré : fonctionne sur toutes les instances n8n et donne accès à tous les endpoints de l'API. Consultez Utiliser le node HTTP Request.

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.
• Le WhatsApp Client ID du numéro d'envoi, affiché dans les paramètres WhatsApp.

Installer le community node#

1. Ouvrez les community nodes

   Dans n8n, allez dans Settings → Community Nodes (paramètres → community nodes) et cliquez sur Install (installer).

2. Saisissez le nom du package

   Saisissez n8n-nodes-wbiztool, confirmez et installez. Redémarrez n8n si les nodes n'apparaissent pas.

Sur une instance auto-hébergée, vous pouvez aussi l'installer avec npm dans le dossier des custom nodes de n8n :

npm install n8n-nodes-wbiztool

Créer l'identifiant (credential)#

Ajoutez un nouveau credential de type WbizTool API :

À l'enregistrement, n8n teste le credential avec l'endpoint Vérifier les identifiants.

Nodes#

Le package ajoute les nodes suivants. Chacun appelle un endpoint de l'API Wbiztool et renvoie la réponse de l'API.

WbizTool Send Message#

Le node renvoie messageId (le msg_id de l'API). Conservez-le si vous souhaitez vérifier le statut du message ou l'annuler plus tard.

Exemple de workflow#

1. Un node Webhook reçoit un nouveau prospect avec phone et name.
2. WbizTool Send Message : définissez Phone Number sur {{ $json.phone }} et Message Text sur Hi {{ $json.name }}, thanks for signing up!.
3. Node IF : vérifiez que {{ $json.messageId }} n'est pas vide pour passer à l'étape suivante, par exemple la mise à jour de votre CRM.

Un WbizTool Send Message réussi renvoie un item comme celui-ci :

{
  "success": true,
  "messageId": 9817263,
  "status": 1,
  "message": "Created",
  "response": { "status": 1, "message": "Created", "msg_id": 9817263 }
}

L'item inclut aussi un objet input avec les valeurs envoyées par le node. Si l'API renvoie une erreur, le node s'arrête et affiche le message de l'API. Activez Continue On Fail pour obtenir à la place un item avec success: false et le texte de l'error.

Pour WbizTool WhatsApp Client Status, utilisez la méthode de vérification General Status. La méthode Status by ID renvoie une erreur pour tous les numéros, à cause d'un bug de cet endpoint de l'API. Avec General Status, un numéro non connecté arrête aussi le node avec une erreur Disconnected : activez le paramètre Continue On Fail du node si vous voulez créer une branche selon le résultat.

Utiliser le node HTTP Request#

Ajoutez un node HTTP Request et configurez-le ainsi :

Collez ensuite un corps comme celui-ci et associez les valeurs des nodes précédents à l'aide d'expressions :

{
  "client_id": 12345,
  "api_key": "YOUR_API_KEY",
  "whatsapp_client": 678,
  "msg_type": 0,
  "country_code": "91",
  "phone": "{{ $json.phone }}",
  "msg": "Hi {{ $json.name }}, thanks for signing up!"
}

Un appel réussi renvoie {"status": 1, "message": "Created", "msg_id": 9817263}. Tous les champs et messages d'erreur sont décrits dans l'API d'envoi de messages.

Pour appeler d'autres endpoints, modifiez l'URL et le corps. Par exemple, pour programmer un message, utilisez https://wbiztool.com/api/v1/schedule_msg/ et ajoutez date au format DD/MM/YYYY, time au format HH:MM et timezone. Consultez Programmer un message.

Pour envoyer le même message à plusieurs numéros ou groupes en un seul appel, utilisez https://wbiztool.com/api/v1/send_msg/multi/ et placez les destinataires dans phone sous la forme d'une seule chaîne séparée par des virgules. Consultez Envoyer à plusieurs numéros.

{
  "client_id": 12345,
  "api_key": "YOUR_API_KEY",
  "whatsapp_client": 678,
  "msg_type": 1,
  "country_code": "91",
  "phone": "{{ $json.phones }}",
  "img_url": "https://example.com/offers/diwali-sale.jpg",
  "msg": "Our Diwali sale starts tomorrow!"
}

Ne mettez que des chiffres dans chaque numéro. Tout ce qui n'est pas un nombre entier, comme 98765 43210, est envoyé comme nom de groupe.

Les expressions n8n fonctionnent dans n'importe quel champ de texte. Par exemple, une salutation qui dépend du moment de la journée, ou un texte qui dépend du montant total de la commande :

{
  "msg": "Good {{ $now.hour < 12 ? 'morning' : 'evening' }} {{ $json.name }}, your order total is {{ $json.total }}.{{ $json.total > 1000 ? ' Delivery is free.' : '' }}"
}

$now utilise le fuseau horaire du workflow (Workflow settings → Timezone) : réglez-le pour décider quand se termine le « morning ».

Être averti de l'envoi d'un message#

1. Créez un workflow de webhook

   Ajoutez un node Webhook avec la méthode HTTP POST et copiez son URL de production.

2. Transmettez l'URL lors de l'envoi

   Indiquez cette URL dans l'option Webhook URL du node, ou dans le champ webhook du corps de votre requête HTTP.

3. Lisez le résultat

   Wbiztool appelle l'URL une fois le message envoyé ou en échec. Le corps est encodé en formulaire et ne contient que msg_id et status, qui vaut SENT ou FAILED.

Consultez Webhook pour les nouvelles tentatives et les délais d'expiration.

Dépannage#