Última atualização: novembro de 2026
Resumo
- Conectar uma IA à WhatsApp Business API envolve quatro tarefas, não uma só: vincular o número, receber mensagens, enviar respostas de acordo com as regras da Meta e encaminhar a conversa para uma pessoa quando a IA deve parar.
- Há três maneiras de fazer isso: desenvolver sua própria solução na Cloud API da Meta, deixar que um Business Solution Provider (BSP) faça a conexão ou usar uma plataforma com agente de IA, modelos e caixa de entrada integrados, como a Invent.
- A janela de 24 horas é a regra que mais causa problemas nas configurações. Enquanto ela estiver aberta, a IA pode responder livremente. Depois que fechar, só é possível enviar um modelo aprovado pela Meta.
- Um único número pode atender à equipe toda. A IA responde primeiro, e o roteamento por IA encaminha a conversa para a pessoa certa em uma caixa de entrada compartilhada.
- Valide a solução com um piloto pequeno: um número, um caso de uso e quatro testes antes de ampliar.
Seus clientes já falam com você pelo WhatsApp. A questão é: quem responde às 2h da manhã, em um domingo ou quando 300 pessoas perguntam "onde está meu pedido?" no mesmo dia? Um agente de IA conectado à WhatsApp Business API pode responder em segundos, com base nas suas políticas e no seu catálogo.
Parece uma tarefa só, mas, na prática, são quatro: vincular um número de telefone, receber mensagens dos clientes, enviar respostas de acordo com as regras da Meta e decidir quando uma pessoa deve assumir a conversa. Se você acertar esses pontos, os clientes recebem respostas rápidas e corretas. Se errar, pode haver falhas no envio, respostas duplicadas ou uma IA que continua falando quando deveria ter parado.
Este guia aborda as três maneiras de fazer a conexão, o que cada uma exige da sua equipe e quais verificações fazer antes de entrar no ar.
Como funciona um agente de IA na WhatsApp Business API
A WhatsApp Business API (que a Meta agora chama de WhatsApp Business Platform; a versão hospedada é a Cloud API) funciona como um canal de comunicação nos dois sentidos. As mensagens chegam por webhooks. As respostas são enviadas por chamadas à API. A IA fica no meio e decide o que dizer.
Alguns termos que você encontrará em qualquer configuração:
- Conta do WhatsApp Business (WABA): a conta que reúne seus números, modelos e configurações.
- Webhook: a notificação que a Meta envia ao seu sistema quando uma mensagem chega ou seu status muda (enviada, entregue, lida).
- Modelo de mensagem: uma mensagem aprovada previamente pela Meta, necessária para iniciar ou retomar uma conversa.
- Janela de atendimento: as 24 horas após a última mensagem do cliente, período em que você pode responder livremente.
Em termos simples, o fluxo funciona assim: o cliente envia uma mensagem, a Meta a encaminha ao seu webhook, seu sistema a passa para a IA, a IA redige uma resposta com base no seu conteúdo e seu sistema a envia de volta. Se a IA não tiver certeza ou o cliente pedir para falar com uma pessoa, a conversa é encaminhada para a sua equipe.
A janela de 24 horas: a regra que você não pode ignorar
A janela de atendimento da Meta é um período de 24 horas. Ela começa e recomeça sempre que o cliente envia uma mensagem. Enquanto estiver aberta, sua IA pode enviar respostas comuns com texto, imagens, documentos ou botões. Depois que ela fechar, só um modelo aprovado poderá chegar ao cliente.
Essa regra determina como sua IA deve se comportar:
- Responda imediatamente enquanto a janela estiver aberta. É nesse momento que um agente de IA compensa o investimento.
- Verifique a janela antes de cada envio. Se ela fechou, a IA não pode improvisar uma mensagem de texto livre.
- Use um modelo para qualquer mensagem enviada depois. Uma atualização de entrega no dia seguinte, um lembrete de consulta ou um link de pagamento enviado após 24 horas exige um modelo aprovado na categoria adequada: marketing, utilidade ou autenticação.
A Meta cobra por mensagem, de acordo com a categoria e o país do cliente, e envia a cobrança diretamente. Desde 1º de outubro de 2026, cada número do WhatsApp recebe 1.000 mensagens de atendimento gratuitas por mês: as respostas enviadas enquanto a janela está aberta. A partir da 1.001ª mensagem, essas respostas também são cobradas, e os modelos são sempre cobrados. Consulte a tabela de preços atual da Meta antes de estimar os volumes. Nosso guia sobre modelos de mensagem do WhatsApp explica o processo de aprovação e como reabrir a janela.
Opção 1: desenvolva sua própria solução na Cloud API da Meta
Esta opção é adequada para equipes com desenvolvedores que querem ter controle total de cada etapa.
- Prepare seus recursos da Meta. Você precisa de um portfólio empresarial da Meta verificado e de um número de telefone que possa receber um código de verificação.
- Crie a WABA e conecte o número. O fluxo Embedded Signup da Meta ou o painel do desenvolvedor cria a conta e registra o número na Cloud API.
- Escolha como o número será migrado. Usar um número novo é a opção mais simples. Um número já usado no app WhatsApp Business pode ser migrado para a API (e o app deixará de funcionar nele) ou usar a coexistência, que permite usar o app e a API com o mesmo número.
- Configure o webhook. Publique uma URL de callback, passe pela verificação do token da Meta e assine os eventos de mensagem e status.
- Proteja o token de acesso. Guarde-o em um gerenciador de segredos, nunca no código do front-end.
- Desenvolva a etapa de IA. Envie cada mensagem ao seu modelo junto com seu conteúdo, permita que ele acione funções (consultar um pedido, reservar um horário) e envie a resposta final de volta pela Messages API.
- Trate os casos excepcionais. Os webhooks podem chegar duas vezes; por isso, salve o ID de cada mensagem e ignore as duplicadas. Tente novamente os envios que falharem. Monitore a classificação de qualidade do número.
A vantagem é ter controle. O custo é que sua equipe fica responsável pelo tempo de atividade, pelas novas tentativas, pelo gerenciamento de modelos, pela caixa de entrada usada pelos atendentes e por cada mudança que a Meta fizer na API.
Opção 2: deixe um Business Solution Provider fazer a conexão
Um Business Solution Provider (BSP) é uma empresa aprovada pela Meta para conectar negócios à API. O BSP hospeda os webhooks, envia as mensagens e, muitas vezes, gerencia os modelos. Você abre mão de parte do controle em troca de agilidade e suporte, mas geralmente ainda precisa fornecer a IA.
Faça estas perguntas antes de assinar:
- Onde a IA é executada? Ela já vem integrada ou você conecta seu próprio modelo pela API do provedor?
- Como é feita a cobrança? Por mensagem, por mês, por usuário ou com uma taxa adicional sobre as tarifas da Meta?
- O que acontece quando um envio falha? Pergunte como o provedor tenta enviar novamente os webhooks e as mensagens.
- Quem gerencia os modelos e quanto tempo leva para corrigir os modelos rejeitados?
- Você pode sair do serviço? Pergunte como transferir o número para outro provedor no futuro.
- Segurança: o provedor tem relatório SOC 2, logs de auditoria e compromisso de disponibilidade?
Uma boa ficha de avaliação para um piloto com BSP inclui: tempo até a primeira mensagem, taxa de entrega, quantidade de conversas encaminhadas a uma pessoa e custo por conversa.
Opção 3: use uma plataforma com agente de IA integrado
A terceira opção elimina toda a parte de infraestrutura. A plataforma conecta o número, executa o agente de IA, gerencia os modelos e oferece uma caixa de entrada para sua equipe, tudo em um só lugar.
Na Invent, você conecta o número pelo Embedded Signup da Meta, dentro do app. A solução funciona com um número novo, um número migrado de outro provedor ou um número que continua no app WhatsApp Business por meio da coexistência. Os modelos são criados, enviados para aprovação e acompanhados no mesmo lugar, sem precisar manter uma planilha de aprovações.
O agente de IA responde com base no seu site, nos seus documentos e nas suas políticas. Quando deve parar, o roteamento por IA encaminha a conversa para a pessoa certa na caixa de entrada compartilhada. A pessoa da equipe vê toda a conversa, o motivo do encaminhamento e o que a IA sabe sobre o cliente. A mesma caixa de entrada reúne WhatsApp, Instagram, TikTok e chat do site, para que uma única equipe atenda a todos os canais.
Esta opção é ideal para equipes de operações que querem respostas precisas e encaminhamentos bem feitos sem contratar engenheiros. Se você precisar de uma lógica personalizada que nenhuma plataforma oferece, a Opção 1 dá mais flexibilidade.
Um número de WhatsApp, várias pessoas respondendo
Uma dúvida comum é se um único número de WhatsApp pode atender à equipe toda. Pela API, pode. O app WhatsApp Business limita a quantidade de dispositivos vinculados. A API não tem limite de dispositivos: todas as mensagens chegam ao seu sistema, e a caixa de entrada define quem responde.
É assim que a IA e as pessoas dividem o trabalho:
- A IA responde primeiro, 24 horas por dia, com base no seu conteúdo.
- O roteamento por IA seleciona a pessoa certa quando a conversa exige discernimento, um reembolso, o tratamento de uma reclamação ou uma venda que precisa de um toque humano.
- Sua equipe responde pelo mesmo número, para que o cliente nunca perceba que a conversa foi transferida para outro contato.
Com uma plataforma, tudo isso funciona desde o primeiro dia. Em uma solução desenvolvida por você, será preciso ter uma caixa de entrada, regras de atribuição e uma forma de impedir que a IA responda quando uma pessoa assumir a conversa.
Onde deve ocorrer a tomada de decisão da IA
A IA nunca deve enviar mensagens diretamente ao WhatsApp. Seu fluxo de processamento verifica a janela, escolhe o tipo de mensagem e faz o envio. A IA apenas decide o que dizer ou qual ação executar, como consultar um pedido, marcar um horário ou verificar uma política.
Mantenha estas três salvaguardas:
- Responda apenas com base no seu conteúdo. Uma IA limitada aos seus documentos e ao seu site sabe reconhecer quando não tem a resposta.
- Peça confirmação antes de movimentar dinheiro. Para reembolsos, pagamentos e reservas, peça ao cliente que confirme pelo chat.
- Encaminhe a conversa quando houver sinais claros. Baixa confiança, assuntos delicados, clientes irritados e decisões sobre políticas devem ser encaminhados a uma pessoa.
O que sua equipe de segurança vai perguntar
Se o WhatsApp transportar dados de clientes, sua avaliação de segurança abrangerá os mesmos pontos, qualquer que seja a opção escolhida:
- Relatório SOC 2 Tipo II para clientes corporativos
- Logon único com seu provedor de identidade
- Logs de auditoria que mostrem quem fez o quê, e funções personalizadas para definir quem pode ver cada conversa
- Controles de gastos, para que um mês movimentado não surpreenda a equipe financeira
- Respostas claras sobre onde as conversas são armazenadas, por quanto tempo e se são usadas para treinar algum modelo
Quanto custa: um exemplo prático
Os custos do WhatsApp vêm de duas cobranças: as tarifas da Meta por mensagem e a plataforma que executa seu agente de IA. Veja como calcular a parte da Meta para uma loja.
Imagine uma loja on-line com um número de WhatsApp. Em um mês, 3.000 clientes enviam mensagens, e o agente de IA responde cerca de duas vezes para cada um, totalizando 6.000 respostas dentro de janelas abertas. A loja também envia 500 atualizações de pedidos no dia seguinte, fora da janela.
- As primeiras 1.000 respostas são gratuitas. Cada número recebe 1.000 mensagens de atendimento gratuitas por mês, e a contagem é reiniciada todo mês.
- As outras 5.000 respostas são cobradas de acordo com a tarifa de atendimento da Meta para o país de cada cliente.
- As 500 atualizações de pedidos são modelos, cobrados de acordo com a tarifa de utilidade da Meta para cada país.
- Entrada gratuita: quando um cliente envia uma mensagem por um anúncio Click to WhatsApp, a maioria das mensagens é gratuita por 7 dias.
As tarifas variam conforme o país e são atualizadas pela Meta. Por isso, consulte os preços por mensagem na tabela de preços atual da Meta. Além da cobrança da Meta, você paga pela IA e pela plataforma. Respostas melhores e mais concisas custam menos nas duas cobranças — mais um motivo para manter as respostas da IA curtas e corretas.
Erros comuns da WhatsApp API e como corrigi-los
A maioria das falhas de envio retorna um código de erro. Estes são os mais comuns e as soluções indicadas pela Meta:
- 131047, mais de 24 horas desde a resposta do cliente: a janela fechou. Envie um modelo aprovado.
- 132001, o modelo não existe: o modelo ainda não foi aprovado ou o nome ou idioma não corresponde. Confira os dois na sua lista de modelos.
- 131026, mensagem não entregue: talvez o número não use o WhatsApp ou o cliente ainda não tenha aceitado os termos mais recentes nem atualizado o app.
- 131049, mensagem não entregue para manter o engajamento saudável: a Meta limita a quantidade de mensagens de marketing recebidas por uma pessoa. Espere pelo menos 24 horas antes de tentar novamente.
- 131056, mensagens demais para a mesma pessoa: você enviou mensagens demais para um cliente em pouco tempo. Aguarde e tente novamente. Os outros clientes não são afetados.
- 130429, limite de taxa atingido: você está enviando mensagens rápido demais no geral. Reduza o ritmo e tente novamente.
- 131042, problema com a forma de pagamento: corrija a forma de pagamento da sua Conta do WhatsApp Business na Meta.
- 368, conta restrita: a conta violou uma política do WhatsApp. Leia o aviso de aplicação de políticas da Meta antes de voltar a enviar mensagens.
Na Invent, a mensagem com falha exibe o erro ao lado, no chat, para que sua equipe veja o que deu errado sem consultar logs. Em uma solução desenvolvida por você, registre cada código junto com o ID da mensagem e alerte alguém quando as falhas aumentarem.
Faça um piloto antes de expandir
Comece com um número de WhatsApp e um caso de uso, como dúvidas sobre pedidos ou agendamento de consultas. Depois, faça quatro testes nesta ordem:
- A primeira mensagem recebida chega ao seu sistema uma única vez, não duas.
- A primeira resposta da IA está correta e é enviada dentro da janela.
- Primeiro encaminhamento chega à pessoa certa com a conversa completa.
- Primeiro envio de modelo é enviado depois que a janela se fecha.
Durante duas semanas, acompanhe o tempo até a primeira resposta, o tempo de resolução, o CSAT, a taxa de encaminhamento e o custo por conversa. Leia 50 conversas manualmente e avalie as respostas da IA e suas decisões de encaminhamento. Defina como voltar atrás: pause a IA e encaminhe todas as conversas para sua equipe se algo não funcionar como deveria.
Em relação aos custos, uma plataforma como a Invent custa a partir de US$ 29 por mês, com US$ 29 em uso incluído no plano Business. Conforme sua operação cresce, você paga conforme o uso, com respostas de IA a partir de US$ 0,003 por mensagem, dependendo do modelo. As tarifas do WhatsApp da Meta são cobradas à parte, diretamente pela Meta. Há um plano gratuito para você experimentar.
Escolha a opção que funciona para sua equipe
Escolha a opção 1 se você tem engenheiros e quer controlar cada etapa. Escolha a opção 2 se quer que um fornecedor gerencie a conexão e já tem uma IA. Escolha a opção 3 se quer o agente de IA, os modelos e a caixa de entrada da equipe em um só lugar.
Seja qual for sua escolha, conecte um número, faça o piloto, analise os resultados e depois amplie. Para ver um passo a passo sem código, leia como criar um chatbot de IA para WhatsApp sem código.
Perguntas frequentes
Como conecto um assistente de IA à API do WhatsApp Business?
Conecte seu número à Cloud API da Meta, receba mensagens por um webhook, envie cada mensagem para a IA e encaminhe a resposta dela dentro da janela de 24 horas. Uma plataforma como a Invent cuida dessas quatro etapas para você por meio do Embedded Signup da Meta, sem precisar escrever código.
Qual plataforma de API do WhatsApp tem IA integrada?
A Invent integra a API do WhatsApp Business a um agente de IA, modelos aprovados, roteamento por IA e uma caixa de entrada compartilhada, tudo em um só lugar. A maioria dos Provedores de Soluções de Negócios cuida apenas da conexão, então você precisa adicionar a IA por conta própria.
Posso continuar usando o aplicativo WhatsApp Business no mesmo número?
Sim, com a coexistência. O aplicativo e a API compartilham um número, então você pode continuar respondendo pelo celular enquanto a IA cuida do restante. Sem a coexistência, ao transferir um número para a API, o aplicativo deixa de funcionar nesse número.
Vários atendentes podem responder usando um único número do WhatsApp?
Sim, pela API. Todas as mensagens chegam ao seu sistema, e uma caixa de entrada compartilhada permite que qualquer quantidade de colegas responda usando o mesmo número. O aplicativo WhatsApp Business limita o uso a alguns dispositivos conectados.
Os modelos de mensagem do WhatsApp precisam ser aprovados?
Sim. A Meta analisa cada modelo antes que você possa enviá-lo, geralmente em um prazo que vai de alguns minutos a um dia. Os modelos são necessários para iniciar uma conversa ou enviar uma mensagem a um cliente depois que a janela de 24 horas se fecha.
Por que minha mensagem do WhatsApp falhou depois de 24 horas?
A janela de atendimento ao cliente se fechou. Depois de 24 horas sem uma mensagem do cliente, só é possível enviar um modelo aprovado. Envie um modelo e a janela será reaberta quando o cliente responder.
O que é um agente de IA para WhatsApp?
Um agente de IA para WhatsApp é um software que lê as mensagens dos clientes no WhatsApp e responde com base no conteúdo da sua empresa. Ele também pode realizar ações, como agendar um horário ou consultar um pedido. Quando não deve responder sozinho, encaminha a conversa para uma pessoa.
Quanto custa conectar a IA ao WhatsApp?
Você paga à Meta por mensagem, de acordo com a categoria e o país. As primeiras 1.000 respostas de atendimento por número são gratuitas todos os meses. Também há custos de IA e da plataforma. O plano Business da Invent custa US$ 29 por mês e inclui US$ 29 em uso; depois, você paga conforme o uso, com respostas de IA a partir de US$ 0,003 por mensagem, dependendo do modelo. A Meta cobra suas tarifas separadamente.
