Como configurar a API do WhatsApp Business: passo a passo

Este guia é para o responsável de marketing, CX ou TI que precisa colocar a empresa no ar na WhatsApp Business API. Ele percorre cada etapa do onboarding em ordem, explica o que a Meta verifica em cada fase e termina com um checklist de go-live e os erros mais comuns entre as equipes.

O que você precisa antes de começar?

Tenha quatro itens à mão: acesso de administrador ao portfólio empresarial da sua empresa na Meta, seus documentos comerciais, um número de telefone exclusivo e um nome de marca que os clientes reconheçam. A maioria dos atrasos acontece por falta de um deles.

Como configurar a WhatsApp Business API passo a passo?

Siga as etapas nesta ordem. Se você faz o onboarding por um provedor, as etapas 3 a 6 normalmente acontecem dentro do fluxo de Embedded Signup dele.

Etapa 1: prepare seu portfólio empresarial da Meta

Entre no Meta Business Suite com uma conta pessoal do Facebook que seja administradora do portfólio empresarial da empresa, ou crie um portfólio. Use exatamente a razão social e o endereço que constam nos seus documentos. Adicione pelo menos dois administradores para não perder o acesso se uma pessoa sair da empresa.

Etapa 2: inicie a verificação da empresa

Na Central de Segurança do portfólio empresarial, inicie a verificação da empresa. A Meta pede documentos que confirmem a razão social, o endereço e o telefone ou e-mail, e pode verificar por meio de um código ou de uma checagem de domínio. Os requisitos variam por país e mudam com o tempo; siga as instruções na tela.

Você pode iniciar o onboarding antes de a verificação ser concluída, mas até lá a Meta aplica limites menores: segundo a documentação da Meta, novos portfólios começam com dois números de telefone registrados e um limite de mensagens de 250 usuários únicos fora da janela de atendimento ao cliente.

Etapa 3: escolha o número de telefone

Escolha um número que permaneça com a empresa por anos, como uma linha fixa ou uma linha móvel exclusiva. A Meta exige que o número:

• seja de sua propriedade e inclua código do país e da área;
• possa receber SMS ou chamada de voz para verificação;
• não seja um short code;
• não esteja registrado no WhatsApp no momento, a menos que você use a opção de coexistência da Meta para um número elegível do WhatsApp Business App.

Se o número está no WhatsApp ou no WhatsApp Business App e você não quer a coexistência, faça backup do que precisar e exclua a conta no aplicativo primeiro.

Etapa 4: escolha o nome de exibição

O nome de exibição aparece no seu perfil do WhatsApp. Use o nome da marca que os clientes conhecem, de forma consistente com seu site e seus documentos comerciais. Evite nomes genéricos ("Melhores Ofertas"), maiúsculas incomuns ou slogans anexados. A Meta analisa o nome; o status aparece como pendente, aprovado ou recusado no WhatsApp Manager.

Etapa 5: conecte-se pelo Embedded Signup

O Embedded Signup é o fluxo da Meta que os provedores incorporam às suas plataformas. Você entra com o Facebook, seleciona ou cria o portfólio empresarial, cria ou seleciona uma conta do WhatsApp Business, informa o número de telefone e o nome de exibição e verifica o número com um código por SMS ou chamada de voz. Ao final, o provedor recebe permissão para gerenciar o WABA em seu nome, enquanto o seu portfólio mantém a propriedade.

Etapa 6: registre o número e defina o PIN de duas etapas

O número precisa ser registrado na Cloud API com um PIN de verificação em duas etapas de seis dígitos. Seu provedor normalmente faz isso como parte do onboarding. Guarde o PIN com segurança: ele será necessário para alterá-lo ou para excluir o número depois.

Etapa 7: adicione uma forma de pagamento

A Meta cobra por mensagem de modelo entregue, por categoria e país do destinatário. Adicione um cartão ao WABA no WhatsApp Manager ou confirme que a linha de crédito do seu provedor cobre a sua conta. Sem cobrança válida, os envios de modelos falham.

Etapa 8: crie seus primeiros modelos

Fora da janela de atendimento ao cliente de 24 horas, você só pode enviar modelos aprovados. Comece com três a cinco de que precisará no primeiro dia:

1. Um modelo de utilidade (utility) para confirmação de pedido ou reserva.
2. Um modelo de utilidade para atualização de status, como entrega ou lembrete.
3. Um modelo de autenticação, se você envia senhas de uso único.
4. Um modelo de marketing para sua primeira campanha com contatos que deram opt-in.

Use variáveis para nomes e números de pedido, mantenha linguagem promocional fora dos modelos de utilidade e crie versões em árabe e em inglês como idiomas separados do mesmo modelo, se você atende clientes na região do GCC.

Exemplo prático: um instituto de treinamento de Doha entra no ar

A "Al Fanar Academy" (um exemplo fictício) quer usar o WhatsApp para consultas sobre cursos e lembretes de aulas.

• Semana 1: O gerente de operações confirma o acesso de administrador ao portfólio empresarial, envia o registro comercial e inicia a verificação. A academia escolhe sua linha fixa principal, que pode receber uma chamada de voz.
• Onboarding: Pelo Embedded Signup do provedor, ela cria um WABA, informa o nome de exibição "Al Fanar Academy" e verifica o número por chamada de voz.
• Modelos: Ela envia um lembrete de aula (utilidade), uma confirmação de matrícula (utilidade) e um anúncio do novo período (marketing) em árabe e inglês. O modelo de marketing é recusado por uma chamada para ação vaga e aprovado após uma reescrita.
• Go-live: Ela envia lembretes aos alunos que deram opt-in no formulário de matrícula e encaminha as respostas para a caixa de entrada da equipe de admissões.

A etapa mais longa foi a verificação, não a configuração técnica.

Checklist de go-live

Marque todos os itens antes da primeira campanha.

1. Verificação da empresa enviada ou aprovada.
2. Nome de exibição aprovado.
3. Número de telefone registrado e PIN de duas etapas guardado com segurança.
4. Forma de pagamento válida e com saldo.
5. Modelos necessários aprovados em todos os idiomas de que você precisa.
6. Opt-in registrado para cada contato que você vai contatar.
7. Caixa de entrada configurada, com atendentes designados para responder às mensagens recebidas.
8. Mensagens de teste enviadas a números internos e conferidas em Android e iOS.
9. Relatórios de entrega dos envios de teste revisados.
10. Volume de envio planejado dentro do seu limite de mensagens atual.

Quais são os erros de configuração mais comuns?

A maioria dos erros se enquadra em poucos padrões. A documentação de códigos de erro da Meta os lista; estes são os que as equipes de onboarding mais encontram.

Outros problemas frequentes não são códigos de erro: um número ainda ativo no aplicativo WhatsApp, um nome de exibição que não corresponde ao site e administradores sem controle total do portfólio.

Como a OmniChannels.ai ajuda

A OmniChannels.ai, com tecnologia da BroadNet Technologies, faz o onboarding de números da WhatsApp Business API pelo Meta Embedded Signup, de modo que o seu portfólio empresarial mantém a propriedade do WABA. Você pode criar modelos de marketing, utilidade e autenticação, incluindo OTP one-tap, zero-tap e copy-code, com variáveis, mídia e botões, conferi-los em uma pré-visualização no celular e acompanhar a aprovação. Depois de entrar no ar, as campanhas oferecem upload de Excel/CSV, pré-visualização, agendamento e filtro de duplicidades, com relatórios de entrega para cada envio. Árabe e inglês são suportados. Veja a página da WhatsApp Business API e as campanhas, ou agende uma demonstração.