Como integrar WhatsApp Business API

A WhatsApp Business API (Cloud API da Meta) é o caminho oficial para atender e vender no WhatsApp em escala: número Business, templates aprovados, campanhas e estabilidade sem depender de um celular “logado”. O problema clássico é a integração — tokens, WABA, Phone Number ID, webhooks e assinatura HMAC.

Com a Atendente.AI, fabricada pela CX Software e atuando como Meta Tech Provider oficial, esse trabalho some do seu dia a dia. Em vez de montar a integração na mão, você conecta o número pelo fluxo oficial da Meta (Embedded Signup) e a plataforma cuida do restante.

O que é a WhatsApp Business API

A WhatsApp Business API (também chamada de Cloud API) é a interface oficial da Meta para empresas enviarem e receberem mensagens no WhatsApp com regras de negócio claras:

• número comercial vinculado a uma WhatsApp Business Account (WABA);
• envio fora da janela de 24 horas via templates aprovados pela Meta;
• webhooks para receber mensagens, status de entrega e leituras;
• escala e conformidade superiores ao uso do app WhatsApp Business no celular.

Não é o mesmo que escanear um QR Code (WhatsApp Web). A API é o canal indicado quando você precisa de templates, campanhas e um número Business oficial.

Por que integrar via um Meta Tech Provider

Um Meta Tech Provider é um parceiro tecnológico autorizado a oferecer o fluxo oficial de conexão (Embedded Signup) e a operar a Cloud API em nome dos clientes, com a infraestrutura já validada pela Meta.

Na prática, isso significa para o seu negócio:

1. Login oficial com a Meta — suas credenciais não passam pela Atendente.AI; a Meta autentica o Business e o número.
2. Sem colar token — Phone Number ID, WABA ID e tokens são descobertos e gravados automaticamente após o login.
3. Webhooks assinados sozinhos — a plataforma registra e assina os webhooks; você não configura URL nem X-Hub-Signature-256 no painel da Meta.
4. Produto completo em cima da API — inbox unificada, agente de IA, campanhas, lembretes de agenda e handoff humano já vêm prontos.

Como integrar WhatsApp Business API na Atendente.AI (passo a passo)

Pré-requisitos: conta Meta / Business capaz de criar ou usar WhatsApp Business; número disponível para a API; plano do workspace com WhatsApp API (a partir do Pro). Só dono e administrador do workspace conectam o canal.

1. No workspace, abra Canais → Adicionar canal e escolha WhatsApp API.
2. Informe o Nome do canal e clique em Continuar.
3. No passo Conectar WhatsApp API, clique em Continuar com o Facebook.
4. Na janela da Meta, conclua o cadastro ou a seleção do número de WhatsApp Business.
5. Em sucesso, a tela mostra Canal conectado! com o Número conectado. Clique em Concluir.

Pronto: o número aparece com Número, Phone Number ID e WABA ID. Se o token expirar ou a conexão cair, use Reconectar com a Meta — o mesmo fluxo, sem recomeçar do zero.

O que fica pronto depois da conexão

Capacidade	O que a Atendente.AI entrega
Inbox unificada	Conversas do WhatsApp API entram na mesma inbox de Instagram, Messenger, chat do site e Mercado Livre
Templates	Lista dos modelos do número (somente leitura); criação e aprovação no WhatsApp Manager da Meta
Campanhas	Disparos com templates aprovados, com créditos conforme o plano
Lembretes de agenda	Template de utilidade para confirmação de comparecimento fora da janela de 24h
Atendimento por IA	Agente treinado com a base do seu negócio, com Human Control quando precisar de pessoa
Estabilidade	Sem celular ligado 24h; infraestrutura Cloud API da Meta

WhatsApp API vs WhatsApp Web na Atendente.AI

Critério	WhatsApp API (Business API)	WhatsApp Web
Conexão	Login oficial com a Meta	QR Code no celular
Templates / campanhas	Sim	Não
Depende de aparelho	Não	Sim
Ideal para	Escala, marketing, lembretes e número Business oficial	Atendimento rápido com o número do celular
Plano típico	Pro ou Business	Disponível em planos iniciais

Se a meta é só atender rápido com o número pessoal ou do time, WhatsApp Web basta. Se a meta é integrar a WhatsApp Business API de verdade — templates, campanhas e conformidade — escolha o canal WhatsApp API na Atendente.AI.

Erros comuns ao integrar “na mão” (e como a plataforma evita)

• Colar token errado ou expirado — no Embedded Signup o token nasce no fluxo da Meta e a Atendente.AI o guarda sem você tocá-lo.
• Webhook sem assinatura — a Meta exige validação HMAC; a plataforma assina automaticamente ao conectar.
• WABA ou Phone Number ID trocados — descobertos no pós-login, sem planilha interna.
• Número já em uso no app comum — a Meta pode exigir migração; o fluxo oficial deixa isso explícito na janela dela.
• Login cancelado — feche a janela e use de novo Continuar com o Facebook.

Resumo: integrar WhatsApp Business API não precisa ser projeto de engenharia

Integrar a WhatsApp Business API costumava ser um projeto: app no Meta for Developers, tokens de longa duração, webhooks, templates e um CRM por cima. Com a Atendente.AI como Meta Tech Provider oficial, o caminho vira um fluxo de produto: login com a Meta, número conectado, inbox e IA prontas.

Se você quer a API oficial sem montar a integração do zero, comece em Canais → WhatsApp API na Atendente.AI.