Plataforma

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á.

  1. 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.

  2. 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.

  3. 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.

  4. 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.

  5. 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.