WhatsApp

As mensagens saem do seu número, pela sua conta na Meta. Sem a integração, o app não envia nada por WhatsApp: a tela pode ter o botão, mas o envio é recusado com o aviso de que o WhatsApp não está configurado neste app.

Antes de começar

• Plano: Builder. O plano é conferido a cada envio: se a conta sair do Builder, o app para de enviar;
• Conta no Meta for Developers e, para produção, uma conta empresarial da Meta com um número de telefone próprio para o WhatsApp;
• Custo: a Meta cobra pelas mensagens conforme a tabela dela, na sua conta. Além disso, cada mensagem enviada pelo app consome créditos de integração da plataforma, e só quando a Meta aceita o envio.

O que o app faz com a integração

• enviar uma mensagem de texto para um número;
• enviar uma mensagem de modelo (template) aprovada pela Meta, no idioma do modelo;
• receber mensagens e disparar automações quando alguém escreve para o número. Para isso servem os dois últimos campos do card (veja o fim deste guia).

Os números vão no formato internacional, com código do país: +5511999999999.

Passo a passo

Campos do card: Phone Number ID, Access Token, Verify Token (webhook) e App Secret (assinatura do webhook).

1. em developers.facebook.com, crie um app do tipo Business;
2. adicione o produto WhatsApp ao app. A Meta já oferece um número de teste;
3. em WhatsApp → API Setup, copie o Phone number ID e o token de acesso;
4. em Configurações → Básico, revele e copie o App Secret;
5. invente um Verify Token: qualquer texto secreto, que você vai usar de novo no painel da Meta se for receber mensagens;
6. no editor do app, aba Integrações, categoria Notificações, abra o card WhatsApp;
7. preencha os quatro campos e clique em Salvar e ativar.

Token de teste e token permanente

O token que aparece em API Setup é temporário e expira em cerca de 24 horas. Serve para o primeiro teste e só. Para o app em uso, gere um token permanente com um usuário do sistema, em Configurações do negócio → Usuários do sistema, dando a ele acesso ao app e ao WhatsApp. Depois abra o card, cole o token novo no campo dele e salve. Os outros campos podem ficar em branco: o valor salvo é mantido.

Números de destino no modo de teste

Enquanto o app da Meta está em modo de teste, ele só envia para números cadastrados como destinatários permitidos no próprio API Setup, e a Meta limita essa lista a poucos números. Cadastre o seu para testar.

Modelos de mensagem (templates)

A regra é da Meta, não da plataforma: a empresa só pode mandar texto livre para quem escreveu para o número nas últimas 24 horas. Fora dessa janela, a primeira mensagem tem de ser um modelo aprovado.

Na prática, lembretes e avisos que o app manda por conta própria (um lembrete de consulta, uma confirmação de pedido) quase sempre precisam de modelo. O caminho:

1. no Gerenciador do WhatsApp da sua conta empresarial, crie o modelo, com o texto e as variáveis;
2. envie para aprovação e espere a Meta aprovar;
3. peça no chat que o app use aquele modelo, dizendo o nome exato do modelo e o idioma. Sem idioma informado, o app usa pt_BR.

Como saber que funcionou

O card do WhatsApp não testa a credencial ao salvar: Conectado quer dizer que os campos foram salvos, não que o token vale. A prova é um envio real:

1. peça no chat um botão de teste que mande uma mensagem para o seu número (isso gasta crédito de IA, como qualquer construção);
2. use o botão e confira se a mensagem chegou;
3. se não chegou, o erro que aparece traz a mensagem da própria Meta.

Receber mensagens

Os campos Verify Token (webhook) e App Secret (assinatura do webhook) existem para o app receber mensagens: o Verify Token confirma para a Meta que o endereço é seu, e o App Secret prova que cada mensagem recebida veio mesmo da Meta. Sem o App Secret, toda mensagem recebida é recusada.

O endereço de retorno que a Meta pede para cadastrar nesse passo não aparece no card hoje. Se o seu app precisa receber mensagens, fale com o suporte para obter o endereço do seu projeto.

Problemas comuns

• Funcionou ontem e hoje não envia. É o token temporário, que expirou. Gere o permanente (veja acima);
• Erro sobre destinatário não permitido. O app da Meta está em modo de teste e o número de destino não está na lista de permitidos;
• O lembrete não chega, mas a resposta a um cliente chega. É a janela de 24 horas: fora dela, só modelo aprovado;
• Erro sobre o modelo. O nome ou o idioma não batem com o modelo aprovado, ou ele ainda não foi aprovado;
• O envio é recusado por falta de crédito. O saldo de créditos de integração acabou. Veja o painel, em Cobrança.