Esta página também está emEN
iTeam
API · Comunicação, e-mail e agendaCom credencial da sua empresa

API do WhatsApp Business: o que dá para fazer e como usar com agentes de IA

A API do WhatsApp Business, oferecida pela Meta (Cloud API), permite que empresas enviem e recebam mensagens de forma programática em um número comercial. É usada por times de atendimento, vendas e cobrança que precisam escalar conversas. O acesso exige uma conta Meta Business verificada e um número registrado na plataforma.

Nina
O que a API do WhatsApp Business oferece

Os grandes recursos da API, em português claro.

RecursoMensagens

Envio e recebimento de texto, imagens, documentos, áudio, localização e mensagens interativas com botões e listas.

RecursoModelos de mensagem (templates)

Mensagens pré-aprovadas pela Meta, obrigatórias para iniciar conversa fora da janela de atendimento de 24 horas.

RecursoWebhooks

Notificações em tempo real de mensagens recebidas e de status de entrega e leitura.

RecursoMídia

Upload e download dos arquivos trocados nas conversas.

RecursoNúmeros e perfil comercial

Gestão dos números de telefone da conta e das informações do perfil exibidas ao cliente.

Acesso e autenticação

Como se acessa a API do WhatsApp Business.

  • Com credencial da sua empresaUsa token de acesso da Meta (token de usuário do sistema no Business Manager) vinculado a um app do Meta for Developers com permissões de WhatsApp Business.
  • Documentação oficialdevelopers.facebook.com/docs/whatsapp
  • Mensagens fora da janela de 24 horas exigem template aprovado, e a Meta cobra por conversa conforme a categoria.
  • A qualidade do número cai com bloqueios e denúncias; evite disparos para quem não pediu contato.
  • Conversas contêm dados pessoais: defina retenção e acesso de acordo com a LGPD.
Também buscado como
  • api whatsapp business
  • api oficial whatsapp
  • whatsapp cloud api
  • api do whatsapp business preço
  • integração api whatsapp
  • webhook whatsapp business
  • template whatsapp api
  • chatbot whatsapp api oficial
Agentes de IA usando a API

O que um agente do iTeam faz com a API do WhatsApp Business.

Caso de usoTriagem do atendimento de primeiro nível

O agente responde dúvidas frequentes sobre pedidos, prazos e políticas e passa a conversa para um atendente quando o cliente pede ou o assunto foge do roteiro, com o histórico resumido.

Caso de usoCobrança com template aprovado

O agente dispara lembretes de vencimento usando templates aprovados, envia a segunda via quando o cliente responde e registra a promessa de pagamento no financeiro.

Caso de usoConfirmação de agenda

Na véspera, o agente confirma visitas ou consultas, remarca dentro dos horários livres e avisa a equipe sobre faltas previstas.

Caso de usoQualificação de leads de campanha

Leads que chegam por anúncios de clique para WhatsApp recebem perguntas de qualificação e os qualificados vão para o CRM já com resumo para o vendedor.

Como conectar no iTeam

Da credencial ao agente trabalhando, com aprovação.

Passo 1

Prepare a conta na Meta

Verifique a empresa no Meta Business, registre o número na Cloud API e gere um token de usuário do sistema com as permissões de WhatsApp.

Passo 2

Cadastre no cofre do iTeam

O token e o ID do número ficam no cofre de credenciais do iTeam; você define quais agentes podem enviar mensagens e quais templates cada um usa.

Passo 3

Teste com aprovação humana

Nas primeiras semanas, mensagens ativas e respostas sensíveis passam por aprovação; o webhook é ligado para o agente receber as conversas em tempo real.

Perguntas frequentes

Dúvidas sobre a API do WhatsApp Business.

A API do WhatsApp Business é gratuita?

Não totalmente. O acesso à Cloud API não tem taxa de adesão, mas a Meta cobra por conversas ou mensagens conforme categoria e país, e as regras de cobrança mudam de tempos em tempos. Consulte a tabela vigente da Meta.

Preciso programar para usar a API do WhatsApp Business com o iTeam?

Não necessariamente. O iTeam já se conecta ao WhatsApp e o time de implantação configura número, templates e webhook com você; sua equipe só aprova regras e mensagens.

Posso usar meu número atual de WhatsApp Business?

Em geral sim, mas o número precisa ser migrado para a plataforma da API e deixa de funcionar no aplicativo comum enquanto estiver lá. Vale planejar a migração com o time de implantação.

O que uma empresa consegue fazer com a Cloud API do WhatsApp Business e um agente de IA?

A Cloud API da Meta permite enviar e receber mensagens, mídia e templates em um número comercial, e o agente usa isso para atender e cobrar. Ele recebe o texto do cliente por webhook, consulta pedido ou boleto e responde. Quando o assunto exige decisão, passa a conversa para uma pessoa. No iTeam o WhatsApp é um dos canais nativos, ligado a agentes com cargo.

Existe número de teste na API do WhatsApp Business antes de usar o número da empresa?

Sim: o painel do app na Meta for Developers entrega um número de teste que envia gratuitamente para um grupo pequeno de destinatários cadastrados. Cada destinatário precisa ser adicionado e confirmado em API Setup, e o envio inicial costuma usar o template hello_world. Templates criados no número de teste não migram sozinhos para o número de produção, então planeje recriá-los.

Como é feita a autenticação da API do WhatsApp Business para um agente?

A chamada leva um token de acesso da Meta; para produção, o indicado é o token de usuário do sistema criado no Business Manager. O token fica vinculado a um app do Meta for Developers com as permissões de WhatsApp Business. O token temporário do painel de testes expira rápido e serve só para experimentar, nunca para rodar o agente.

Por que o agente não consegue mandar mensagem livre ao cliente depois de um tempo na API do WhatsApp?

Porque a janela de atendimento de vinte e quatro horas fecha depois da última mensagem do cliente e, fora dela, só templates aprovados passam. O agente responde livremente enquanto a janela está aberta; depois disso precisa de um modelo aprovado pela Meta na categoria certa. Um aviso de pedido enviado, por exemplo, usa template, e a cobrança segue a categoria dele.

Quanto custa usar a API do WhatsApp Business com agentes de IA?

O acesso à Cloud API não tem mensalidade de licença na documentação da Meta, mas as mensagens com template são cobradas conforme a categoria. O custo muda com o volume, o país do destinatário e o tipo de mensagem, e a tabela é atualizada pela Meta, então confira a página de preços vigente. Custo de LLM do agente é outra conta, que o iTeam mostra por agente.

Posso usar o número de WhatsApp que a empresa já tem na API oficial?

Em geral sim, desde que o número seja registrado na plataforma e deixe de funcionar no aplicativo comum do mesmo jeito. Para registrar, a empresa precisa de conta Meta Business verificada e de acesso ao SMS ou ligação de confirmação. Confira na documentação oficial as regras de migração do número, porque o histórico de conversas do aplicativo não vem junto.

O que acontece com a qualidade do número se o agente disparar mensagens para quem não pediu?

Bloqueios e denúncias derrubam a classificação de qualidade do número, o que reduz os limites de envio e pode levar a restrições. Por isso o agente só deve falar com quem tem consentimento e oferecer a saída fácil. Campanhas frias são o caminho mais curto para perder o número. Um agente de SDR bem configurado responde a quem escreveu primeiro e segmenta o resto.

As conversas do WhatsApp Business via API entram na LGPD e quem deve ter acesso?

Entram, porque nome, telefone e o conteúdo das mensagens identificam pessoas. Defina quanto tempo guardar o histórico, quem lê conversas inteiras e o que o agente pode repetir a terceiros. Um agente de cobrança, por exemplo, não precisa enxergar o que o cliente disse ao financeiro. O iTeam permite limitar o acesso por papel e registra quem consultou cada conversa.

Mais APIs de Comunicação, e-mail e agenda

Outras APIs da categoria.

Próximo passo

Coloque um time de IA para trabalhar esta semana.

Comece grátis com um time pronto, ou fale com a gente e nosso squad coloca a IA em produção com o seu time.

300+integrações
4idiomas
Agentes trabalhando agora