> ## Documentation Index
> Fetch the complete documentation index at: https://knowledge.flowella.io/llms.txt
> Use this file to discover all available pages before exploring further.
# Rastreio UTM do WhatsApp para o HubSpot
> Atribua conversas WhatsApp à campanha que as iniciou utilizando parâmetros UTM em anúncios Click-to-WhatsApp, ligações click-to-chat e rastreio CTWA.
Quando um cliente chega até si através do WhatsApp, a parte mais valiosa do contexto é **de onde veio**: qual o anúncio Click-to-WhatsApp (CTWA) em que tocou, qual o link do site, qual a campanha de e-mail. Sem essa atribuição, o seu relatório colapsa em "WhatsApp" como uma fonte única. Com ela, é possível comparar campanhas, calcular o ROAS do anúncio e inserir a atribuição adequada nos negócios do HubSpot.
Esta página abrange os três padrões suportados pelo Flowella para mover a atribuição de campanhas do WhatsApp para o HubSpot.
## Padrão 1: Anúncios de clique para WhatsApp (`ctwa_clid`)
Os anúncios CTWA do Facebook e do Instagram anexam uma ID de clique (`ctwa_clid`) a cada conversa que originam. O Meta passa este ID para o contexto da conversação quando o utilizador toca no anúncio e inicia a conversação, e o Flowella encaminha-o para o HubSpot no registo do contacto.
Fluxo:
1. O cliente vê um anúncio da CTWA no Facebook ou no Instagram.
2. O cliente toca no botão **Enviar Mensagem** no anúncio. O WhatsApp abre com uma mensagem pré-preenchida e o Meta regista o `ctwa_clid`.
3. O cliente envia a mensagem. O Flowella recebe a mensagem de entrada com o `ctwa_clid` nos metadados.
4. O Flowella cria ou actualiza o contacto HubSpot com o valor `ctwa_clid` numa propriedade dedicada.
5. O Flowella também armazena o `ctwa_clid` em relação à conversação, para que a análise possa associar-se ao gasto com anúncios.
A integração da API de conversões do Meta para enviar eventos de conversão de volta ao Facebook Ads Manager usa o mesmo `ctwa_clid`. Consulte [CTWA Ads](/pt/campaigns/click-to-whatsapp-ads) para configurar isto de modo a poder otimizar os gastos com anúncios em conversões reais e não apenas em cliques.
## Padrão 2: Links de clique para chat a partir das suas próprias páginas
Quando coloca um botão **Chat on WhatsApp** no seu site ou e-mail, utiliza um link `wa.me`. O link suporta um parâmetro `text` que preenche previamente a primeira mensagem do utilizador:
```text theme={null}
https://wa.me/441234567890?text=Hi%20I%27m%20interested%20in%20%5BSPRING_LAUNCH%5D
```
O Flowella pode analisar a mensagem pré-preenchida para códigos de rastreio e escrevê-los no HubSpot. A convenção que recomendamos:
* Utilizar uma **palavra-chave entre parênteses** que o utilizador dificilmente escreverá por acidente, por exemplo, `[SPRING_LAUNCH]` ou `[NEWSLETTER_JUL]`.
* Envolva a palavra-chave em marcadores para que a análise não seja ambígua.
* Mantenha a palavra-chave curta e legível para que a mensagem pré-preenchida continue a parecer natural.
O código extraído vai parar à propriedade HubSpot do contacto `whatsapp_entry_source` (ou a uma propriedade personalizada que especifique em **Flowella → Definições → HubSpot**).
### Gerar os links por campanha
Um padrão prático: na sua ferramenta de campanha HubSpot ou folha de cálculo de marketing, construa uma pequena pesquisa de campanha → código de entrada e gere um URL `wa.me` por campanha. Utilize um encurtador de URL ou o URL de rastreio da campanha se pretender um link mais organizado no e-mail e nos criativos de anúncios.
## Padrão 3: UTMs de envio de formulário
Quando um envio de formulário HubSpot desencadeia um fluxo de trabalho WhatsApp, as propriedades padrão HubSpot UTM (`hs_analytics_first_url`, `hs_analytics_source`, `hs_analytics_source_data_1` etc.) já estão no contacto. O Flowella lê-as através da integração HubSpot e apresenta-as no contexto da conversação.
Este é o padrão mais limpo quando o WhatsApp é um canal de **follow-up**: o cliente chegou originalmente através de um URL marcado com UTM, submeteu um formulário e o Flowella despoleta um WhatsApp Flow que preenche as lacunas. A atribuição do UTM é preservada de ponta a ponta sem nada específico para o WhatsApp.
## Criação de relatórios HubSpot com base nestes dados
Uma vez que a atribuição esteja no contacto, é possível criar relatórios HubSpot padrão com base nos mesmos:
* **Contactos por `whatsapp_entry_source`** - quais as campanhas que conduziram a leads WhatsApp
* **Ofertas → primeira fonte = WhatsApp** - receitas atribuíveis aos contactos originados pelo WhatsApp
* Desempenho do fluxo de trabalho por fonte\*\* - quais as campanhas que produziram as taxas de resposta / conversão mais elevadas dentro do WhatsApp Flow
Consulte [Relatórios e dashboards](/pt/hubspot/reporting-and-dashboards) para obter os padrões de relatório que recomendamos configurar.
## Que atribuição é que o Flowella escreve para o HubSpot?
Por defeito, o Flowella escreve as seguintes propriedades em cada contacto durante a atividade do WhatsApp:
| Propriedade | Tipo | Quando escrito |
| ----------------------------- | --------- | --------------------------------------------------------------------- |
| `whatsapp_opted_in` | Boolean | Quando o contacto dá consentimento ao WhatsApp |
| `whatsapp_first_message_at` | Timestamp | Quando o Flowella vê pela primeira vez uma mensagem recebida |
| `whatsapp_last_message_at` | Timestamp | Atualizado em cada mensagem recebida |
| `whatsapp_entry_source` | String | Código fonte analisado da primeira mensagem de entrada ou `ctwa_clid` |
| `whatsapp_campaign_id` | String | O ID da campanha Flowella para a conversa, se aplicável |
| `whatsapp_template_last_sent` | String | O modelo mais recente enviado para o contacto |
É possível mapear dados adicionais do WhatsApp para propriedades personalizadas do HubSpot em **Flowella → Configurações → HubSpot → Mapeamento de campos**.
## Problemas comuns
Nem todas as entradas do WhatsApp têm um `ctwa_clid`. Apenas aqueles que vieram de um anúncio CTWA do Facebook/Instagram o fazem. As mensagens diretas (em que o cliente digitou manualmente o seu número no WhatsApp) não terão este valor, o que está correto - não há qualquer anúncio a que as atribuir.
A mensagem pré-preenchida é apenas uma predefinição. Alguns utilizadores apagam-na antes de a enviar, outros editam-na. Não confie nela para uma lógica de encaminhamento crítica.
Para uma atribuição robusta, prefira `ctwa_clid` (que o utilizador não pode eliminar) em vez da análise de pré-preenchimento `text` (que pode).
Um cliente que clicou num anúncio CTWA do Facebook na terça-feira, não enviou mensagens, depois abriu o mesmo anúncio na quarta-feira e enviou mensagens, terá o `ctwa_clid` do clique de quarta-feira nos metadados WhatsApp. A atribuição padrão de primeiro toque/último toque do HubSpot continua a funcionar nos UTMs subjacentes se o cliente também tiver visitado o seu Web site entretanto.
## Guias relacionados
* [Anúncios CTWA](/pt/campaigns/click-to-whatsapp-ads) - configuração completa incluindo API de Conversões
* [Relatórios e dashboards](/pt/hubspot/reporting-and-dashboards) - transformar dados de atribuição em relatórios
* [Acções de fluxo de trabalho](/pt/hubspot/workflow-actions) - as acções de fluxo de trabalho que disparam quando chega uma mensagem de entrada