Conectar a API Oficial: o caminho e os cinco tropeços conhecidos

Conectar a API Oficial do WhatsApp costuma dar uma de duas experiências: leva três minutos, ou leva três dias.

A diferença quase nunca está na plataforma. Está em três condições que ninguém conta antes — e em saber ler cinco mensagens de erro que a Meta escreve de um jeito que não ajuda.

Como funciona a conexão

Não há token para copiar e colar. Você clica em Conectar com Meta, autoriza a IAZIS na sua conta comercial, escolhe qual número vai ser conectado, e pronto.

É o caminho oficial da Meta, e é melhor que o antigo por um motivo prático: nenhuma credencial passa pela sua mão. Não há chave para vazar num documento compartilhado.

As três condições (leia antes de clicar)

Quase todo problema de conexão é uma destas três:

1. Abra no computador. Não no celular. A autorização da Meta tem etapas que não cabem numa tela pequena, e o fluxo trava no meio.

2. Use uma janela anônima. Esta é a mais importante e a menos óbvia. Quem tem várias contas do Facebook logadas — a pessoal, a da agência, a do cliente antigo — cai numa tela de escolha que não avança e não explica.

3. Esteja logado na conta que é administradora do portfólio empresarial. Ter "acesso aos ativos" não basta. É preciso ser administrador de verdade.

⚠️ A terceira é a que mais atrasa, porque descobrir isso costuma exigir falar com quem criou a conta comercial da empresa — às vezes uma agência que não trabalha mais com você.

Os cinco erros, e o que cada um significa

Esta é a lista que economiza a tarde. Na ordem em que vale checar:

1. "Recurso indisponível" ou "Login do Facebook indisponível" É um erro conhecido do lado da Meta, ligado às permissões básicas do seu perfil. Costuma resolver revogando o acesso do aplicativo na sua conta do Facebook e autorizando de novo. Às vezes só passa com o tempo.

2. Cai na tela de login e não avança Várias contas do Facebook logadas. Janela anônima.

3. Aparece "Criar portfólio" em vez do nome da sua empresa Você não é administrador da conta comercial. Não insista na tela — não vai passar. Resolva a permissão com quem administra e volte.

4. "URL bloqueada" É configuração do lado do aplicativo, não do seu. Fale com o suporte.

5. Nada disso Vale conferir se há algo em análise na sua conta comercial da Meta. Item "em análise" é esperar; item com "ação necessária" é resolver antes de tentar de novo.

O que aparece depois de conectado

Um número da API Oficial na IAZIS é um dispositivo como qualquer outro: cai na mesma Caixa de Entrada, com os mesmos filtros, ao lado dos números em WhatsApp Web e dos outros canais.

O que muda é o que aquele canal permite:

aparece o botão de modelo aprovado, para falar depois de 24 horas
não aparece a enquete — a API Oficial não tem
não aparece nada de grupo — a Meta não oferece grupos na API oficial

⚠️ A IAZIS mostra o que aquele canal aceita em vez de oferecer um botão que vai falhar no envio. Se algo que você usava no WhatsApp Web sumiu, não é bug: é o canal.

Antes de mover a operação inteira

Conectou não é o mesmo que estar pronto. Três coisas que valem fazer antes de migrar o volume:

1. Crie e aprove seus modelos. Sem modelo aprovado, você só consegue falar com quem falou com você nas últimas 24 horas. É a diferença entre um canal funcionando e um canal que parece quebrado.

2. Entenda a janela de 24 horas. É a regra que muda o dia a dia do atendente, e é onde nasce o não consigo responder esse cliente.

3. Faça a conta do custo. A API Oficial cobra por mensagem, e a régua muda em outubro de 2026. Vale simular com o seu volume real.

(Modelos, janela de 24 horas e custo têm artigos próprios.)

Um número não substitui o outro

Vale repetir porque muita gente conecta a API Oficial esperando abandonar o WhatsApp Web e descobre tarde que perdeu recurso.

Os dois convivem, e o arranjo mais comum é: oficial para o atendimento individual de volume, WhatsApp Web para os grupos. Na mesma Caixa de Entrada, com o atendente sem saber por qual canal a conversa chegou.

Quer conectar a API Oficial com acompanhamento? Fale com a gente.