Ativar a API oficial do WhatsApp: o botão, e a escolha que ele esconde

Quem procura "como ativar a API oficial do WhatsApp" encontra sempre a mesma resposta: um projeto. Verificar o CNPJ no Business Manager, criar um app na Meta, pedir acesso avançado, configurar webhook com certificado válido, guardar App Secret e token de longa duração, submeter templates. Os prazos que circulam vão de cinco dias a dois meses.

Essa descrição está correta para quem vai direto à Meta. Ela deixa de valer quando a ativação passa por um provedor que já fez esse caminho — e é por isso que vale entender onde exatamente o trabalho foi parar.

Por que normalmente é um projeto

A Meta não conversa com a sua empresa diretamente na primeira vez. Ela conversa com um aplicativo. Alguém precisa criar esse aplicativo, provar que a empresa existe, pedir permissão para enviar mensagens em nome dela e manter as credenciais em algum lugar seguro.

Feito por conta própria, isso significa preencher cerca de nove campos técnicos que não querem dizer nada para quem vende: Business Account ID, Phone Number ID, App ID, App Secret, token de acesso, Verify Token. Nenhum deles é difícil sozinho. Juntos, são o suficiente para a ativação virar tarefa de TI — e para o projeto atrasar porque a pessoa que entende de Meta não é a pessoa que atende o cliente.

O caminho alternativo é o provedor já ser aprovado pela Meta como Tech Provider. Aí o aplicativo já existe, a verificação já foi feita e a permissão já foi concedida. É o nosso caso: a aprovação está no nome da Sapienza, a casa que mantém o Dominus.OS. O que sobra para o cliente é vincular a própria conta.

Na prática, é um botão — e um popup da Meta

Na tela de canais, a conexão de WhatsApp começa em "Integrar via Facebook". O clique abre um popup da própria Meta, não uma tela nossa: você entra com a conta do Facebook que administra o negócio, escolhe ou cria a conta WhatsApp Business e confirma o número. O popup fecha e a conexão aparece na lista.

O que você não faz nesse caminho: não cria aplicativo, não copia App Secret, não gera token, não cola Verify Token em painel de webhook. Esses campos continuam existindo no produto, para quem já tem estrutura própria na Meta e prefere trazê-la, mas deixaram de ser o caminho padrão.

Vale um aviso honesto sobre prazo: o botão resolve a parte técnica, não a burocrática. Se o seu CNPJ ainda não passou pela verificação de empresa da Meta, esse é um processo dela, com análise de documentos, e leva o tempo que leva. Nenhum provedor encurta isso.

A pergunta que decide tudo: o número já está no aplicativo?

Aqui está a parte que quase nenhum guia conta, e que é onde a ativação de verdade trava.

O número que a empresa quer conectar quase sempre é o que ela já usa no aplicativo WhatsApp Business. Quando isso acontece, a Meta recusa a vinculação com um erro específico — o #2655122, "esse número já está registrado em uma conta do WhatsApp". No fluxo tradicional existe um único destrave: apagar a conta do aparelho.

Apagar significa exatamente o que parece. O número para de funcionar no aplicativo, o histórico guardado naquele celular se perde e não há como voltar atrás. É uma decisão irreversível tomada no meio de um popup, por alguém que só queria conectar o WhatsApp.

Por isso a nossa tela não escolhe sozinha. Quando há mais de um caminho possível, ela mostra os dois lado a lado, com o que cada um custa escrito antes do clique.

Coexistência ou migração: o que cada uma cobra

A coexistência é o caminho que evita a perda. Em vez de verificar por SMS, você lê um QR code com o próprio aplicativo, e o número passa a funcionar nos dois lugares ao mesmo tempo: o atendimento continua no celular e também entra no sistema. Nada é apagado.

O preço dela são limites que a Meta impõe a números em coexistência, e é melhor conhecê-los antes:

• A capacidade de envio fica fixa em vinte mensagens por segundo — números só na API escalam mais do que isso.
• Grupos, chamadas de voz e vídeo e Canais não passam pela API.
• As ferramentas de marketing e a edição do perfil comercial continuam só no aplicativo do celular.
• Listas de transmissão ficam somente leitura, e recursos como mensagens temporárias e visualização única são desativados.

A migração clássica não tem nenhum desses limites, e é o caminho certo para quem vai operar em escala. Em troca, ela cobra o que já dissemos: a conta no aplicativo é apagada, o histórico do celular se perde e o atendimento passa a acontecer inteiramente no sistema.

Não existe resposta universal. Uma equipe de dois atendentes que usa grupos todo dia provavelmente quer coexistência. Uma operação com fila, vários turnos e volume alto quer a migração, e quer logo — porque os limites da coexistência vão aparecer no pior momento, que é quando o movimento cresce.

Depois que o número conecta

Conectar não é terminar. Duas coisas costumam surpreender na primeira semana.

A primeira são os templates. Fora da janela de vinte e quatro horas desde a última mensagem do cliente, a Meta só permite enviar texto aprovado por ela previamente. Isso muda como a equipe trabalha: mensagens de cobrança, confirmação e lembrete precisam ser cadastradas e aprovadas antes, não escritas na hora.

A segunda é o limite inicial de envio. Número novo começa com um teto baixo de conversas iniciadas por dia, que sobe conforme a qualidade do número se mantém boa. Quem planeja uma campanha grande para a semana seguinte à ativação costuma descobrir isso tarde.

O que muda no dia a dia é o que já vale para qualquer canal que entra pela porta certa: a conversa cai numa fila com dono, o prazo de primeira resposta fica visível antes de virar reclamação e cada atendimento carrega protocolo com autor e horário. O número deixa de ser de uma pessoa e passa a ser da empresa — que é a razão de fazer tudo isso.

Quando não vale a pena

Se a empresa atende poucos clientes por semana, uma pessoa dá conta e ninguém entra ou sai da equipe, a API oficial é custo sem retorno: há mensalidade, há tarifa por conversa e há a disciplina dos templates. O aplicativo resolve.

A conta vira favorável quando existe mais de um atendente no mesmo número, quando a saída de alguém levaria o histórico junto, ou quando é preciso provar o que foi combinado. A Sapienza tratou desse ponto — por que o WhatsApp virou o canal principal e o que isso exige de quem atende — em um artigo sobre o canal preferido do cliente brasileiro.

Do nosso lado, o objetivo da ativação é sempre o mesmo do ciclo inteiro numa base só: a conversa que começou no WhatsApp continua sendo a mesma conversa quando virar proposta e quando virar cobrança. É para isso que o Dominus.CRM trata o canal como porta de entrada, e não como caixa separada.