Como conectar um agente de IA à API do WhatsApp Business (passo a passo)

O que significa, na prática, conectar a IA ao WhatsApp?

O aplicativo gratuito WhatsApp Business é algo que você baixa em um celular. A API do WhatsApp Business, que a Meta chama de Plataforma WhatsApp Business, é uma coisa totalmente diferente. Não há ícone de aplicativo nem tela de celular envolvida. É um conjunto de regras que um programa de computador segue para enviar e receber mensagens automaticamente, usando o que se chama de API (Interface de Programação de Aplicações, um jeito de dois sistemas trocarem informação sem que uma pessoa clique em nada).

Na maioria dos casos, você não se conecta a essa API diretamente. Você passa por uma empresa que a Meta chama de Provedor de Soluções para Empresas, que hospeda a conexão técnica e oferece um painel ou uma interface de código. Seu agente de IA se liga ao sistema desse fornecedor. Quando um cliente manda uma mensagem, ela chega como dado, a IA a lê, decide a resposta com base no que recebeu, e o fornecedor envia essa resposta de volta.

• Depende de uma conta verificada no Meta Business Manager, não só de um login no Facebook ou no Instagram.
• Depende de um número de telefone registrado especificamente na API, separado de qualquer número que ainda use o aplicativo gratuito.
• Depende de modelos de mensagem aprovados para tudo que for enviado fora de uma conversa iniciada pelo cliente.
• Depende de a IA ter informação correta e atual para responder, como preços, horários e políticas, porque ela não conhece o seu negócio se ninguém contar.

O que é a verificação de negócio da Meta e por que ela vem primeiro?

Antes de registrar qualquer número na API, a Meta quer confirmar que o negócio por trás dele é real. Isso acontece dentro do Meta Business Manager, uma conta separada do seu login pessoal no Facebook ou no Instagram. Você informa a razão social, um endereço e, em geral, um número de registro da empresa ou de CNPJ. Confira o que as regras do seu país dizem sobre qual documento vale como comprovante, porque isso varia de país para país.

1. Crie uma conta no Meta Business Manager usando um e-mail comercial, não um pessoal.
2. Informe os dados do negócio exatamente como aparecem no seu documento oficial de registro.
3. Envie o negócio para verificação, anexando o documento que a Meta pedir.
4. Aguarde a decisão. Pode levar alguns dias, e às vezes mais se alguma informação não bater.

O motivo mais comum para a verificação travar é uma divergência: o nome do negócio digitado na Meta não é exatamente o mesmo do documento de registro, ou o endereço está um pouco diferente. Não há como pular essa etapa nem contorná-la depois, e todas as etapas seguintes partem do princípio de que ela está concluída.

Como escolher um nome de exibição que a Meta realmente aprove?

Depois de verificado, você pede um nome de exibição, o nome que os clientes veem no lugar de um número de telefone puro, parecido com um identificador de chamadas. A Meta confere se ele corresponde à identidade verificada do seu negócio ou a uma versão dela sob a qual o negócio realmente atua. Uma padaria registrada como “Zamzam Comércio de Alimentos Ltda”, mas conhecida do público como “Padaria do Zam”, em geral pode usar o nome fantasia mais curto, desde que ele já apareça na fachada, nas notas fiscais ou em uma página pública.

• Em geral, ele não pode conter número de telefone, URL nem emoji.
• Em geral, ele não pode alegar um status que o negócio não tem, como “Oficial” ou “Certificado”, a menos que seja verdade.
• Em geral, ele precisa corresponder a algo que o cliente já reconheceria, não a um nome inventado só para o WhatsApp.

Recusas acontecem e podem ser contestadas, mas cada contestação volta para a análise, o que soma mais dias. O jeito mais simples de evitar isso é enviar já na primeira vez o mesmo nome que está impresso na fachada da loja ou na sua página de rede social.

Qual número de telefone usar na API do WhatsApp Business?

Essa é a decisão em que as pessoas mais erram, e aquela de que se arrependem semanas depois. Você tem duas opções reais: migrar um número que já usa ou registrar um número novo que vai existir só para essa finalidade.

Por que colocar um número pessoal na API sai caro depois

Quando um número é registrado na Plataforma WhatsApp Business, ele deixa de se comportar como uma conta normal de WhatsApp. Você não consegue abrir esse mesmo número no aplicativo gratuito do seu celular e responder como antes. O número passa a pertencer à API e ao fornecedor que a hospeda. Se a IA entender mal uma mensagem, você não pode simplesmente pegar o celular e responder como faria com o aplicativo: é preciso passar pelo sistema do fornecedor ou por um posto de atendimento humano ligado a ele.

Duas versões disso dão errado na prática. A primeira: o dono põe o celular pessoal na API, aquele que está impresso no cartão de visita, salvo em anos de contatos de clientes, aquele para o qual a própria família liga, e descobre que não pode mais usá-lo como WhatsApp pessoal no próprio celular. A segunda, menos óbvia: o medo do primeiro erro leva o dono a registrar um número totalmente novo, mas os clientes continuam mandando mensagem para o número antigo por hábito, e ninguém acompanha esse número antigo porque ele nunca foi migrado.

Qual é o passo a passo para ligar o agente de IA quando o número está pronto?

Essa parte em geral pode ser feita por um dono sem conhecimento técnico, pelo painel de um fornecedor, sem escrever código, embora exija paciência, porque várias etapas dependem da análise da Meta.

1. Escolha um Provedor de Soluções do WhatsApp Business e abra uma conta com ele.
2. Informe a ele o ID do seu Meta Business Manager verificado e o número de telefone que você vai dedicar à API.
3. Conclua o registro do número, em geral com um código único enviado por SMS ou ligação para esse número.
4. Envie os modelos de mensagem de que vai precisar para lembretes, confirmações ou qualquer coisa enviada fora de uma conversa em andamento, porque eles precisam de aprovação separada e não podem ser editados rápido depois de enviados.
5. Conecte o agente de IA ao canal do fornecedor, dando a ele acesso para ler as mensagens recebidas e enviar respostas.
6. Carregue o material de consulta da IA: preços, horários, regras de reembolso, política de entrega, perguntas frequentes, tudo por escrito, sem deixar a IA adivinhar.
7. Teste com perguntas reais, do seu próprio celular, antes de passar todo o atendimento para ela.
8. Defina uma regra clara de transferência para quando a IA deve parar e uma pessoa assumir: uma pergunta confusa, uma reclamação, uma disputa de pagamento.

Quando não vale a pena conectar um agente de IA à API do WhatsApp?

Um negócio que recebe poucas mensagens de WhatsApp por semana não precisa de verificação, taxas de fornecedor e aprovação de modelos de mensagem: responder manualmente pelo aplicativo gratuito é mais rápido de configurar e mais fácil de mudar de ideia depois.

Conversas que exigem julgamento, e não informação, não combinam com respostas diretas de uma IA. Um advogado discutindo os termos de um acordo ou um médico discutindo um diagnóstico não deveriam ter essa conversa conduzida por uma IA que lê e responde sozinha. A IA ainda pode ser útil nesses casos para agendamentos ou lembretes, com a parte sensível encaminhada direto a uma pessoa.

Se os preços, os horários e as políticas ainda não estão escritos em lugar nenhum, conectar um agente de IA antes disso só faz com que ele chute, ou diga que não sabe, em loop.

Leia a seguir

• antes de conectar qualquer coisa, ajuda saber o que faz um número de WhatsApp ser restringido
• vale entender por si só a diferença entre o aplicativo gratuito e a API paga do WhatsApp Business
• depois que o número estiver conectado, este texto mostra o que o agente de IA faz no dia a dia