Pular para o conteúdo
PTEN

WhatsApp Business

Seu cliente recebe o lembrete onde ele realmente lê, a partir do seu próprio número.

O que faz

Com o WhatsApp conectado, a ação Enviar um WhatsApp ao cliente do Cord Workflows envia seu modelo aprovado para o telefone do cliente do documento, com dados do evento nas variáveis: um lembrete de pagamento antes do vencimento, o aviso de um orçamento prestes a expirar, a confirmação de uma entrada.

O Cord envia WhatsApp pela Cloud API da Meta e com a sua conta: as mensagens saem do seu número, e quem cobra cada mensagem da sua conta é a Meta, não o Cord.

A Meta não permite iniciar uma conversa com texto livre, só com um modelo aprovado. Por isso o Cord pede o nome do seu modelo e preenche as variáveis dele; não há um campo de mensagem livre porque a Meta o recusaria.

Sem conectar nada, a Cobrança (botão Lembrar pelo WhatsApp) e a ficha de cada cliente têm um botão que abre o WhatsApp no seu celular ou no seu computador com a mensagem pronta, para você mesmo enviar. Esse botão não usa esta integração: esta página é para o Cord enviar a mensagem sozinho, a partir de um workflow. A mensagem pronta da Cobrança sai no idioma dos documentos de cada cliente.

Requisitos

Onde O que você precisa
Cord A permissão de Configurações. Qualquer plano.
Meta for Developers Um app com o produto WhatsApp e o seu número remetente adicionado. É dali que sai a identificação do número (só dígitos).
Gerenciador do WhatsApp Um modelo de mensagem aprovado pela Meta, com até 4 variáveis ({{1}} a {{4}}). Anote o nome exato e o idioma dele.
Token Um token de acesso permanente da sua conta da Meta com permissão para enviar mensagens desse número. Um token que expira deixa de funcionar, e as mensagens começam a falhar.
Seus clientes Um telefone salvo com o código do país (+55 11 91234-5678). O Cord não adivinha o país: o mesmo número existe em vários.
Custo A Meta cobra da sua conta da Meta cada mensagem enviada com modelo, conforme o país do destinatário. O Cord não cobra pelas mensagens.

Conectar

  1. No Meta for Developers, crie um app do WhatsApp Business e adicione o seu número remetente.
  2. No Gerenciador do WhatsApp, crie um modelo e envie-o para aprovação. Exemplo: Olá, {{1}}. Sua fatura {{2}} no valor de {{3}} vence em {{4}}. Você pode pagá-la pelo link que enviamos por e-mail.
  3. Copie a identificação do número (só dígitos) e gere um token de acesso permanente.
  4. No Cord, acesse Configurações › Integrações › WhatsApp Business e preencha Identificação do número, Token de acesso, Nome do modelo (em minúsculas, sem espaços nem acentos, como aparece na Meta) e Idioma do modelo (por exemplo pt_BR ou en_US).
  5. Clique em Salvar e depois em Enviar teste para o seu próprio número, com o código do país.

O token é salvo criptografado e não é mostrado de novo; o cartão só diz “Há um token salvo”. Para mudar o modelo, deixe o campo do token vazio e salve: o Cord mantém o que já tinha.

Detalhe do WhatsApp Business conectado: ID do número, token salvo, modelo recordatorio_pago em es_MX e o número com código do país para enviar um teste.

Usar em um workflow

A etapa Enviar um WhatsApp ao cliente tem até 4 variáveis, de até 200 caracteres cada uma. Cada variável preenche {{1}}, {{2}}… do seu modelo, na ordem, e aceita dados do evento: {{cliente}}, {{folio}}, {{numero}}, {{total}}, {{saldo}}, {{vence}}. As quebras de linha dentro de uma variável viram espaços.

O modelo chega no idioma em que a Meta o aprovou, igual para todos os seus clientes: a sua organização usa um só modelo, então ele não acompanha o idioma dos documentos de cada cliente. Se os seus clientes falam vários idiomas, a ação Enviar um e-mail ao cliente envia, sim, o e-mail no idioma de cada um.

Com o modelo do exemplo, em um workflow com o gatilho O vencimento de uma fatura se aproxima:

Variável da etapa Valor Chega como
Variável 1 {{cliente}} Grupo Andino
Variável 2 {{numero}} F-00231
Variável 3 {{saldo}} MX$ 12.500,00
Variável 4 {{vence}} 2026-10-10

O telefone vem do cliente do documento, nunca de um campo da etapa: um workflow não pode escrever para um número que não seja o do seu cliente.

O que circula e em que direção

O WhatsApp é uma integração somente de saída.

Direção O que circula Quando
Do Cord para o cliente Seu modelo aprovado, com as variáveis já preenchidas, a partir do seu número. Quando a etapa do workflow é executada.
Do cliente para o Cord Nada. Se o cliente responder, a resposta chega ao seu número nas ferramentas da Meta; o Cord não a lê nem a guarda. —

Por isso convém que o modelo leve o cliente aonde ele realmente age — o link do documento que ele já recebeu por e-mail — e que sua equipe atenda as respostas pela conta do WhatsApp da empresa.

Limites

Limite Valor
Mensagens a partir de workflows 60 por hora por organização
Testes a partir de Configurações 5 por hora
Variáveis por mensagem 4, de até 200 caracteres
Números remetentes por organização 1
Modelos por organização 1 (o que você salvou no cartão)
Custo por mensagem Cobrado pela Meta da sua conta, conforme o país

Desconectar

  1. Acesse Configurações › Integrações › WhatsApp Business.
  2. Clique em Desconectar. Você verá “WhatsApp desconectado”.

O Cord apaga a identificação do número, o token e o modelo, e deixa de enviar mensagens. Os workflows com a ação do WhatsApp falharão com “Conecte o WhatsApp em Configurações › Integrações para usar esta ação.” até você reconectar.

Desconectar no Cord não revoga o token na Meta. Se quiser invalidá-lo, faça isso também na sua conta da Meta.

Problemas frequentes

Mensagem ou sintoma O que fazer
“O cliente não tem um telefone com código do país cadastrado.” Edite o cliente e salve o número com + e o código do país. Depois, clique em Tentar novamente na execução.
“O WhatsApp não aceitou o seu modelo” Verifique se ele está aprovado, se o nome e o idioma coincidem e se o número de variáveis da etapa é o mesmo do modelo.
“O WhatsApp não aceitou a mensagem” Normalmente o token expirou ou o número remetente foi desativado na Meta. Em um workflow, o Cord tenta de novo sozinho; no teste, verifique o token e o número remetente.
“Conecte o WhatsApp em Configurações › Integrações para usar esta ação” Falta a identificação do número, o token ou o nome do modelo. Preencha-os e salve.
“A identificação do número tem apenas dígitos…” Você colou o telefone em vez da identificação. Copie-a do painel do WhatsApp da Meta.
“O nome do modelo vai em minúsculas, sem espaços nem acentos” Digite o nome exatamente como aparece na Meta, por exemplo lembrete_pagamento.
“O idioma do modelo vai no formato pt_BR ou en_US” Use o código de idioma com que você aprovou o modelo.
O teste falha, mas o modelo está aprovado Enviar teste preenche só {{1}}, com a palavra “teste”. Se o seu modelo não tiver exatamente uma variável, a Meta pode recusar o teste mesmo que o workflow funcione: teste a partir de um workflow com todas as variáveis.
O texto de uma variável sai em outro lugar Se você deixar vazia uma variável do meio (por exemplo a 2) e preencher a seguinte, o Cord não envia a vazia e as seguintes se deslocam: a 3 preenche {{2}}. Preencha as variáveis em ordem, sem lacunas.

Relacionadas