Seu WhatsApp oficial,
conectado à Lumi.

Antes de alterar qualquer conta

1. Informe ao suporte se o número é novo, está no WhatsApp pessoal, no aplicativo WhatsApp Business ou em outra plataforma de atendimento.
2. Para um número novo, confirme que sua empresa controla a linha e consegue receber SMS ou chamada. Tenha o aparelho disponível durante o cadastro.
3. Para um número em uso, combine o procedimento de migração e o momento da mudança. Confirme o que será preservado, o que continuará no celular e o que aparecerá na Lumi.
4. Se quiser manter o WhatsApp Business no celular, peça a validação de elegibilidade e suporte à coexistência antes de iniciar. A tela manual mostrada neste guia não comprova que a coexistência está habilitada.

Conclua quando: Número escolhido e estratégia confirmada com o suporte.

Lumi → Configurações → Organização → Canais

1. Entre na Lumi e confira a organização selecionada no canto superior esquerdo. Use a organização que receberá as conversas da sua empresa.
2. Abra Configurações. Na seção Organização, escolha Canais.
3. Localize o cartão WhatsApp Oficial. O cartão WhatsApp QR (não oficial) corresponde a outra conexão e não deve ser usado neste procedimento.
4. Se Canais não estiver disponível, peça ao administrador da sua organização o acesso adequado.

Conclua quando: A página de Canais está aberta na organização correta.

Meta Business Suite → Configurações

1. Acesse Meta Business Suite com seu próprio perfil do Facebook. Esse perfil deve ter controle adequado sobre os ativos da empresa.
2. Selecione o portfólio empresarial que pertence à sua empresa. Se uma agência administra esse portfólio, solicite acesso ao portfólio existente antes de criar outro.
3. Se a empresa ainda não tiver um portfólio, use a opção de criação oferecida pela Meta, informe nome da empresa, responsável e e-mail comercial e conclua a confirmação solicitada.
4. Em Informações da empresa, confira nome legal, endereço, telefone e site. Prepare os dados oficiais da empresa, como CNPJ e razão social, para quando forem solicitados.
5. Na área Pessoas, confira quem administra os ativos. A empresa deve manter acesso próprio às contas, mesmo quando o suporte ajuda na configuração.

Conclua quando: Portfólio correto identificado e acesso administrativo disponível.

Meta Business Suite → Configurações → Central de Segurança

1. Abra a Central de Segurança e confira a exigência de autenticação de dois fatores. Ative a proteção do seu perfil quando a Meta solicitar; mantenha seus meios de recuperação atualizados.
2. Localize Verificação da empresa. Se houver uma solicitação ou a opção Iniciar verificação aplicável ao seu caso, siga esse fluxo.
3. Informe os dados exatamente como aparecem nos documentos da empresa. Envie somente os documentos aceitos na tela e confirme a relação com a empresa pelo método oferecido.
4. Acompanhe a análise no painel da Meta. Se houver divergência, corrija o dado ou documento indicado. Não há prazo de aprovação garantido pela Lumi.
5. Se a opção de verificação não aparecer, envie ao suporte a descrição do que está sendo exigido. Não crie novos portfólios para contornar uma restrição.

Conclua quando: Proteção de acesso configurada e situação da verificação conhecida.

Meta for Developers → aplicativo → WhatsApp

1. Confirme com a Lumi qual aplicativo da Meta será utilizado. Se o suporte já provisionou a integração, use os ativos indicados por ele e não crie um aplicativo duplicado.
2. No caminho de configuração manual com aplicativo próprio, acesse Meus apps. Abra o app existente ou inicie Criar aplicativo, se esse for o procedimento definido com o suporte.
3. No assistente da Meta, escolha o caso de uso de WhatsApp/contato com clientes que estiver disponível e associe o portfólio correto. Os rótulos mudam entre versões do painel.
4. Conclua as informações exigidas pela Meta. No aplicativo, adicione/configure o produto WhatsApp, quando necessário, e abra Configuração da API.
5. Selecione ou crie a conta WhatsApp Business da empresa conforme o fluxo oferecido. Essa conta, também chamada WABA, agrupa os números e templates.
6. Peça ao suporte que confira a disponibilidade do app e das permissões para uso real. O botão Ao vivo, isoladamente, não comprova que todo o processo está pronto.

Conclua quando: Aplicativo, portfólio e conta WhatsApp Business corretos definidos.

Meta → WhatsApp → Configuração da API → Adicionar telefone

1. Na Configuração da API, localize Adicionar telefone. Abra o assistente de cadastro.
2. Preencha Nome de exibição do WhatsApp Business com o nome comercial que identifica sua empresa. Mantenha coerência com seu site e materiais públicos.
3. Confira o fuso horário. Para empresas que operam no horário de Brasília, use America/Sao Paulo.
4. Escolha a categoria que melhor descreve a atividade e preencha a descrição da empresa, se desejar.
5. Confira as informações e avance. Se a Meta solicitar informações adicionais sobre a conta WhatsApp Business, preencha os dados da mesma empresa.

Conclua quando: Perfil comercial preenchido e etapa de número disponível.

Assistente da Meta → Adicionar número → Verificar número

1. Na etapa Adicionar número, selecione o país e informe DDD e número. Confira o formato internacional apresentado antes de continuar.
2. Escolha SMS ou chamada de voz, conforme as opções disponíveis. A linha deve estar acessível e apta a receber o código.
3. Digite o código diretamente na tela da Meta. Não envie códigos de confirmação ao suporte e não os inclua em prints.
4. Se houver espera para reenviar, respeite o tempo indicado. Confira bloqueios da operadora, desvio de chamadas ou atendimento eletrônico quando usar a ligação.
5. Ao terminar, peça ao suporte para confirmar também o registro do número na Cloud API e a configuração do PIN de verificação em duas etapas, quando aplicável. Confirmar o código e registrar o número para envio são verificações distintas.
6. No caso de migração, siga o procedimento combinado na etapa 1 antes de realizar alterações na conta antiga.

Conclua quando: Número confirmado e registro operacional validado pelo suporte.

Meta → WhatsApp → Configuração da API / Gerenciador do WhatsApp

1. Abra a conta WhatsApp Business correta e procure Adicionar forma de pagamento ou as configurações de pagamento dessa conta.
2. Confira qual empresa, conta e moeda estão selecionadas. Um cartão cadastrado para anúncios não comprova que a conta WhatsApp esteja com pagamento configurado.
3. O responsável financeiro deve inserir e confirmar os dados diretamente na Meta. Não envie foto de cartão nem dados de pagamento em conversa de suporte.
4. Confira o status do meio de pagamento e eventuais pendências antes dos testes de mensagens iniciadas pela empresa.
5. Confirme com a Lumi quem realiza a cobrança da API no seu contrato. As condições do plano Lumi e as tarifas da Meta devem ser conferidas separadamente.

Conclua quando: Responsável pela cobrança definido e pagamento apto para os envios aplicáveis.

Meta → WhatsApp → Configuração da API

1. No campo De, selecione o número de produção da sua empresa. Não deixe selecionado o número de teste da Meta.
2. Localize Identificação do número de telefone. Esse é o valor a inserir em phoneNumberId na Lumi.
3. Localize Identificação da conta do WhatsApp Business. Esse é o valor a inserir em businessAccountId.
4. Use o botão de copiar de cada campo e mantenha os dois valores associados à mesma conta e ao mesmo número.
5. Não substitua esses IDs pelo número com DDD, pelo ID do aplicativo, pelo CNPJ ou pelo ID do portfólio empresarial.

Conclua quando: Os dois identificadores correspondem ao número de produção escolhido.

Meta Business Suite → Configurações → Usuários → Usuários do sistema

1. Peça ao suporte que confirme o tipo de token adequado ao aplicativo escolhido. O token temporário oferecido em Configuração da API serve a testes e não deve sustentar a operação diária.
2. Se o caminho aprovado for um usuário do sistema, abra Usuários do sistema no portfólio do aplicativo. Selecione o usuário destinado à integração ou crie um específico com orientação do suporte.
3. Atribua a esse usuário somente os ativos e as permissões necessários: o aplicativo correto e a conta WhatsApp Business correta. O usuário precisa ter acesso suficiente a ambos.
4. No fluxo Gerar token, selecione o aplicativo e confira a validade disponível. Para mensagens e gerenciamento da conta/templates, o suporte deve validar whatsapp_business_messaging e whatsapp_business_management, além de qualquer requisito específico do fluxo.
5. Gere o token somente após conferir escopo e ativos. Cole o valor completo no campo accessToken da Lumi, sem espaços extras. Guarde-o no meio seguro adotado pela empresa.
6. Se as permissões não aparecerem ou o token não acessar a WABA, não amplie permissões aleatoriamente: peça a revisão da vinculação do aplicativo e dos ativos.

Conclua quando: Token válido e com acesso aos ativos certos, pronto para a integração.

Lumi → Configurações → Organização → Canais → WhatsApp Oficial → Configurar

1. Retorne à Lumi e confira novamente a organização selecionada.
2. Abra WhatsApp Oficial e clique em Configurar.
3. Preencha phoneNumberId, businessAccountId e accessToken com os valores das etapas anteriores. Para gerenciar templates, mantenha o ID da conta WhatsApp Business preenchido corretamente.
4. Mantenha a integração habilitada no controle Ativo e clique em Salvar alterações.
5. Confira se a Lumi informa sucesso e se o canal aparece ativo. Em uma conexão existente, confirme com o suporte antes de substituir credenciais; um campo vazio na edição não é prova de que o token foi removido.

Conclua quando: Configuração salva na organização correta e canal habilitado.

Lumi → página WhatsApp Oficial → Configuração do Webhook

1. Feche o painel de configuração e localize Configuração do Webhook na página do canal.
2. Copie a URL do Webhook pelos controles da sua própria organização.
3. Copie o Token de verificação pelo botão da própria tela. Não confunda esse valor com o token de acesso da Meta.
4. Mantenha a página aberta para comparar com os campos da Meta na etapa seguinte.

Conclua quando: URL da organização e token de verificação disponíveis para configurar o recebimento.

Aplicativo Meta → WhatsApp → Configuração → Webhook

1. Abra o mesmo aplicativo usado para o número conectado à Lumi. Entre em WhatsApp → Configuração.
2. Em URL de callback, cole a URL copiada da Lumi.
3. Em Verificar token, cole o Token de verificação da Lumi. Ele não é o accessToken.
4. Clique em Verificar e salvar. Aguarde o resultado e resolva qualquer erro antes de avançar.
5. Se o aplicativo atender outras contas ou números, peça ao suporte que valide o roteamento antes de substituir um callback existente. Uma troca pode afetar outras conexões.

Conclua quando: A Meta aceitou a verificação do callback.

Meta → WhatsApp → Configuração → Campos do webhook

1. Confirme com o suporte os recursos previstos para sua empresa: atendimento, identificação da origem dos leads, templates, alertas da conta e, quando disponível, chamadas.
2. Na lista Campos do webhook, localize messages e confira o estado Assinado. Esse campo recebe mensagens e atualizações de entrega. A origem de anúncios pode vir dentro da própria mensagem.
3. Use o mapa abaixo para planejar as demais assinaturas. O suporte deve confirmar que a versão da Lumi instalada processa cada evento antes da ativação.
4. Peça ao suporte para conferir a inscrição do aplicativo na conta WhatsApp Business correta. Validar o callback e assinar campos não substitui a vinculação do aplicativo à WABA.
5. Para cada recurso liberado, confira o campo, a versão da API validada pelo suporte e o estado Assinado. Não copie versões antigas apenas porque aparecem no print.
6. Execute os testes do recurso e confira o resultado na Lumi. O botão Testar da Meta comprova somente parte do percurso; finalize também com um cenário real autorizado.

Conclua quando: Mensagens funcionando e cada recurso adicional documentado como validado ou pendente.

14.1 · Mapa de eventos por objetivo

Este mapa orienta a implantação com o suporte. Os nomes técnicos ajudam a localizar as linhas no painel; não representam uma promessa de recursos já disponíveis no seu plano.

Os nomes de campos foram observados no painel da Meta. Disponibilidade, formato e condições variam por versão e conta. Outros campos exibidos, como flows, eventos de grupos ou pagamentos, precisam de análise específica do recurso antes de entrar na implantação.

14.2 · Identificar de onde veio o lead

1. Informe ao suporte quais anúncios de clique para WhatsApp levam ao número conectado.
2. Na implementação da origem, a Lumi deve preservar os dados referral quando a Meta os enviar: identificador e tipo da origem, URL e informações do anúncio disponíveis. O ctwa_clid, quando presente, identifica o clique para atribuição.
3. Valide a gravação no contato/conversa e na mensagem correspondente, mantendo a origem conhecida quando mensagens posteriores vierem sem esses dados. Ausência de referral deve aparecer como origem não identificada, sem presumir que o contato é orgânico.
4. Faça um teste autorizado a partir de um anúncio real e compare o identificador recebido com a origem exibida na Lumi. Uma mensagem digitada diretamente para o número não substitui esse teste.
5. Se desejar nomes de campanha/conjunto ou relatórios de resultado dos anúncios, combine a integração adicional com a conta de anúncios. Enviar conversões à Meta também é um fluxo separado, com configuração e validação próprias.

Referência de implementação: Zendesk — dados de indicação do WhatsApp. A estrutura de armazenamento desse fornecedor é ilustrativa; a Lumi deve tratar o payload direto recebido da Meta.

14.3 · Criar, enviar para análise e acompanhar templates

O fluxo completo é: criar na Lumi → enviar à Meta → aguardar análise → atualizar o status na Lumi → usar após aprovação. O webhook de status informa a decisão; ele não envia o template para análise e não concede aprovação.

1. Crie o modelo conforme a etapa 15, com a categoria, o idioma e os exemplos exigidos.
2. Confirme que a Meta recebeu o cadastro. Guarde o nome/identificador e o idioma para acompanhar o mesmo modelo.
3. Use Atualizar na área de Templates para consultar a situação. A atualização automática por eventos só deve ser considerada ativa depois de validada pelo suporte.
4. Quando houver rejeição, confira a justificativa na Meta, ajuste o conteúdo e siga o fluxo de nova análise. Em caso de pausa, desativação ou perda de qualidade, revise também os envios programados que usam o modelo.
5. Valide o sincronismo com um template de teste: a situação mostrada na Lumi deve corresponder à Meta.

14.4 · Preparar chamadas de voz

1. Defina o uso: receber chamadas de clientes, realizar chamadas pela equipe ou ambos.
2. Peça ao suporte para validar os requisitos atuais da Calling API para a conta e o país do número, incluindo verificações, limites e cobrança.
3. A equipe técnica deve configurar o recurso no número e integrar sinalização, transporte de áudio e controles de atendimento na Lumi, além dos eventos calls.
4. Para chamadas iniciadas pela empresa, implemente a solicitação e a verificação da permissão do usuário antes de ligar. Permissão para receber mensagens não deve ser tratada como autorização automática para chamadas.
5. Defina quem atende, horários, comportamento quando não houver atendente e o registro do resultado da ligação.
6. Antes da liberação, teste recebimento, chamada de saída autorizada, recusa, encerramento e falha de conexão, incluindo áudio nos dois sentidos.

Referência de implementação de voz: Twilio — WhatsApp Business Calling. Essa fonte demonstra chamadas e consentimento; sua configuração é específica do fornecedor e não substitui a validação da integração direta da Lumi com a Meta.

14.5 · Conferência de liberação

Lumi → WhatsApp Oficial → Templates → Criar Template

1. Na Lumi, clique em Templates. Use Atualizar para sincronizar a lista quando necessário.
2. Clique em Criar Template. Defina um nome descritivo com letras minúsculas, números e underscores, por exemplo lembrete_agendamento.
3. Escolha a categoria e o idioma. Utility corresponde a comunicações transacionais; Marketing, a conteúdo promocional; Authentication, a autenticação. A classificação final segue a análise da Meta.
4. Escreva o corpo da mensagem. Inclua cabeçalho, rodapé e botões somente se forem necessários. Confira as variáveis e os exemplos exigidos pela Meta.
5. Exemplo de texto para revisão: “Olá, {{1}}. Seu agendamento com {{2}} está previsto para {{3}}, às {{4}}. Precisa de ajuda para ajustar o horário?” Não inclua informações clínicas sensíveis nesse exemplo.
6. Salve e acompanhe o status. Utilize o template somente depois de aprovado. Se a Meta pedir exemplos ou ajustes que não estejam disponíveis na Lumi, conclua pelo Gerenciador do WhatsApp com o suporte.

Conclua quando: Template no idioma correto, aprovado e disponível para seleção na Lumi.

Lumi → Chat; telefone de teste autorizado

1. Use um telefone de teste da equipe, com autorização, e envie uma mensagem simples para o número conectado. Exemplo: “Olá, gostaria de saber o horário de atendimento”.
2. Abra Chat na Lumi. Confira se a mensagem entrou na organização correta e se o contato corresponde ao telefone de teste.
3. Responda pela Lumi e confirme o recebimento no aparelho. Verifique também os indicadores de entrega disponíveis.
4. Se o agente de IA for atender, confira suas instruções, horários, informações da empresa e transferência para uma pessoa antes de ativar a rotina. Teste uma pergunta simples e o pedido de atendimento humano.
5. Teste um template aprovado com um contato autorizado e confirme sua entrega. Para validar especificamente o cenário fora da janela de atendimento, use uma conversa de teste que já esteja fora dela; enviar um template dentro da janela não prova esse cenário.
6. Registre a data, quem acompanhou o teste e quais verificações passaram. Inicie o atendimento após os testes previstos, com responsável definido para acompanhar falhas.

Conclua quando: Recebimento e resposta comprovados; IA e templates validados conforme o uso contratado.