Pular para o conteúdo principal

Nó whatsapp

O nó whatsapp fornece integração com a API do WhatsApp Business Cloud (Meta). Com ele, o fluxo pode enviar mensagens de texto comuns e mensagens de modelo aprovadas com substituição de variáveis para os usuários.

Configurações do nó whatsapp​

Edit

1. wa_phone_number_id​

Identificador do número do remetente na Meta. Pode ser encontrado na seção WhatsApp → Getting Started no Meta Business Manager.

Suporta Mustache.

Exemplo:

{{flow.phoneNumberId}}

2. wa_access_token​

Token de acesso permanente do Meta Business Manager.

Suporta Mustache — o token pode ser armazenado em uma variável de fluxo e substituído através de {{variável}}.

Exemplo:

{{flow.whatsappToken}}

3. wa_api_version​

Versão da Graph API que será utilizada para as requisições. Campo estático.

Exemplo:

v19.0

4. wa_action​

Tipo de mensagem enviada. Opções disponíveis:

  • text — mensagem de texto comum. Ativa o campo text.
  • template — mensagem de modelo, previamente aprovada na Meta. Ativa os campos templateName, locale e components.

5. wa_to​

Número de telefone do destinatário no formato internacional: com o código do país, sem o sinal + e sem espaços.

Suporta Mustache.

Exemplo:

{{payload.user.phone}}

ou estaticamente: 79001234567

6. wa_text​

Texto da mensagem. Usado apenas quando action: text.

Suporta Mustache.

Exemplo:

Seu pedido nº{{payload.orderId}} foi realizado com sucesso. Aguarde a entrega.

7. wa_template_name​

Nome do modelo aprovado no Meta Business Manager. Usado apenas quando action: template.

Suporta Mustache.

Exemplo:

order_confirmation

8. wa_locale​

Idioma do modelo no formato language_REGION. Deve coincidir exatamente com o idioma do modelo nas configurações da Meta.

Exemplos:

  • en_US — inglês (EUA)
  • fr_FR — francês

9. wa_components​

Parâmetros do modelo — valores das variáveis que serão substituídos no modelo ao enviar. Usado apenas quando action: template.

Cada elemento contém três campos:

  • type — seção do modelo: header (cabeçalho) ou body (corpo principal).
  • name — nome da variável, conforme definido no modelo no painel do WhatsApp Business.
  • text — valor que será substituído pela variável. Suporta Mustache.

Exemplo:

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

Exemplos de uso​

Exemplo 1: Notificação de pedido por texto​

Fluxo:

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

Configurações do nó:

  • accessToken: {{flow.whatsappToken}}
  • phoneNumberId: {{flow.phoneNumberId}}
  • apiVersion: v19.0
  • action: text
  • to: {{payload.order.phone}}
  • text: Seu pedido nº{{payload.order.id}} foi aceito. Total: {{payload.order.totalPrice}} R$

Resultado:
Ao criar um pedido, o usuário receberá uma mensagem no WhatsApp com os detalhes do pedido.

Exemplo 2: Mensagem de modelo com variáveis​

Fluxo:

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

Configurações do nó:

  • 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}}

Resultado:
O usuário receberá uma mensagem de modelo aprovada com os valores do número do pedido e do status substituídos.

info

As mensagens de modelo devem ser criadas previamente e aprovadas no Meta Business Manager. Os valores dos campos templateName e locale devem coincidir exatamente com os parâmetros do modelo aprovado.