WhatsApp oficial com IA: conecte processos e entenda o custo

Uma mensagem deve avançar o processo

Uma confirmação de entrega pode atualizar a torre de controle. Uma solicitação de orçamento pode iniciar a consulta ao ERP. Um documento recebido pode alimentar uma tarefa de conferência. O canal ganha valor quando a conversa mantém vínculo com pedido, responsável e próxima ação.

Escolha um fluxo e defina o que significa concluí-lo. Receber uma resposta não significa aprovar um orçamento, alterar um pedido ou autorizar pagamento. Para o primeiro piloto, use contatos autorizados e dados sintéticos, preserve revisão humana nas ações de negócio e compare o resultado com o processo atual.

Prepare a conta e conecte pelo fluxo da Meta

A Cloud API utiliza um portfólio empresarial Meta, uma WhatsApp Business Account (WABA) e um número comercial. Confirme com o administrador quem pode autorizar esses ativos. Os identificadores da conta e do número são diferentes do telefone visível e da chave da API Zild.

Na versão da Zild revisada, abra a configuração do canal WhatsApp API e salve o cadastro antes de conectar. Na área de conexão com a Meta, use Login with Facebook e conclua o cadastro integrado com os ativos da empresa. A interface recebe o código de autorização, o WABA ID e o Phone Number ID; os campos WhatsApp Identifier e WhatsApp Account SID são somente leitura nesse fluxo. Os nomes podem aparecer traduzidos conforme o idioma da interface.

Espere a confirmação de conexão e reabra o canal para conferir o vínculo com o agente. A opção de coexistência aparece na implementação, mas sua seleção não comprova que a conta e o número estão habilitados pela Meta. Confirme a elegibilidade no cadastro integrado antes de planejar uso simultâneo ou migração de um número existente.

Confirme a operação antes de ampliar o canal

Cadastro cancelado, identificadores ausentes e autorização pendente são estados incompletos. Confira a mensagem exibida e as permissões com o responsável; não remova uma integração ativa apenas para tentar novamente. A disponibilidade dessa tela depende da versão implantada.

Com um contato de teste autorizado, valide separadamente mensagem de entrada, resposta do agente, status de entrega e transferência para a fila correta. Confira a associação entre canal, conversa e processo; um envio aceito pela API não comprova entrega ou recebimento de eventos. Se um evento não chegar, a administração deve revisar a assinatura e o destino dos webhooks da integração implantada. Este guia não fornece uma URL universal de webhook.

Registre o resultado, o horário e o responsável por tratar falhas, sem copiar tokens para o relatório. Só depois amplie os destinatários e o volume. Para testar templates, confirme idioma, variáveis, aprovação e finalidade; use as regras de janela e consentimento aplicáveis ao canal.

Contatos compartilhados em processos de campo

Quando o canal WhatsApp recebe um contato compartilhado, a integração prepara uma mensagem para cada contato do evento. O texto usa o nome e o primeiro telefone não vazio recebido. Quando o evento contém um vCard aceito pela integração, ele é armazenado como contato.vcf e associado à mensagem; sem esse conteúdo ou com codificação inválida, o contato permanece como texto legível, sem arquivo vCard.

Em uma entrega ou visita técnica, use isso para registrar o contato informado para o local e conferir os dados junto da ocorrência. Não confunda o contato compartilhado com o remetente da conversa: receber o cartão não comprova identidade, autorização para alterar o destinatário ou criação de um cadastro no ERP. Confirme o responsável e a referência da entrega ou ordem de serviço antes de qualquer alteração operacional.

Valide com dados fictícios um contato com arquivo, um contato somente em texto e um evento com mais de um contato. Confira as mensagens efetivamente persistidas na versão implantada; o texto resumido não garante que todos os telefones do cartão estejam visíveis.

Separe três componentes do orçamento

A assinatura Zild segue o porte da empresa e a faixa contratada. O consumo de modelos e serviços externos usa as credenciais configuradas pelo cliente e tem cobrança própria. O canal WhatsApp também possui tarifas, além de eventuais encargos do provedor de mensageria contratado.

Monte o orçamento com assinatura, canal, IA, implantação e operação. Evite somar duas vezes a mesma tarifa quando o parceiro já a inclui na fatura. Registre moeda, impostos aplicáveis, franquias e serviços incluídos na proposta. Uma mensagem sem tarifa da Meta ainda pode acionar um modelo, OCR ou outra ferramenta com custo.

Tarifas de referência para o Brasil

Na consulta ao seletor oficial em 28/10/2026, mercado Brasil e moeda BRL, a Meta exibiu R$ 0,3217 por mensagem de marketing e R$ 0,0350 por mensagem de utilidade na faixa inicial. A cobrança considera mensagens entregues, categoria e mercado do destinatário. Mensagens de serviço são gratuitas; utilidade em resposta ao usuário tem condição de gratuidade. Há faixas de volume para utilidade e autenticação.

Exemplo sintético: 1.000 mensagens de marketing cobradas e 2.000 de utilidade cobradas, todas entregues no Brasil e na faixa inicial, resultam em R$ 391,70 de tarifa de mensagens: 1.000 × 0,3217 + 2.000 × 0,0350. Isso não é o preço total do projeto. Consulte o seletor e a tabela vigente antes de aprovar o orçamento; moeda, categoria, gratuidade e volume alteram a conta.

Planeje janela, template e continuidade humana

A política da Meta exige permissão do destinatário para contatos subsequentes e respeito ao descadastramento. A janela de atendimento de 24 horas abre e reinicia com mensagens do usuário. Fora dela, o envio exige templates aprovados. A automação deve oferecer um caminho claro de escalonamento.

No desenho do fluxo, registre a finalidade do contato, o template escolhido e quem atende uma exceção. Não use uma atualização operacional para esconder uma oferta comercial. O agente deve reconhecer quando faltam dados ou quando o cliente pede uma pessoa, preservar o contexto e encaminhar o caso à equipe responsável.

Conecte o envio ao contrato real da API

Os Docs da Zild descrevem o envio proativo como ferramenta do agente e a operação POST /Conversation/whatsapp-proactive-conversation. O contrato inclui canal, destinatários, agente, template, variáveis e fila. A autenticação da API Zild utiliza X-API-Key; essa chave é distinta da credencial do provedor do canal ou do modelo de IA.

Valide canal e template no ambiente implantado antes de preencher seus identificadores. Não trate um retorno de criação da conversa como confirmação de entrega. O modelo de mensagens documenta estados de envio, entrega, leitura e falha; defina como seu processo acompanha esses estados. Após uma interrupção, reconcilie o evento antes de repetir o envio para evitar mensagens duplicadas.

Avalie custo por processo concluído

Teste destinatário incorreto, variável ausente, template indisponível, mensagem repetida, janela encerrada, pedido de descadastramento e transferência humana. Para uma confirmação logística, confira se a resposta foi associada à entrega correta e se uma divergência abriu uma pendência com responsável.

Acompanhe entrega, conclusão correta, retrabalho, escalonamento e custo total por caso encerrado. Separe campanhas de marketing de atualizações operacionais no relatório. Defina um limite de gasto e um responsável por revisar aumentos de volume. O objetivo é encurtar o processo com controle, não aumentar indiscriminadamente a quantidade de mensagens.