Onboarding da API do WhatsApp, passo a passo
Entre o cadastro e a primeira mensagem entregue existem cinco portas que pertencem à Meta, não a você. Esta página as lista em ordem, o que cada uma exige e o que o Morasel faz em cada uma.
Por que as equipes travam entre o cadastro e a primeira mensagem
A maioria dos projetos de API do WhatsApp não fracassa; trava. O número ainda está vinculado ao app do WhatsApp Business no celular de alguém, a verificação da Meta Business espera um documento que ninguém foi avisado a enviar, o primeiro modelo foi rejeitado por uma regra de redação, ou a carteira está vazia no dia do lançamento. Nada disso é difícil. Tudo fica invisível até travar você.
- Um número ainda registrado no app do WhatsApp Business não pode ser usado na API antes de ser liberado.
- A verificação da Meta Business pede documentos da empresa que correspondam exatamente ao nome do negócio.
- A primeira mensagem enviada precisa de um modelo aprovado; a aprovação é da Meta, não nossa.
- Os custos de envio são pré-pagos; um número ativo com a carteira vazia não entrega nada.
O que o Morasel registra do seu canal
Um registro de conexão do WhatsApp por número, com cada porta e seu estado, para quem conduz o onboarding ver onde o canal está sem perguntar.
- Número de telefone
- O número sendo conectado, o nome de exibição, e se é novo ou está sendo transferido do app do WhatsApp.
- Verificação da Meta Business
- Não iniciada, enviada, verificada ou ação necessária — com o motivo devolvido pela Meta.
- Revisão do nome de exibição
- A decisão da Meta sobre o nome que os clientes verão.
- Modelos
- Cada modelo com sua categoria, idioma, status na Meta e a hora da última sincronização.
- Carteira
- Saldo pré-pago, moeda e a última recarga.
- Status do canal
- Conectado e enviando, conectado mas bloqueado (e por qual porta), ou desconectado.
As cinco portas, em ordem
Cada porta é um estado real no seu espaço de trabalho. Você não pode pular nenhuma, e não precisa adivinhar em qual está.
Cadastre-se e escolha o número
Crie seu espaço de trabalho (teste de 14 dias, sem cartão). Decida se vai conectar um número novo ou manter o que seus clientes já salvaram; se ele estiver no app do WhatsApp Business, libere-o primeiro — o guia de manter seu número explica isso.
Cadastro integrado da Meta
No espaço de trabalho, abra o fluxo de login da Meta. A equipe do Morasel entra na conversa e permanece nela. Você confirma o negócio, o número, e concede ao Morasel as permissões que a Meta pede.
Verificação do negócio e nome de exibição
Envie o documento da empresa que a Meta pede; o nome nele deve corresponder ao seu nome na Meta Business. A revisão do nome de exibição corre em paralelo. Ambas mostram seu estado no registro de conexão.
Primeiro modelo aprovado
Envie seu primeiro modelo pelo espaço de trabalho — um lembrete, uma atualização de pedido, uma resposta — no idioma do cliente. A Meta aprova ou rejeita; o status é sincronizado com o Morasel a cada 15 minutos e o motivo da rejeição é exibido.
Carregue a carteira e ative o canal
Recarregue a carteira pré-paga por cartão ou transferência bancária. Quando a verificação, um modelo aprovado e um saldo positivo estiverem prontos, o canal passa a enviar e a primeira mensagem sai.
O que o cliente vê no primeiro dia
O nome do seu negócio, verificado, no número que ele já tem — e uma mensagem que veio de um modelo aprovado.
O que sua equipe vê enquanto isso acontece
O onboarding é uma checklist no registro de conexão, não um chamado de suporte.
- Cada porta com seu estado e quem está esperando por quem — você, a Meta ou o Morasel.
- O motivo de rejeição da Meta, na íntegra, ao lado do modelo ou documento a que se refere.
- Uma conversa compartilhada com a equipe do Morasel no mesmo registro, então nada se repete por e-mail.
- Saldo da carteira e a tabela de tarifas do seu país antes do envio da primeira mensagem.
- O momento em que o canal entra no ar, com o horário, no registro de auditoria.
Permissões e pontos de revisão
Normalmente duas pessoas conduzem o onboarding: um proprietário que assina com a Meta e um gerente que escreve os modelos. O Morasel mantém os dois separados.
- Só um proprietário pode iniciar o cadastro integrado da Meta ou desconectar um número.
- O envio de modelos pode ser delegado a um gerente; a aprovação continua sendo da Meta.
- As recargas da carteira ficam registradas com quem pagou, como e quando.
- Toda mudança de estado no registro de conexão fica no registro de auditoria.
O que o Morasel não faz
O Morasel não verifica seu negócio, não aprova seus modelos nem define as tarifas de mensagem — isso é sempre da Meta. O Morasel torna cada porta visível, mantém sua equipe na conversa, e ativa o canal no momento em que as decisões da Meta permitem. Não emitimos chaves de API instantâneas, e não nos chamamos de provedor oficial de soluções de negócios a menos que isso seja formalmente o caso.
Comece a conexão hoje
Crie seu espaço de trabalho, escolha o número, e deixe a equipe do Morasel na conversa em cada porta da Meta.
Perguntas sobre onboarding
Quanto tempo leva o onboarding da API do WhatsApp?
O cadastro e o cadastro integrado da Meta levam minutos. A verificação da Meta Business geralmente leva alguns dias úteis e depende de seus documentos corresponderem ao nome do seu negócio. A aprovação do modelo costuma sair no mesmo dia. A maioria das equipes já está enviando durante o teste.
Posso manter o número que meus clientes já têm?
Sim. Libere-o primeiro do app do WhatsApp Business e depois conecte-o no Morasel. O histórico de conversa no celular não é migrado; o número e seus clientes, sim.
Recebo uma chave de API imediatamente após o cadastro?
Não. Enviar mensagens exige antes a verificação da Meta e um modelo aprovado. O que você recebe imediatamente é um espaço de trabalho com o registro de conexão que mostra exatamente qual porta está aberta.
O Morasel é um provedor oficial de soluções de negócios (BSP) do WhatsApp?
O Morasel conecta seu número pelo cadastro integrado da Meta para a WhatsApp Business Platform. Não reivindicamos um título de parceiro que não temos formalmente; a relação com a Meta é declarada com clareza na nossa página do WhatsApp Business Platform.
E se a Meta rejeitar meu primeiro modelo?
O motivo da rejeição aparece no modelo em até 15 minutos após a decisão da Meta. Edite e reenvie na mesma tela; não há limite de reenvios.
Preciso de cartão para começar?
Não. O teste de 14 dias não exige cartão. Você carrega a carteira por cartão ou transferência bancária quando estiver pronto para enviar.