Conexão WhatsApp Cloud API

2. O que precisa estar salvo aqui

• Token de acesso permanente — gerado por um usuário do sistema no Business Manager, com permissões whatsapp_business_messaging e whatsapp_business_management.
• Phone Number ID — aparece na tela do WhatsApp dentro do app da Meta.
• Verify token — você inventa uma senha qualquer e cola a mesma no campo Verify token da Meta.
• App Secret — em Settings → Basic; garante que só a Meta consegue chamar o webhook.

Esses valores ficam no cofre do projeto, nunca no código.

Token de acesso da Meta

Cole aqui o token de acesso permanente (EAAdJIq...). Ele é criptografado em trânsito e em repouso no banco, e usado para enviar mensagens e listar templates.

Número ativo

Trocou de número na Meta (teste → real)? Cole os novos IDs aqui — o envio e os templates passam a usar essa conta na hora.

Integração com a Kavoo (vendas)

Cole esta URL nos webhooks da Kavoo (venda aprovada, estornada, pix gerado, boleto gerado, carrinho abandonado, assinatura pausada/cancelada). Cada evento cria ou atualiza o contato, preenche os campos personalizados e aplica as tags “forma de pagamento - produto” e “status - produto” (order bumps incluídos).

Campos criados automaticamente: Produto principal, Produtos, Order bumps, Forma de pagamento, Valor total, Parcelas, Código da transação, Status da venda, Evento da venda, Data do evento, CPF/CNPJ, Link do checkout, Link do boleto, Pix copia e cola, Link área de membros, Cidade, Estado, CEP, Código da assinatura, Status da assinatura, Periodicidade da assinatura, Próxima cobrança, utm_source, utm_medium, utm_campaign, utm_term, utm_content, src, Saldo de cashback, Cashback ganho nesta compra, Cashback usado nesta compra.

3. Teste

Mande uma mensagem do seu celular para o número conectado. O contato e a conversa aparecem sozinhos na caixa de entrada, com a janela de 24 horas contando. Respostas dos colaboradores saem pela API oficial.

Com o número de teste da Meta, só é possível enviar para telefones autorizados em WhatsApp → Configuração da API → campo “Para” → “Gerenciar lista de números”.

4. Trocar para o seu número real

1. Tire o número do app WhatsApp comum. Um número só existe em um lugar: se ele está no WhatsApp ou WhatsApp Business do celular, apague a conta dele lá antes (Configurações → Conta → Apagar minha conta). Use de preferência um chip novo ou fixo dedicado ao atendimento.
2. Cadastre o número na Meta: WhatsApp → Configuração da API → “Adicionar número de telefone”. Informe nome de exibição, categoria do negócio e receba o código por SMS ou chamada.
3. Verifique o negócio (Business Verification) no Business Manager: CNPJ, comprovante de endereço e site. Sem isso o limite fica em 250 conversas por dia; depois sobe para 1.000 e além.
4. Aprove o nome de exibição. Ele precisa ter relação com a marca; nomes genéricos são recusados.
5. Me avise quando estiver aprovado. O número real gera um novo Phone Number ID — eu atualizo a credencial do projeto e o envio passa a sair pelo seu número, sem lista de autorizados.

Importante: quem escreve primeiro abre a janela de 24 horas e a conversa fica de graça. Fora dela, cada template enviado tem custo por conversa cobrado pela Meta — cadastre os textos em Templates.