Configuração de conta da API do WhatsApp Business: cadastro, verificação e checklist do número
TL;DRA configuração de uma conta da API do WhatsApp Business fica mais simples quando você a trata como um lançamento operacional, não como um formulário a preencher. Conta, verificação da empresa, WhatsApp Business Account, número, modelos, consentimentos e primeira automação precisam funcionar juntos.
Para uma equipe de ecommerce, o objetivo não é apenas fazer uma mensagem de teste aparecer. É lançar um número comercial confiável, capaz de enviar a mensagem certa da Shopify, parar no momento correto, encaminhar respostas e gerar um resultado mensurável.
Este checklist vai da preparação da conta até um primeiro fluxo testado, sem transformar o processo em um guia exclusivo para desenvolvedores.
Primeiro, confirme se você precisa da conta da API
O aplicativo WhatsApp Business e a Plataforma do WhatsApp Business atendem a necessidades diferentes. O aplicativo é útil para conversas manuais individuais, perfil simples, respostas rápidas e equipes pequenas. A plataforma, muitas vezes chamada de API do WhatsApp Business, foi criada para mensagens programáticas, integrações, modelos, automação e escala.
Escolha uma configuração com API quando sua loja precisar de uma ou mais destas funções:
Mensagens acionadas pela Shopify, como recuperação de checkout abandonado, confirmação de pagamento na entrega, atualizações de pedido, solicitação de avaliação ou reativação.
Mensagens iniciadas pela empresa usando modelos aprovados.
Fluxo compartilhado para respostas e contexto do cliente.
Eventos de entrega, controles de automação ou relatórios de receita.
Provedor, plataforma ou aplicativo conectado à mesma identidade comercial do WhatsApp.
Se você precisa apenas de um link de conversa e uma pessoa responderá manualmente, o aplicativo Business pode bastar. Se eventos da loja precisam acionar mensagens consistentes, comece a planejar a conta da API.
Configuração da API do WhatsApp Business em resumo
O processo tem cinco etapas práticas.
| Etapa | O que preparar ou concluir | Verificação de saída |
|---|---|---|
| Preparar | Responsável, dados da empresa, site, caso de uso e plano do número | Uma pessoa lidera e todos os dados estão consistentes |
| Cadastrar | Portfólio empresarial da Meta, WABA, perfil e conexão com provedor ou app | WABA e número permanecem na empresa correta |
| Verificar | Identidade, propriedade do número, nome de exibição e verificação em duas etapas | A conta pode sair dos testes temporários com segurança |
| Testar | Modelo, opt-in, contato de teste, evento Shopify, rota de resposta e regra de parada | Um teste completo funciona sem correção manual |
| Lançar | Primeiro fluxo, público, horário, alternativa e métrica | A equipe reconhece sucesso e falha |
Não comece criando ativos nas contas da Meta de vários funcionários. Defina primeiro a propriedade. Recuperação de conta e troca de fornecedor ficam mais difíceis quando a empresa não controla portfólio, WABA, número ou acesso administrativo.
O que preparar antes do cadastro
Reúna os itens abaixo antes de abrir o assistente de integração.
| Requisito | O que ter pronto | Erro comum |
|---|---|---|
| Acesso à Meta | Proprietário ou funcionário real com controle total do portfólio correto | Deixar um funcionário da agência como único administrador |
| Identidade legal | Razão social, endereço, telefone e documentos de apoio | Informar a marca quando os registros usam outra entidade |
| Presença pública | Site funcional com marca, contato e, se possível, email do domínio | Enviar site provisório ou dados conflitantes |
| Identidade no WhatsApp | Nome de exibição, categoria, descrição, logo, site e suporte | Escolher um nome sem relação clara com a marca |
| Caminho do número | Número novo, migração ou coexistência elegível | Presumir que qualquer número ativo pode ser reutilizado sem mudanças |
| Primeiro caso de uso | Um fluxo com público, gatilho, tempo, texto, responsável e métrica | Solicitar a API sem saber o que será enviado primeiro |
| Consentimento | Onde o opt-in é coletado e como o opt-out é registrado | Tratar qualquer telefone no checkout como consentimento de marketing |
| Forma de configuração | Cloud API direta, plataforma ampla ou app Shopify | Escolher fornecedor antes de definir quem controla os fluxos |
Mantenha nome e endereço consistentes no site, no portfólio da Meta e nos documentos. Pequenas diferenças, como endereço antigo, abreviação ou sufixo jurídico ausente, podem criar revisões desnecessárias.
Entenda a estrutura da conta
Três elementos aparecem durante o cadastro:
O portfólio empresarial da Meta possui e gerencia ativos e permissões.
A conta do WhatsApp Business, ou WABA, contém números, modelos, Flows e ativos relacionados.
O número comercial é o remetente que o cliente vê e fica registrado na WABA.
Seu provedor ou aplicativo Shopify pode orientar a configuração pelo cadastro incorporado da Meta, mas essa ajuda não deve ocultar a propriedade. Confirme qual empresa possui a WABA, quem tem acesso administrativo e o que acontece com número e modelos se você trocar de software.
O provedor é a camada operacional. Identidade e número devem continuar sendo ativos duráveis da empresa.
Etapa 1: escolha configuração direta, plataforma ou aplicativo
O caminho escolhido define quem cuidará do trabalho técnico depois do cadastro.
| Caminho | Melhor opção para | Sua equipe continua responsável por |
|---|---|---|
| Cloud API direta | Equipes técnicas criando infraestrutura própria | App, tokens, webhooks, novas tentativas, modelos, sincronização, segurança e relatórios |
| Plataforma ampla de WhatsApp | Equipes combinando marketing, vendas, suporte, campanhas e caixa de entrada | Configuração, processos de agentes, governança de contatos, adicionais e fluxos |
| App de automação Shopify | Lojas focadas em fluxos de retenção prontos para lançar | Escolha do fluxo, consentimento, aprovação, tempo, respostas e desempenho |
O acesso direto funciona quando você precisa de infraestrutura personalizada e desenvolvedores para mantê-la. Uma plataforma ampla ajuda quando o WhatsApp é usado por vários departamentos. Um app Shopify costuma ser o caminho mais simples quando eventos da loja e retenção são o principal objetivo.
Veja também Solução para API do WhatsApp Business: BSP, plataforma ou app de automação?.
Etapa 2: crie ou selecione o portfólio empresarial correto
Use o portfólio que deve possuir os ativos do WhatsApp no longo prazo. Dê controle total a pelo menos dois administradores internos confiáveis.
Antes de continuar, confira:
Razão social, endereço, site e contato estão corretos.
O site conecta claramente a marca pública à empresa.
Apenas pessoas e parceiros necessários têm acesso.
Administradores usam autenticação de dois fatores.
Quem lidera o cadastro consegue concluir os desafios de segurança.
Se uma agência ou provedor ajudar, conceda acesso como parceiro ou ao ativo adequado, sem transferir toda a identidade empresarial para uma conta externa.
Etapa 3: crie ou selecione a WABA e o perfil comercial
O cadastro incorporado ou direto pedirá para criar ou conectar uma WABA. Escolha um nome claro para a equipe e complete o perfil comercial.
Prepare um nome de exibição que os clientes já associem à loja. Ele deve ter relação clara com a marca mostrada no site e nos registros. Prepare também categoria, descrição, site, email de suporte e logotipo.
Não confunda três verificações diferentes:
A verificação da empresa confirma que o portfólio pertence a uma organização legítima.
A verificação do telefone confirma o controle do número por SMS ou ligação.
Meta Verified ou selo oficial é um programa separado de confiança ou assinatura; não equivale ao cadastro básico na API.
Trate-os como processos distintos. Comprar um selo não substitui propriedade clara, registro do telefone, conformidade com políticas nem automação funcional.
Etapa 4: conclua a verificação da empresa
A Meta pode pedir confirmação da organização jurídica, endereço, telefone, domínio ou vínculo com a empresa. O método varia conforme conta e mercado.
Prepare documentos atuais e legíveis que correspondam aos dados informados. Dependendo da empresa, podem ser certificado de registro, documento fiscal, licença, documento bancário ou conta de serviço. Envie somente o que o fluxo ativo solicitar.
Checklist de verificação:
Faça o nome legal coincidir caractere por caractere sempre que possível.
Use o endereço registrado atual.
Garanta que documentos estejam completos, legíveis, válidos e sem alterações.
Use email ou domínio controlado pela empresa quando disponível.
Registre quem enviou a verificação e onde chegarão as respostas.
Não envie variações repetidas enquanto houver revisão ativa.
Alguns recursos de teste podem aparecer antes da verificação completa, mas um plano de produção não deve depender de um estado temporário ou restrito. Conclua cedo para que isso não vire o último bloqueio do lançamento.
Etapa 5: escolha com cuidado o caminho do número
O número é a decisão com maior chance de retrabalho.
| Caminho | Quando faz sentido | O que verificar primeiro |
|---|---|---|
| Número novo dedicado | Você quer a configuração API mais limpa | Recebe SMS ou ligações e não está vinculado a uma conta indesejada |
| Migrar número existente | Clientes já conhecem o número e continuidade importa | Requisitos, indisponibilidade, histórico, backups e etapas do provedor |
| Coexistência elegível | Você quer manter o app Business e adicionar a plataforma | Disponibilidade para conta, região, provedor e versão do app |
Não divulgue um número novo antes de ele ficar estável, mas também não deixe a decisão de migração para o dia do cadastro. Se houver URA, telefone fixo, encaminhamento ou serviço virtual, confirme que o código chegará a uma pessoa.
Antes de solicitar o código:
Confirme número internacional e código do país.
Pause sistemas que possam interceptar SMS ou ligação.
Garanta que alguém possa responder imediatamente.
Documente se a conta antiga será migrada, removida ou mantida por coexistência.
Decida como as respostas serão atendidas depois da mudança.
Deixe o fluxo atual da Meta e do provedor determinar a elegibilidade. Não dependa de guias antigos que mandam excluir toda conta ativa nem presuma que todas podem coexistir.
Etapa 6: verifique a propriedade e proteja o cadastro
A Meta verifica o número por código SMS ou de voz. Implementações diretas também registram o número e definem um PIN de seis dígitos. Mesmo que o provedor cuide das chamadas técnicas, a empresa deve guardar PIN e dados de recuperação.
Depois da verificação:
Guarde o PIN no gerenciador de senhas da empresa.
Registre o ID da WABA e o ID do número, se disponíveis.
Confirme que pelo menos dois administradores internos acessam as configurações.
Remova acessos temporários desnecessários.
Anote qualquer prazo para concluir o registro.
Nunca coloque tokens, códigos ou PIN em documentos do projeto ou chats compartilhados.
Etapa 7: prepare modelos, opt-in e responsabilidade pelas respostas
Cadastro não significa prontidão para lançamento. Mensagens iniciadas pela empresa exigem modelos, e o cliente deve ter concordado em receber a comunicação no WhatsApp.
| Controle | Exemplo para checkout abandonado | Por que importa |
|---|---|---|
| Gatilho | Checkout iniciado sem pedido criado | Evita contatos sem relação com o fluxo |
| Público | Número válido e opt-in relevante | Protege confiança e qualidade |
| Tempo | Primeiro lembrete após espera intencional | Evita interromper uma compra ativa |
| Modelo | Lembrete claro com link do checkout | Deixa a intenção clara e facilita aprovação |
| Regra de parada | Parar após compra, opt-out, número inválido ou supressão | Evita mensagens indesejadas |
| Responsável | Pessoa ou fila de suporte definida | Impede conversas ignoradas |
| Métrica | Checkouts e receita recuperados, respostas e opt-outs | Mostra o valor para empresa e cliente |
Mantenha o primeiro modelo focado. Não misture atualização, promoção, pesquisa e upsell. Um motivo e uma ação são mais fáceis de aprovar, operar e melhorar.
Etapa 8: faça um teste de ponta a ponta
Não considere a conta pronta porque um exemplo da API ou uma mensagem de teste funcionou. Teste o caminho real.
Crie checkout ou pedido controlado com um número permitido.
Confirme que o evento correto da Shopify chega à automação.
Confira se o cliente entra no público certo.
Verifique atraso e variáveis do modelo.
Receba a mensagem do número e perfil corretos.
Abra todos os links e confira o destino.
Responda e confirme que o responsável vê a conversa.
Conclua a compra ou acione a condição de parada.
Confirme que a próxima mensagem não é enviada.
Confira entrega, falhas, respostas e conversões.
Esse teste prova que conta, número, modelo, integração, experiência, atendimento e mensuração funcionam como um sistema.
Falhas comuns e o que geralmente significam
| Sintoma | Causa provável | Próxima verificação |
|---|---|---|
| Verificação travada | Dados e documentos não coincidem | Compare nome, endereço, site e validade dos documentos |
| Nome de exibição rejeitado | Ligação com a marca pouco clara ou regras violadas | Alinhe nome, site, perfil e identidade |
| Código não chega | Número errado, URA, rota incompatível ou conta anterior pendente | Revise país, SMS/voz, migração e coexistência |
| Teste funciona, automação não | API conectada, mas gatilho, público ou mapeamento incompletos | Siga um evento Shopify até a decisão de envio |
| Ninguém vê respostas | Falta inbox, webhook, notificação ou atribuição | Teste a rota de resposta |
| Mensagem após compra | Falta parada ou reconciliação de evento | Teste a supressão contra o pedido real |
| Propriedade confusa | Ativos criados sob funcionário, agência ou provedor | Audite portfólio, WABA, número e administradores |
Corrija exatamente a camada que falhou. Recriar a WABA ou trocar de provedor raramente é o primeiro passo.
Lance o primeiro fluxo da Shopify
Comece com uma jornada do cliente, não com um calendário inteiro.
| Primeiro fluxo | Gatilho | Métrica principal |
|---|---|---|
| Checkout abandonado | Checkout segue incompleto após o atraso | Checkouts e receita recuperados |
| Confirmação de pagamento na entrega | Novo pedido COD | Confirmados, cancelados e sem resposta |
| Atualização de pedido | Status do pedido ou processamento muda | Entrega e redução de tickets |
| Solicitação de avaliação | Entrega confirmada e espera concluída | Cliques e avaliações concluídas |
Para cada fluxo, registre gatilho, tempo, segmento, mensagem, alternativa e métrica. Deixe alguém responsável por respostas e exceções nos primeiros dias. Revise falhas e opt-outs antes de aumentar o volume.
Onde a Retentionly se encaixa
A Retentionly é para equipes Shopify e D2C que querem usar a conta do WhatsApp em fluxos de retenção sem construir toda a camada operacional sobre uma API bruta.
A configuração estabelece identidade e remetente. A Retentionly conecta essa base à recuperação de checkout, confirmação COD, atualizações, avaliações, winback, recompra, boas-vindas e upsell pós-compra.
Ela faz sentido quando a pergunta principal não é “Como manteremos a infraestrutura da API?”, mas “Como lançar e medir o fluxo certo da Shopify?”.
Checklist final de configuração
Confirme que o aplicativo Business não atende mais ao fluxo necessário.
Nomeie um responsável interno e um administrador de backup.
Corrija dados e acessos do portfólio da Meta.
Prepare documentos, site, email e marca consistentes.
Escolha API direta, plataforma ou app Shopify.
Crie ou selecione a WABA sob a empresa correta.
Prepare um nome de exibição válido e conclua o perfil.
Finalize a verificação sem confundi-la com Meta Verified.
Escolha número novo, migração ou coexistência elegível.
Verifique a propriedade e proteja o PIN.
Crie um modelo focado e documente o opt-in.
Conecte um gatilho com tempo, parada, respostas e métrica.
Teste evento, mensagem, resposta, parada e relatório.
Lance para um público controlado antes de escalar.
Perguntas frequentes
O que preciso para configurar uma conta da API do WhatsApp Business?
Prepare portfólio da Meta, identidade consistente, WABA, perfil, nome de exibição, número elegível, acesso à verificação, forma de configuração, modelos, opt-in e um primeiro fluxo para testar.
Verificação da empresa é o mesmo que Meta Verified?
Não. A primeira confirma a organização por trás do portfólio. Meta Verified e selos são produtos de confiança separados. Nenhum substitui registro do número, regras de modelo, consentimento ou integração funcional.
Posso usar meu número atual do WhatsApp Business?
Talvez. Algumas configurações exigem migração e outras oferecem coexistência. Isso varia por conta, região, provedor e elegibilidade da Meta; confira o fluxo atual antes de alterar ou excluir a conta.
O número precisa receber SMS?
Ele precisa concluir a verificação de propriedade, geralmente por SMS ou ligação. Garanta que o método chegue até você, principalmente com fixo, URA, encaminhamento ou serviço virtual.
Preciso de um desenvolvedor?
Sim, se implementar a Cloud API diretamente. Uma plataforma ou app Shopify pode cuidar da camada técnica, mas sua empresa ainda responde por identidade, acesso, consentimento, modelos, atendimento e decisões do fluxo.
O que devo testar antes de lançar?
Teste um evento real de ponta a ponta: qualificação do público, tempo, modelo aprovado, número e perfil, links, resposta, regra de parada, entrega e conversão ou relatório operacional.
