Introdução

Anúncio Click-to-WhatsApp (CTWA) é uma forma comum de fornecer um ponto de entrada do anúncio diretamente para a conversa no WhatsApp. Com o suporte do Gatilho de Anúncio e dos Eventos do App, você pode criar um fluxo completo de conversão no construtor de chatbot.

Configurar o CTWA

Para começar, é preciso configurar um Anúncio Click-to-WhatsApp (CTWA) para que os clientes sejam redirecionados do aplicativo para o número comercial.

Para configurar o CTWA no Gerenciador de Anúncios, consulte o guia fornecido pela Meta.

Conceder Permissão de Anúncios

1. Para ativar os recursos relacionados a anúncios Click-to-WhatsApp e Evento de Conversão no WOZTELL, permita a Permissão de Anúncios na página da plataforma do canal WhatsApp Cloud.

NOTA

Certifique-se de que o usuário do Facebook que está realizando o login no fluxo de Business do Facebook tenha "Controle Total" para gerenciar a conta de anúncios relevante.

2. Na primeira etapa do fluxo de Login para Empresas , selecione a Conta Comercial para conectar com a WOZTELL.

3. Escolha a página que será associada.

4. Escolha a conta de anúncios que será conectada.

NOTA:

Este conjunto de dados é essencial para registrar eventos de conversão por meio da Conversions API. A WOZTELL cria esse conjunto de dados automaticamente usando seu ID de Conta Comercial do WhatsApp (`waba_id`) e o vincula à página conectada. Este conjunto de dados funciona como o destino onde a Meta recebe os dados dos eventos para medição de desempenho.

5. Para a Conversions API, a Meta criará um conjunto de dados no Gerenciador de Eventos, que terá o mesmo nome da página associada.
   

6. Permita que a WOZTELL tenha as seguintes permissões.

7. Agora a WOZTELL foi conectada à sua conta comercial.

8. Clique em "Voltar para o Woztell" para fechar a janela pop-up.

Funcionalidades

Ao permitir a Permissão de Anúncios, agora você tem acesso a funcionalidades relacionadas ao CTWA e à Conversions API.

Pré-visualização do CTWA

Com a Permissão de Anúncios, o Anúncio Click-to-WhatsApp (CTWA) pode ser visualizado no histórico da conversa para distingui-lo de outros tipos de entrada.

O Anúncio Click-to-WhatsApp (CTWA) também pode ser exibido na caixa de entrada da conversa.

Gatilho de Anúncios

O Gatilho de Anúncios da Meta permite que você crie fluxos de chatbot especificamente para membros que entraram na conversa por meio de CTWA. Ele consegue reconhecer entradas através de "um anúncio específico" ou "qualquer anúncio". Além disso, você também pode adicionar grupos de palavras-chave ao gatilho.

NOTA

Se você configurar o Gatilho de Anúncios sem nenhum grupo de palavras-chave, ele será ativado por qualquer entrada do usuário, desde que esse membro esteja associado a um anúncio.

Criar Gatilho

1. Primeiro, crie um nó global.

2. Crie um novo gatilho e selecione Gatilho de Anúncios da Meta.

3. Você pode adicionar palavras-chave ao gatilho.

4. Além disso, você pode decidir se o chatbot será acionado por Todos os Anúncios ou por Anúncios Específicos com o respectivo ID do Anúncio.

Criar Resposta

5. Para configurar a resposta, crie um nó geral.

6. Crie uma nova resposta.

7. Adicione a mensagem de resposta e salve o nó.

8. Por fim, certifique-se de estar redirecionando do nó global para o nó geral com a resposta.

Enviar Evento de Conversão

Para clientes que entram na conversa via CTWA, a Meta oferece suporte a eventos de conversão para ajudar a acompanhar possíveis conversões. Você pode usar a ação para marcar uma compra concluída ou um lead enviado em determinado ponto do fluxo do chatbot.

Esses eventos serão enviados à Meta e associados a um anúncio CTWA específico.

NOTA:

Para garantir a atribuição correta da conversão ao clique original no anúncio, o payload do evento deve incluir o campo "ctwa_clid" (ID do clique do Click-to-WhatsApp). Esse identificador é capturado automaticamente pela WOZTELL a partir do objeto `referral` no webhook quando um usuário inicia uma conversa por um CTWA.

Você deve armazenar esse ID e enviá-lo posteriormente quando ocorrer uma conversão (por exemplo, envio de lead ou compra).

1. Considerando que você tem um fluxo de chatbot para entrada via CTWA, pode criar um novo nó para enviar o evento.

2. Crie uma nova ação.

3. Selecione "Enviar Evento de Conversão", depois escolha o respectivo "ID do WABA", "ID da Conta de Anúncios" e "ID do Anúncio".

{
data: [
{
event_name: "Purchase",
event_time: 1675999999,
action_source: "business_messaging",
messaging_channel: "whatsapp",
user_data: {
whatsapp_business_account_id: "<WABA_ID>",
ctwa_clid: "<CLICK_ID>"
},
custom_data: {
currency: "USD",
value: 123
}
}
],
partner_agent: "WOZTELL"
}

4. Em "Tipo de Evento", se você selecionar "Purchase", especifique a "Moeda" e o "Valor".

5. Se você selecionar o evento "Lead", não será necessário preencher nenhum campo adicional.

6. Se necessário, você também pode incluir informações adicionais em "Entrada Opcional". Consulte aqui para mais detalhes.

7. Depois que o nó com a ação "Enviar Evento de Conversão" for executado, o evento será enviado para a Meta para marcar uma conversão concluída.
   

Importante:

A Meta não remove duplicações automaticamente. Se houver possibilidade de enviar a mesma conversão mais de uma vez (por exemplo, por tentativas repetidas ou múltiplos fluxos), garanta que seu sistema trate a deduplicação antes de chamar a Conversions API.

Para confirmar rapidamente se os eventos foram enviados com sucesso, você pode acessar o dataset correspondente no Events Manager da sua conta do Facebook Business Manager.

NOTAS:

Os dados dos eventos serão exibidos no dataset configurado na etapa 5 da permissão de anúncios.

Se você for um parceiro atuando em nome de um cliente, certifique-se de que o cliente saiba como localizar o dataset no Events Manager para fins de verificação.