Fase 2: Conectar WhatsApp — estrutura na Meta
Esta frente inicia o último item do guia de configuração da Fase 1: Configuração da conta, Conectar WhatsApp. Aqui a operação prepara a estrutura da Meta; a conexão dentro do xLumen continua na Fase 3: Conectar WhatsApp — canal no xLumen.
Escopo desta frente
Section titled “Escopo desta frente”- criação e configuração do business portfolio
- criação do app e início da configuração do WhatsApp
- registro do número e verificação da empresa
- criação do primeiro modelo de mensagem (template) aprovado pela Meta
- cadastro da forma de pagamento exigida para enviar templates em produção
Por que esta frente existe
Section titled “Por que esta frente existe”O xLumen usa a WhatsApp Cloud API da Meta para conectar a operação ao WhatsApp Business.
Para isso, a estrutura mínima da Meta precisa existir e estar organizada no ambiente correto do cliente.
Na prática, essa estrutura envolve:
- um business portfolio para concentrar os ativos do negócio
- uma WhatsApp Business Account (WABA) para representar a operação na plataforma
- um app em Meta for Developers com o produto WhatsApp habilitado para a integração
- a verificação da empresa, exigida para o número funcionar
- um número comercial registrado para envio e recebimento de mensagens
- uma forma de pagamento cadastrada, exigida para enviar templates e iniciar atendimentos em produção
Sem essa base, a implantação não consegue ligar o xLumen ao canal oficial do WhatsApp. A configuração do webhook depende de um código gerado no xLumen e acontece na Fase 3: Conectar WhatsApp — canal no xLumen.
Como executar esta fase
Section titled “Como executar esta fase”Siga esta ordem:
- Pré-requisitos da implantação
- Tutorial: criação e configuração do business portfolio
- Tutorial: criação do App Facebook / WhatsApp
- Tutorial: registrar o número e verificar a empresa
- Tutorial: criar o modelo de mensagem (template)
- Tutorial: adicionar a forma de pagamento na conta da Meta
Checklist da fase
Section titled “Checklist da fase”- confirmar se já existem business portfolio, app, conta de WhatsApp Business e número que devam ser reaproveitados
- definir o business portfolio correto da operação
- criar o app e iniciar a configuração do WhatsApp (Integrar com API)
- registrar o número comercial e verificar a empresa
- criar e enviar para análise pelo menos um modelo de mensagem (texto fixo ou com variáveis)
- cadastrar a forma de pagamento e vinculá-la à conta do WhatsApp Business
Resultado esperado da frente
Section titled “Resultado esperado da frente”Ao final desta frente, a implantação deve ter:
- business portfolio definido para a operação
- app criado e configuração do WhatsApp iniciada (Integrar com API)
- número comercial registrado e empresa verificada
- pelo menos um modelo de mensagem criado e enviado para análise (texto fixo ou com variáveis)
- forma de pagamento cadastrada e vinculada à conta do WhatsApp Business
- estrutura da Meta pronta; a coleta dos dados do app e o webhook acontecem na Fase 3: Conectar WhatsApp — canal no xLumen
Perguntas frequentes
Section titled “Perguntas frequentes”Posso pular a organização do ambiente Meta e ir direto para o xLumen?
Section titled “Posso pular a organização do ambiente Meta e ir direto para o xLumen?”Não. Sem business portfolio, app e número organizados na estrutura correta da Meta, o xLumen não consegue ligar a operação ao canal oficial do WhatsApp. O webhook é configurado depois, na Fase 3: Conectar WhatsApp — canal no xLumen, com um código gerado no xLumen.
Onde estão os tutoriais detalhados desta fase?
Section titled “Onde estão os tutoriais detalhados desta fase?”Na pasta da fase: Tutorial: criação e configuração do business portfolio, Tutorial: criação do App Facebook / WhatsApp, Tutorial: registrar o número e verificar a empresa, Tutorial: criar o modelo de mensagem (template) e Tutorial: adicionar a forma de pagamento na conta da Meta.
Por que preciso criar um modelo de mensagem nesta fase?
Section titled “Por que preciso criar um modelo de mensagem nesta fase?”Porque, sem nenhum template aprovado pela Meta, a operação não consegue iniciar atendimentos pelo WhatsApp fora da janela de 24h. O modelo é criado e enviado para análise ainda aqui — ver Tutorial: criar o modelo de mensagem (template) — para que a aprovação ocorra enquanto a Fase 3 é executada.
Preciso cadastrar forma de pagamento na Meta?
Section titled “Preciso cadastrar forma de pagamento na Meta?”Sim, para iniciar atendimentos. O envio de templates é cobrado pela Meta, então sem forma de pagamento a operação não consegue falar primeiro com o cliente. O cadastro é feito ainda nesta fase — ver Tutorial: adicionar a forma de pagamento na conta da Meta. Receber mensagens e responder dentro da janela de 24h continua gratuito.