Última atualização: novembro de 2026
Em resumo
- Ligar a IA à WhatsApp Business API envolve quatro tarefas, não apenas uma: associar o número, receber mensagens, enviar respostas de acordo com as regras da Meta e passar a conversa para uma pessoa quando a IA deve parar.
- Há três formas de o fazer: desenvolver a solução na Cloud API da Meta, deixar a ligação a cargo de um Business Solution Provider (BSP) 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 faz falhar a maioria das configurações. Enquanto está aberta, a IA pode responder livremente. Depois de fechar, só pode ser enviada uma mensagem com um modelo aprovado pela Meta.
- Um só número pode servir toda a equipa. A IA responde primeiro e o encaminhamento por IA envia a conversa para a pessoa certa numa caixa de entrada partilhada.
- Comprove que funciona com um pequeno projeto-piloto: um número, um caso de utilização e quatro testes antes de alargar a implementação.
Os seus clientes já lhe escrevem pelo WhatsApp. A questão é quem lhes responde às duas da manhã, ao domingo ou quando 300 pessoas perguntam «onde está a minha encomenda?» no mesmo dia. Um agente de IA ligado à WhatsApp Business API pode responder-lhes em segundos, com base nas suas políticas e no seu catálogo.
À primeira vista, parece uma tarefa única. Na prática, são quatro: associar um número de telefone, receber mensagens dos clientes, enviar respostas de acordo com as regras da Meta e decidir quando deve intervir uma pessoa. Se fizer tudo isto bem, os clientes recebem respostas rápidas e corretas. Se não, terá envios falhados, respostas duplicadas ou uma IA que continua a falar quando devia ter parado.
Este guia explica as três formas de fazer a ligação, o que cada uma exige da sua equipa e que verificações deve fazer antes de entrar em produção.
Como funciona um agente de IA na WhatsApp Business API
A WhatsApp Business API (a Meta chama-lhe agora WhatsApp Business Platform, e a versão alojada é a Cloud API) funciona como um canal de comunicação bidirecional. As mensagens recebidas chegam através de webhooks. As respostas são enviadas através de chamadas à API. A IA fica no meio e decide o que dizer.
Alguns termos que encontrará em qualquer configuração:
- WhatsApp Business Account (WABA): a conta onde ficam os seus números, modelos e definições.
- Webhook: a notificação que a Meta envia ao seu sistema quando chega uma mensagem ou o respetivo estado muda (enviada, entregue, lida).
- Modelo de mensagem: uma mensagem aprovada antecipadamente pela Meta, necessária para iniciar ou retomar uma conversa.
- Janela de atendimento ao cliente: as 24 horas após a última mensagem de um cliente, durante as quais pode responder livremente.
Em termos simples, o fluxo é o seguinte: um cliente escreve, a Meta envia a mensagem para o seu webhook, o seu sistema encaminha-a para a IA, a IA prepara uma resposta com base nos seus conteúdos e o seu sistema envia-a ao cliente. Se a IA não tiver a certeza ou o cliente pedir para falar com alguém, a conversa é encaminhada para a sua equipa.
A janela de 24 horas: a regra que não pode infringir
A janela de atendimento ao cliente da Meta é um período de 24 horas. Começa e reinicia sempre que o cliente lhe envia uma mensagem. Enquanto estiver aberta, a sua IA pode enviar respostas normais com texto, imagens, documentos ou botões. Depois de fechar, só um modelo aprovado pode chegar ao cliente.
Esta regra determina como a sua IA deve agir:
- Responda de imediato enquanto a janela estiver aberta. É aqui que um agente de IA compensa o investimento.
- Verifique a janela antes de cada envio. Se tiver fechado, a IA não pode improvisar uma mensagem de texto livre.
- Use um modelo para qualquer mensagem enviada mais tarde. Uma atualização de entrega no dia seguinte, um lembrete de marcação ou uma ligação de pagamento após 24 horas exigem um modelo aprovado da categoria correta: marketing, utilidade ou autenticação.
A Meta cobra cada mensagem de acordo com a categoria e o país do cliente, e envia a fatura diretamente. Desde 1 de outubro de 2026, cada número do WhatsApp recebe 1.000 mensagens de serviço gratuitas por mês: as respostas enviadas enquanto a janela está aberta. A partir da mensagem número 1.001, essas respostas também são cobradas; os modelos são sempre cobrados. Consulte a tabela de preços atual da Meta antes de planear os volumes. O nosso guia de modelos do WhatsApp explica o processo de aprovação e como reabrir a janela.
Forma 1: desenvolver a solução na Cloud API da Meta
Esta opção é adequada para equipas com programadores que querem controlar todos os componentes.
- Prepare os seus recursos da Meta. Precisa de um portefó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 associe o número. O fluxo Embedded Signup da Meta ou o painel de programador cria a conta e regista o número na Cloud API.
- Escolha como pretende transferir o número. Um número novo é a opção mais simples. Um número que já esteja na aplicação WhatsApp Business pode ser transferido para a API (e a aplicação deixa de funcionar nesse número) ou usar a coexistência, que permite usar a aplicação e a API com o mesmo número.
- Configure o webhook. Publique um URL de callback, passe a verificação do token da Meta e subscreva os eventos de mensagens e de estado.
- Proteja o token de acesso. Guarde-o num gestor de segredos, nunca em código de front-end.
- Desenvolva a etapa de IA. Envie cada mensagem para o seu modelo juntamente com os seus conteúdos, permita-lhe chamar funções (consultar uma encomenda, marcar um horário) e envie a resposta final através da Messages API.
- Trate dos casos excecionais. Os webhooks podem chegar duas vezes, por isso guarde o ID de cada mensagem e ignore as duplicadas. Tente novamente os envios falhados. Acompanhe a classificação de qualidade do número.
A vantagem é o controlo. O custo é que a sua equipa fica responsável pela disponibilidade, pelas novas tentativas, pela gestão de modelos, pela caixa de entrada usada pelos agentes e por todas as alterações que a Meta fizer à API.
Forma 2: deixar a ligação a cargo de um Business Solution Provider
Um Business Solution Provider (BSP) é uma empresa aprovada pela Meta para ligar as empresas à API. O BSP aloja os webhooks, envia as mensagens e, muitas vezes, gere os modelos. Troca algum controlo por rapidez e apoio, mas, normalmente, continua a ter de fornecer a IA.
Faça estas perguntas antes de assinar:
- Onde funciona a IA? Está integrada ou tem de ligar o seu próprio modelo através da API do fornecedor?
- Como é feita a cobrança? Por mensagem, por mês, por licença ou através de uma margem sobre as tarifas da Meta?
- O que acontece quando um envio falha? Pergunte como voltam a tentar enviar webhooks e mensagens.
- Quem gere os modelos e com que rapidez são corrigidos os modelos rejeitados?
- Pode mudar de fornecedor? Pergunte como poderá transferir o número para outro fornecedor mais tarde.
- Segurança: têm um relatório SOC 2, registos de auditoria e um compromisso de disponibilidade?
Uma boa lista de indicadores para avaliar o projeto-piloto com um BSP inclui: tempo até à primeira mensagem, taxa de entrega, número de conversas encaminhadas para uma pessoa e custo por conversa.
Forma 3: usar uma plataforma com o agente de IA integrado
A terceira opção dispensa a parte técnica da ligação. A plataforma liga o número, executa o agente de IA, gere os modelos e disponibiliza uma caixa de entrada para a sua equipa, tudo num só lugar.
Na Invent, associa o número através do Embedded Signup da Meta, dentro da aplicação. Funciona com um número novo, com um número transferido de outro fornecedor ou com um número que continua na aplicação WhatsApp Business através da coexistência. Os modelos são criados, enviados para aprovação e acompanhados no mesmo local, para que ninguém tenha de manter uma folha de cálculo com as aprovações.
O agente de IA responde com base no seu site, documentos e políticas. Quando deve parar, o encaminhamento por IA envia a conversa para a pessoa certa na caixa de entrada partilhada. O colega 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 equipa possa cobrir todos os canais.
Esta opção é adequada para equipas operacionais que pretendem respostas precisas e transferências simples, sem contratar engenheiros. Se precisar de lógica personalizada que nenhuma plataforma oferece, a Forma 1 dá-lhe mais flexibilidade.
Um número do WhatsApp, várias pessoas a responder
Uma pergunta frequente é se um só número do WhatsApp pode servir toda uma equipa. Com a API, pode. A aplicação WhatsApp Business limita o número de dispositivos associados. A API não tem limite de dispositivos: todas as mensagens chegam ao seu sistema, e a sua caixa de entrada decide quem responde.
É aqui que a IA e as pessoas dividem o trabalho:
- A IA responde primeiro, a qualquer hora, com base nos seus conteúdos.
- O encaminhamento por IA escolhe a pessoa certa quando a conversa exige discernimento, um reembolso, a gestão de uma reclamação ou uma venda que precisa de um toque humano.
- A sua equipa responde a partir do mesmo número, para que o cliente nunca veja a conversa ser transferida para outro contacto.
Com uma plataforma, isto funciona desde o primeiro dia. Se desenvolver a sua própria solução, precisa de uma caixa de entrada, regras de atribuição e uma forma de impedir a IA de responder quando uma pessoa assume a conversa.
Onde deve ocorrer a decisão da IA
A IA nunca deve enviar mensagens diretamente para o WhatsApp. O seu fluxo de processamento verifica a janela, escolhe o tipo de mensagem e faz o envio. A IA limita-se a decidir o que dizer ou que ação executar, como consultar uma encomenda, marcar uma consulta ou consultar uma política.
Mantenha estas três salvaguardas:
- Responda apenas com base nos seus conteúdos. Uma IA limitada aos seus documentos e ao seu site sabe reconhecer quando não sabe a resposta.
- Peça confirmação antes de movimentar dinheiro. Para reembolsos, pagamentos e marcações, peça ao cliente que confirme na conversa.
- Encaminhe a conversa quando se verificarem condições claras. A baixa confiança, os temas sensíveis, os clientes zangados e as decisões sobre políticas devem ser encaminhados para uma pessoa.
O que a sua equipa de segurança vai perguntar
Se o WhatsApp transportar dados de clientes, a sua análise de segurança abrangerá os mesmos pontos, independentemente da opção escolhida:
- Relatório SOC 2 Tipo II para clientes empresariais
- Início de sessão único com o seu fornecedor de identidade
- Registos de auditoria que indiquem quem fez o quê, e funções personalizadas para controlar quem pode ver cada conversa
- Controlos de despesas, para que um mês mais movimentado não apanhe a equipa financeira de surpresa
- Respostas claras sobre onde as conversas são armazenadas, durante quanto tempo e se são usadas para treinar algum modelo
Quanto custa: um exemplo prático
Os custos do WhatsApp resultam de duas faturas: as tarifas da Meta por mensagem e o custo da plataforma que executa o seu agente de IA. Veja como se somam os custos da Meta para uma loja.
Imagine uma loja online com um número do WhatsApp. Num mês, 3.000 clientes escrevem e o agente de IA envia cerca de duas respostas a cada um, num total de 6.000 respostas dentro de janelas abertas. A loja também envia 500 atualizações de encomendas no dia seguinte, já fora da janela.
- As primeiras 1.000 respostas são gratuitas. Cada número recebe 1.000 mensagens de serviço gratuitas por mês, e a contagem é reposta todos os meses.
- As outras 5.000 respostas são cobradas à tarifa de serviço da Meta para o país de cada cliente.
- As 500 atualizações de encomendas são modelos, cobrados à tarifa de utilidade da Meta para cada país.
- Entrada gratuita: quando um cliente lhe escreve a partir de um anúncio Click to WhatsApp, a maioria das mensagens é gratuita durante 7 dias.
As tarifas variam consoante 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 fatura da Meta, paga a IA e a plataforma. Respostas mais curtas e melhores reduzem ambas as faturas, mais uma razão para manter as respostas da IA concisas e corretas.
Erros comuns da WhatsApp API e como corrigi-los
A maioria dos envios falhados devolve um código de erro. Eis os primeiros que as equipas costumam encontrar e a solução indicada pela Meta para cada um:
- 131047, passaram 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. Verifique ambos na lista de modelos.
- 131026, mensagem não entregue: o número pode não usar o WhatsApp ou o cliente pode não ter aceite os termos mais recentes ou atualizado a aplicação.
- 131049, mensagem não entregue para manter o envolvimento saudável: a Meta limita o número de mensagens de marketing que uma pessoa recebe. Aguarde pelo menos 24 horas antes de tentar novamente.
- 131056, demasiadas mensagens para a mesma pessoa: enviou demasiadas mensagens a um cliente num curto espaço de tempo. Aguarde e tente novamente. Os outros clientes não são afetados.
- 130429, limite de frequência atingido: está a enviar mensagens demasiado depressa no total. Reduza o ritmo e tente novamente.
- 131042, problema com o método de pagamento: corrija o método de pagamento da sua WhatsApp Business Account na Meta.
- 368, conta restringida: a conta violou uma política do WhatsApp. Leia a notificação de aplicação das políticas da Meta antes de voltar a enviar mensagens.
Na Invent, o erro de uma mensagem falhada aparece junto à mensagem na conversa, para que a equipa perceba o que correu mal sem ter de consultar registos. Se desenvolver a sua própria solução, registe cada código com o ID da mensagem e alerte alguém quando aumentarem as falhas.
Faça um projeto-piloto antes de implementar em larga escala
Comece com um número do WhatsApp e um caso de utilização, como perguntas sobre encomendas ou marcação de consultas. Depois, faça quatro testes por esta 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.
- Primeira transferência chega à pessoa certa com a conversa completa.
- Primeiro envio de modelo é enviado depois de a janela fechar.
Durante duas semanas, acompanhe o tempo até à primeira resposta, o tempo de resolução, o CSAT, a taxa de transferência e o custo por conversa. Leia manualmente 50 conversas e avalie as respostas da IA e as decisões de transferência. Defina um plano para reverter a alteração: se algo não funcionar como esperado, pause a IA e encaminhe todas as conversas para a sua equipa.
Quanto aos custos, uma plataforma como a Invent custa a partir de $29 por mês, incluindo $29 de utilização no plano Business. À medida que cresce, paga à medida que utiliza, com respostas de IA a partir de $0,003 por mensagem, dependendo do modelo. As tarifas do WhatsApp da Meta são cobradas à parte, diretamente pela Meta. Existe um plano gratuito para experimentar.
Escolha a opção mais adequada à sua equipa
Escolha a opção 1 se tem engenheiros e quer controlar todas as camadas. Escolha a opção 2 se quer que um fornecedor trate da ligação e já tem uma solução de IA. Escolha a opção 3 se quer ter o agente de IA, os modelos e a caixa de entrada da equipa num só lugar.
Seja qual for a opção escolhida, ligue um número, faça um projeto-piloto, analise os resultados e, depois, expanda. Para um guia passo a passo sem código, leia como criar um chatbot de IA para o WhatsApp sem código.
Perguntas frequentes
Como posso ligar um assistente de IA à WhatsApp Business API?
Ligue o seu número à Cloud API da Meta, receba mensagens através de um webhook, encaminhe cada mensagem para a IA e envie a resposta dentro da janela de 24 horas. Uma plataforma como a Invent trata destes quatro passos por si através do Embedded Signup da Meta, sem código.
Que plataforma de API do WhatsApp tem IA integrada?
A Invent reúne a WhatsApp Business API, um agente de IA, modelos aprovados, encaminhamento com IA e uma caixa de entrada partilhada num só lugar. A maioria dos Business Solution Providers trata apenas da ligação, pelo que terá de adicionar a IA por sua conta.
Posso continuar a usar a aplicação WhatsApp Business com o mesmo número?
Sim, com a coexistência. A aplicação e a API partilham o mesmo número, pelo que pode continuar a responder a partir do telemóvel enquanto a IA trata do resto. Sem coexistência, a transferência de um número para a API desativa a aplicação nesse número.
Vários agentes podem responder a partir do mesmo número do WhatsApp?
Sim, através da API. Todas as mensagens chegam ao seu sistema e uma caixa de entrada partilhada permite que qualquer número de colegas responda a partir do mesmo número. A aplicação WhatsApp Business limita a utilização a alguns dispositivos associados.
Os modelos de mensagens do WhatsApp têm de ser aprovados?
Sim. A Meta analisa todos os modelos antes de permitir o seu envio, normalmente num 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 de fechar a janela de 24 horas.
Porque falhou a minha mensagem do WhatsApp depois de 24 horas?
A janela de atendimento ao cliente fechou. Depois de 24 horas sem receber uma mensagem do cliente, só pode enviar um modelo aprovado. Envie um modelo e a janela reabre quando o cliente responder.
O que é um agente de IA para o WhatsApp?
Um agente de IA para o WhatsApp é um software que lê as mensagens dos clientes no WhatsApp e responde com base nos conteúdos da sua empresa. Também pode executar ações, como marcar um agendamento ou consultar uma encomenda. Encaminha a conversa para uma pessoa quando não deve responder sozinho.
Quanto custa ligar a IA ao WhatsApp?
Paga à Meta por mensagem, de acordo com a categoria e o país; as primeiras 1.000 respostas de serviço por número são gratuitas todos os meses. Também paga pela IA e pela plataforma. O plano Business da Invent custa $29 por mês e inclui $29 de utilização; depois, paga à medida que utiliza, com respostas de IA a partir de $0,003 por mensagem, dependendo do modelo. As tarifas da Meta são cobradas separadamente.
