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​

Edit

1. wa_phone_number_id​

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. wa_access_token​

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

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

Exemple :

{{flow.whatsappToken}}

3. wa_api_version​

Version de l'API Graph qui sera utilisée pour les requêtes. Champ statique.

Exemple :

v19.0

4. wa_action​

Type de message envoyé. Options disponibles :

  • text — message texte ordinaire. Active le champ text.
  • template — message de modèle, préalablement approuvé dans Meta. Active les champs templateName, locale et components.

5. wa_to​

Numéro de téléphone du destinataire au format international : avec l'indicatif du pays, sans le signe + et sans espaces.

Prend en charge Mustache.

Exemple :

{{payload.user.phone}}

ou statiquement : 79001234567

6. wa_text​

Texte du message. Utilisé uniquement lors de action: text.

Prend en charge Mustache.

Exemple :

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

7. wa_template_name​

Nom du modèle approuvé dans le Meta Business Manager. Utilisé uniquement lors de action: template.

Prend en charge Mustache.

Exemple :

order_confirmation

8. wa_locale​

Langue du modèle au format language_REGION. Doit correspondre exactement à la langue du modèle dans les paramètres Meta.

Exemples :

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

9. wa_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.

Chaque élément contient trois champs :

  • type — section du modèle : header (en-tête) ou body (corps principal).
  • 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  |  name: order_id   |  text: {{payload.orderId}}
type: body  |  name: amount     |  text: {{payload.totalPrice}}

Exemples d'utilisation​

Exemple 1 : Notification de commande par texte​

Flux :

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

Paramètres du noeud :

  • accessToken: {{flow.whatsappToken}}
  • phoneNumberId: {{flow.phoneNumberId}}
  • apiVersion: v19.0
  • action: text
  • to: {{payload.order.phone}}
  • 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 :

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

Paramètres du noeud :

  • action: template
  • to: {{payload.order.phone}}
  • templateName: order_status_update
  • locale: en_US
  • components: 
    type: body  |  name: order_id    |  text: {{payload.order.id}}
    type: body  |  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 templateName et locale doivent correspondre exactement aux paramètres du modèle approuvé.