Conectar a WhatsApp Cloud API (oficial da Meta)

O WhatsApp Cloud API é o canal oficial da Meta. Na CopyFunnel ele complementa o e-mail em duas frentes: mensagem de acesso ao comprador assim que o pedido é pago e mensagens de recuperação de carrinho/boleto. O e-mail sempre é a fonte da verdade — o WhatsApp é reforço, não substituto.

O que você precisa

Da sua conta da Meta (Business):

1. Token de acesso permanente do usuário de sistema da sua app no Business Manager.
2. Phone Number ID do número de telefone registrado na Cloud API (aparece no painel da Meta, em API Setup, junto do número).

Configurar no painel

Na rota Integrações, abra o card WhatsApp Cloud API e preencha:

1. Token — o token permanente da Meta.
2. Phone Number ID — o ID numérico do telefone remetente.

Clique em Salvar: a CopyFunnel valida os dois de uma vez, consultando o Phone Number ID no Graph API (GET /v21.0/{phoneNumberId}). Se passar, o status vira Conectado. Você pode revalidar quando quiser com Testar conexão.

O token é cifrado em repouso e nunca volta para a tela — o drawer mostra só os últimos 4 dígitos. Deixar o campo vazio ao salvar preserva o token anterior.

Mensagem de acesso (template acesso_liberado)

Quando um pedido é pago, a CopyFunnel envia o WhatsApp de acesso pelo template pré-aprovado acesso_liberado (categoria Utility, idioma pt_BR). O corpo do template espera 3 variáveis, nesta ordem:

1. {{1}} — primeiro nome do comprador
2. {{2}} — título do produto principal
3. {{3}} — link de acesso (assinado)

Esse envio usa o número da plataforma, não o número cadastrado no seu drawer. Ele só acontece se houver telefone válido no pedido.

Gate de curadoria

O número remetente do WhatsApp de acesso é o da plataforma — por isso o envio passa pelo mesmo gate da curadoria. Quando a verificação está ativa na plataforma, só envia WhatsApp de acesso quem está com o status aprovado. Se a curadoria não estiver ligada na plataforma, o envio segue normalmente.

Recuperação via WhatsApp

Na esteira de recuperação (agenda fixa 10 min, 5 h e 24 h), cada estágio pode ter um template próprio de WhatsApp. O fluxo:

1. No produto, na configuração de recuperação, informe o nome do template no estágio desejado. Vazio = WhatsApp pulado naquele estágio.
2. O template precisa estar pré-aprovado na SUA conta Meta (a conectada neste drawer), categoria Utility, idioma pt_BR, com 3 variáveis no corpo: {{1}} nome do cliente, {{2}} nome do produto, {{3}} link de retorno ao checkout.
3. O e-mail é o canal primário: se o e-mail da etapa falhar, o WhatsApp não é tentado. Se o WhatsApp falhar, a etapa não trava — o e-mail já saiu.

Normalização do telefone

A máscara do checkout grava o telefone no formato (11) 98765-4321. Antes de enviar, a CopyFunnel normaliza para o padrão E.164 brasileiro sem o "+" — por exemplo 5511987654321. O comprador pode colar o número com ou sem o DDI 55. Números que não batem num telefone brasileiro válido (10 ou 11 dígitos, com ou sem DDI) nunca recebem mensagem — dígito errado não vira destino.

Resumo de comportamento

• Falha no WhatsApp de acesso não reverte a concessão do acesso.
• Falha no WhatsApp de recuperação não trava o estágio (o e-mail manda).
• Sem credencial conectada ou sem template configurado, o canal é silenciosamente pulado.