API oficial do WhatsApp

O Falia conecta o WhatsApp da empresa de duas formas. Quem escolhe, por empresa, é a equipe da Proton:

	QR code	API oficial da Meta
Para quem	Empresas menores, poucos atendimentos por dia	Empresas com volume, disparo e mais de um atendente
Como conecta	O dono lê o QR code em Conexão	A Proton configura com os dados da conta Meta Business da empresa
Risco de bloqueio do número	Existe (conexão não oficial)	Não: é o canal oficial da Meta
Mensagem para quem não escreveu nas últimas 24 h	Texto livre	Só com modelo aprovado pela Meta
Custo da Meta	Nenhum	Cobrança da Meta por conversa (principalmente modelos de marketing)

Coexistência com o app WhatsApp Business

Se a empresa já usa o app WhatsApp Business no celular, dá para manter o app e ligar a API oficial no mesmo número (modo coexistência da Meta):

• o histórico do app é importado e aparece no painel;
• as respostas dadas pelo celular também aparecem no painel e pausam o robô na conversa, como uma resposta pelo painel;
• os nomes dos contatos salvos no app aparecem nas conversas.

Cuidados da coexistência

Abra o app WhatsApp Business no celular pelo menos uma vez a cada 13 dias, senão a Meta desconecta a conta. Na entrada, a Meta desconecta os aparelhos vinculados (WhatsApp Web, computador). Depois, dá para conectar de novo os aparelhos que ela aceita.

Janela de 24 horas

Pela regra da Meta, a empresa pode escrever livremente até 24 horas depois da última mensagem do cliente. Depois disso:

• a conversa mostra o aviso "Faz mais de 24 h que o cliente não escreve";
• o campo de mensagem dá lugar a Modelo aprovado: escolha o modelo, preencha as variáveis e confira a prévia antes de enviar;
• quando o cliente responde, a conversa volta ao normal.

O robô não é afetado, porque ele só responde quem acabou de escrever.

Modelos (templates)

Os modelos são criados e aprovados no Gerenciador do WhatsApp da Meta (business.facebook.com). O Falia mostra os modelos aprovados da conta. No painel dá para usar modelos com variáveis só no texto (1, 2…). Modelos com imagem ou botão variável aparecem como indisponíveis e são enviados pelo Gerenciador.

Disparo

Na API oficial, o Disparo usa um modelo aprovado no lugar do texto livre. Escreva {nome} numa variável para personalizar com o nome de cada contato. Mande só para quem aceitou receber: se muita gente bloquear ou denunciar, a Meta reduz o limite de envio do número.

Para integrações

• GET /api/v1/status informa provider: evolution (QR code) ou cloud (API oficial).
• GET /api/v1/templates lista os modelos aprovados.
• POST /api/v1/messages aceita template (name, language, params). Texto livre fora da janela devolve 409.
• No MCP, as ferramentas list_templates e send_template.
• O webhook message.status_updated avisa quando uma mensagem foi entregue, lida ou falhou.

Veja a referência da API.