O Connect.ai possui integração nativa com a API Oficial do WhatsApp (WABA), mantida e homologada pela Meta. O Connect.ai é um Tech Provider certificado pela Meta, o que permite que assinantes conectem números de WhatsApp Business por meio do aplicativo da Connect.ai, sem necessidade de criar um App próprio.
Para quem já possui um App aprovado no Facebook Developers, o Connect.ai também oferece suporte à integração via App próprio.
Atenção
Custos da API Oficial: os custos de uso da API Oficial (cobranças por conversas fora da janela de 24 horas) são faturados diretamente pela Meta na Business Manager (BM) do número conectado. O pagamento dessas taxas é responsabilidade do assinante. O Connect.ai cobra exclusivamente a licença do software. Veja mais em Cobranças da Meta.
Dica
Risco de bloqueio: o uso da API Oficial elimina o risco de banimento por uso de software não autorizado. No entanto, o número ainda está sujeito às avaliações de qualidade da Meta — bloqueios por envio de spam ou violação das políticas de mensageria são de responsabilidade do operador, independentemente da ferramenta utilizada. Siga sempre as diretrizes da Meta.
Como o Connect.ai conecta na API Oficial
Ao conectar pela API Oficial, o número passa a operar em modo de coexistência: funciona simultaneamente no aplicativo WhatsApp Business do celular e no painel do Connect.ai. A conexão utiliza a arquitetura de "Dispositivos Conectados" da Meta — o processo inclui leitura de QR Code no celular, de forma semelhante ao WhatsApp Web.
Há duas opções de integração disponíveis:
Opção 1 — Via App Connect.ai (usando o App da Connect.ai como Tech Provider)
O Connect.ai disponibiliza seu próprio App (aprovado como Tech Provider na Meta) para que assinantes façam a conexão OAuth diretamente pelo painel, sem precisar de um App próprio.
Como funciona:
- No painel, acesse Canais → Adicionar Canal → WhatsApp OAuth
- Selecione o aplicativo da Connect.ai
- Faça login com o Facebook, selecione a conta WhatsApp Business e escaneie o QR Code no celular
- O número fica conectado em modo de coexistência
Dica
Ao conectar pelo App da Connect.ai, a permissão de ligações de voz (
calls) já está aprovada automaticamente.
Atenção
Tutorial completo: WhatsApp Oficial OAuth (login)
Opção 2 — Via App Próprio (para quem já tem um App aprovado na Meta)
Assinantes que já possuem um App aprovado no Facebook Developers — ou que desejam criar um — podem integrar o Connect.ai usando as próprias credenciais. Nesse caso, o login incorporado exibe a marca do assinante (não a Connect.ai) para os usuários finais.
O que é necessário:
- App criado e aprovado no Facebook Developers com status de Tech Provider
Atenção
O processo de App Review da Meta exige envio de documentos e vídeos demonstrativos. O suporte do Connect.ai não realiza esse processo, mas pode indicar profissionais especializados.
Tutorial completo: Cadastro Incorporado e Coexistência com App Próprio
Vocabulário essencial
| Termo | O que significa |
|---|---|
| WABA | WhatsApp Business API — a API Oficial mantida e homologada pela Meta |
| Tech Provider | Empresa certificada pela Meta para fornecer soluções WABA a terceiros. O Connect.ai tem esse status |
| OAuth / Cadastro Incorporado | Tecnologia de conexão via login do Facebook — vincula o número ao sistema sem configuração manual de webhooks |
| Coexistência | O número funciona simultaneamente no app do celular e no painel do Connect.ai |
| Business Manager (BM) | Painel da Meta onde a empresa gerencia contas, ativos e métodos de pagamento |
| Template (HSM) | Mensagem pré-aprovada pela Meta para iniciar conversas fora da janela de 24 horas |
Dica
APIs não oficiais também são suportadas. O Connect.ai permite conexão via QR Code por APIs não oficiais (Baileys, Evolution API, Z-API, entre outras). Cada modalidade tem características e riscos distintos. Veja: API Oficial vs. APIs Não Oficiais
Documentação por área
Conectar e gerenciar o canal
- WhatsApp Oficial OAuth (login com coexistência): passo a passo para conectar um número em modo de coexistência usando o App da Connect.ai
- Integrações Meta — configurações do canal: painel de configurações do canal após a conexão: webhook, roteamento de chamadas, número de teste e outras opções
- Contas WhatsApp na Meta — visualização e gestão dos números WABA vinculados à Business Manager
Templates e disparos
- Gerenciar Templates HSM — criação, edição e aprovação de templates de mensagem na Meta diretamente pelo painel
- Envio em Massa — Template API Oficial — disparo em massa usando um template fixo para uma lista de contatos
- Envio em Massa — Template com Variáveis — disparo em massa com preenchimento dinâmico de variáveis do template por contato
Atendimento com canal WABA
- Painel de atendimento — recursos exclusivos WABA — funcionalidades disponíveis na tela de atendimento para canais API Oficial: reações, edição de mensagens, templates e ligações
Ligações de voz
- Ligações de voz na API Oficial (WABA) — como ativar o recebimento de chamadas WebRTC, solicitar permissão de chamada para ligar, e configurar o roteamento entre atendentes
Rastreamento e integrações avançadas
- Rastreamento de Conversões (Meta Pixel) — integração com o Meta Pixel para rastrear eventos de conversão originados em atendimentos via WABA
- Exemplo de fluxo N8N + API Connect.ai + WABA — exemplo prático de automação integrando N8N com a API do Connect.ai em canais WABA
Cobrança da Meta
- Como funciona a cobrança de mensagens na Meta — modelo de precificação por categorias de conversa, janela de 24 horas e como gerenciar o faturamento na Business Manager
Perguntas frequentes
O Connect.ai cobra taxa por mensagem na API Oficial? Não. O Connect.ai cobra a licença do software. Os custos de uso do WhatsApp são faturados pela Meta diretamente na Business Manager do número conectado.
A API Oficial elimina completamente o risco de bloqueio? Elimina bloqueios por uso de software não autorizado. O número permanece sujeito às avaliações de qualidade da Meta: spam, violação de políticas e acúmulo de denúncias podem resultar em penalidades — independentemente da API utilizada.
Posso manter o celular ativo e usar o Connect.ai ao mesmo tempo? Sim. O modo de coexistência permite que o número opere simultaneamente no app WhatsApp Business e no painel do Connect.ai.