Aller au contenu principal

Noeud whatsapp

Le noeud whatsapp permet l'intégration avec l'API WhatsApp Business Cloud (Meta). Grâce à cela, le flux peut envoyer des messages texte ordinaires et des messages de modèle approuvés avec substitution de variables aux utilisateurs.

Paramètres du noeud whatsapp​

Fenêtre "Node Information" du nœud whatsapp avec les champs "wa_phone_number_id", "wa_access_token", "wa_api_version", "wa_action", "wa_to", "wa_text"

Dans les en-têtes ci-dessous se trouvent les étiquettes des champs dans le formulaire du noeud, entre parenthèses se trouvent les clés sous lesquelles les valeurs sont enregistrées dans le schéma JSON.

1. Phone Number ID (phoneNumberId)​

Identifiant du numéro d'expéditeur dans Meta. Vous pouvez le trouver dans la section WhatsApp → Getting Started dans le Meta Business Manager.

Prend en charge Mustache.

Exemple :

{{flow.phoneNumberId}}

2. Access Token (accessToken)​

Jeton d'accès permanent du Meta Business Manager.

Prend en charge Mustache — le jeton peut être stocké dans une variable de flux (flow) et substitué via {{variable}}.

Exemple :

{{flow.whatsappToken}}

3. API Version (apiVersion)​

Version de l'API Graph qui sera utilisée pour les requêtes. Champ statique, par défaut — v20.0.

Exemple :

v20.0

4. Action (action)​

Type de message envoyé. Options disponibles :

  • Message (par défaut) — message texte ordinaire. Active les champs Recipient et Message text.
  • Template — message de modèle, préalablement approuvé dans Meta. Active les champs Recipient, Template name, Localization et Components.

5. Recipient (to)​

Numéro de téléphone du destinataire au format international : avec l'indicatif du pays, sans le signe + et sans espaces. Ce champ est présent dans les deux options Action.

Prend en charge Mustache.

Exemple :

{{payload.user.phone}}

ou statiquement : 79001234567

6. Message text (text)​

Texte du message. Utilisé uniquement lors de Action : Message.

Prend en charge Mustache.

Exemple :

Votre commande n°{{payload.orderId}} a été passée avec succès. Attendez la livraison.

7. Template name (templateName)​

Nom du modèle, approuvé dans le Meta Business Manager. Utilisé uniquement lors de Action : Template.

Prend en charge Mustache.

Exemple :

order_confirmation

8. Localization (locale)​

Langue du modèle. Doit correspondre exactement à la langue du modèle dans les paramètres Meta. Utilisé uniquement lors de Action : Template.

Exemples :

  • en_US — anglais (États-Unis)
  • fr_FR — français

9. Components (components)​

Paramètres du modèle — valeurs des variables qui seront substituées dans le modèle lors de l'envoi. Utilisé uniquement lors de Action : Template.

Les composants sont ajoutés avec le bouton + Component et sont numérotés (Component 1, Component 2, …). Chaque composant contient trois champs :

  • type — section du modèle : header (en-tête) ou body (corps principal).
  • parameter_name — nom de la variable, tel qu'il est défini dans le modèle dans le tableau de bord WhatsApp Business.
  • text — valeur qui sera substituée à la variable. Prend en charge Mustache.

Exemple :

type: body  |  parameter_name: order_id   |  text: {{payload.orderId}}
type: body  |  parameter_name: amount     |  text: {{payload.totalPrice}}

Exemples d'utilisation​

Exemple 1 : Notification de commande par texte​

Flux :

[events: order_created] ---> [whatsapp]

Paramètres du noeud :

  • Phone Number ID : {{flow.phoneNumberId}}
  • Access Token : {{flow.whatsappToken}}
  • API Version : v20.0
  • Action : Message
  • Recipient : {{payload.order.phone}}
  • Message text : Votre commande n°{{payload.order.id}} a été acceptée. Montant : {{payload.order.totalPrice}} rub.

Résultat :
Lors de la création de la commande, l'utilisateur recevra un message WhatsApp avec les détails de la commande.

Exemple 2 : Message de modèle avec variables​

Flux :

[events: order_status_changed] ---> [whatsapp]

Paramètres du noeud :

  • Action : Template
  • Recipient : {{payload.order.phone}}
  • Template name : order_status_update
  • Localization : en_US
  • Components : 
    type: body  |  parameter_name: order_id    |  text: {{payload.order.id}}
    type: body  |  parameter_name: status      |  text: {{payload.order.status}}

Résultat :
L'utilisateur recevra un message de modèle approuvé avec les valeurs substituées du numéro de commande et du statut.

info

Les messages de modèle doivent être préalablement créés et approuvés dans le Meta Business Manager. Les valeurs des champs Template name et Localization doivent correspondre exactement aux paramètres du modèle approuvé.