> ## 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.

# Atividade de contacto da Flowella no HubSpot

> Veja a atividade WhatsApp do Flowella registada no contacto HubSpot, conheça os eventos Timeline v4 e use-os como acionadores de fluxos de trabalho.

Todas as interações WhatsApp que a Flowella trata são escritas no registo de contacto HubSpot como uma atividade de linha de tempo, identificada como **Flowella: WhatsApp Forms Integration**. Isto dá à sua equipa um histórico completo do envolvimento WhatsApp, juntamente com e-mail, chamadas e reuniões.

Cada tipo de atividade é também exposto como um acionador de fluxo de trabalho do Flowella e pode ser utilizado com a ação **Atrasar até ocorrer um evento** do HubSpot para colocar um fluxo de trabalho em pausa até que o contacto faça algo no WhatsApp.

<Note>
  Os eventos de atividade de contacto utilizam a API de eventos **CRM Timeline v4** do HubSpot. Nos bastidores, os quatro tipos de evento são `flowella-message-sent`, `flowella-message-seen`, `flowella-reply` e `flowella-form-completed`. Só vê as etiquetas amigáveis na linha de tempo, mas os nomes de evento subjacentes são importantes se estiver a construir relatórios personalizados ou integrações externas sobre a API do HubSpot.
</Note>

## Atividades registadas num contacto

| Atividade | Registada quando | Acionador de fluxo de trabalho | Utilizar com Atrasar até ao evento | Evento Timeline v4 |
| - | - | - | - | - |
| Formulário concluído | Um contacto submete um formulário WhatsApp Flow enviado pela Flowella | Form Completed | Sim | `flowella-form-completed` |
| Mensagem enviada | A Flowella envia uma mensagem ou modelo de saída | Message Sent | Sim | `flowella-message-sent` |
| Mensagem lida | O contacto abre uma mensagem que a Flowella entregou | Message Read | Sim | `flowella-message-seen` |
| Resposta recebida | O contacto envia uma resposta de texto livre | Text Reply | Sim | `flowella-reply` |

## Propriedades de evento para filtragem

Cada evento da linha de tempo Flowella transporta um conjunto fixo de propriedades definidas na aplicação de programador HubSpot. O HubSpot rejeita o lote inteiro se a Flowella enviar qualquer propriedade que não esteja declarada no esquema do evento, pelo que o tempo de execução emite apenas os campos indicados abaixo. Pode utilizar estas propriedades diretamente como condições de filtro em acionadores de fluxos de trabalho HubSpot, listas ativas e relatórios para o tipo de evento correspondente.

| Evento | Propriedades |
| - | - |
| Form Completed | `formName`, `source` |
| Message Sent | `phone`, `deliveryStatus`, `templateName` (definido quando a mensagem foi enviada a partir de um modelo) |
| Message Read | `phone`, `messageType`, `timeToReadSeconds` |
| Reply Received | `phone`, `message`, `responseTimeSeconds` |

`messageType` é um enum no evento Message Read com os valores `TEXT`, `IMAGE`, `AUDIO`, `VIDEO`, `DOCUMENT`, `TEMPLATE`, `SYSTEM` e `OTHER`. Descreve a mensagem de saída que foi lida.

Filtros típicos:

* **`formName` = `Get Started`** em Form Completed para acionar apenas em submissões de um formulário WhatsApp Flow específico.
* **`messageType` = `TEMPLATE`** em Message Read para isolar recibos de leitura dos seus envios de modelos.
* **`templateName` = `flowella_form_reminder`** em Message Sent para segmentar contactos aos quais foi enviado um modelo específico.
* **Message contém "cancelar"** em Reply Received para construir um fluxo de trabalho de intenção de cancelamento.

<Note>
  Direção não é atualmente uma propriedade de evento. A direção é fixada pelo tipo de evento: Message Sent e Message Read são sempre de saída, e Reply Received é sempre de entrada. Filtre pelo próprio evento em vez de por uma propriedade `direction`.
</Note>

<Note>
  Estas propriedades são definidas no evento da linha de tempo. Nos acionadores de fluxos de trabalho aparecem como campos filtráveis no evento Flowella; nas listas ativas do HubSpot pode referenciá-las através do filtro de evento da linha de tempo para o tipo de evento correspondente.
</Note>

## O que cada atividade regista

### Formulário concluído

Registada quando um contacto preenche um formulário WhatsApp Flow. A atividade regista:

* **Nome do formulário**: o nome do formulário preenchido, por exemplo Get Started
* **Origem**: de onde veio a submissão, por exemplo WhatsApp Flow
* **Ligações**: Ver submissão, Ver na Flowella

### Mensagem enviada

Registada quando a Flowella envia uma mensagem ou modelo de saída ao contacto. A atividade regista:

* **Telefone**: o número de telefone do destinatário no formato E.164
* **Estado de entrega**: o estado de entrega Meta, por exemplo `sent`
* **Nome do modelo**: o modelo utilizado, por exemplo `flowella_form_reminder` (definido apenas quando a mensagem foi enviada a partir de um modelo)
* **Ligações**: Abrir na caixa de entrada, Ver na Flowella

### Mensagem lida

Registada quando o contacto abre uma mensagem que a Flowella entregou. A atividade regista:

* **Telefone**: o número de telefone do destinatário no formato E.164
* **Tipo de mensagem**: o tipo da mensagem de saída que foi lida — um de `TEXT`, `IMAGE`, `AUDIO`, `VIDEO`, `DOCUMENT`, `TEMPLATE`, `SYSTEM` ou `OTHER`
* **Tempo até ler (segundos)**: quanto tempo após a entrega o contacto abriu a mensagem
* **Ligações**: Ver mensagem na Flowella

### Resposta recebida

Registada quando o contacto envia uma resposta de texto livre. A atividade regista:

* **Telefone**: o número de telefone do contacto no formato E.164
* **Mensagem**: o conteúdo da resposta
* **Tempo de resposta (segundos)**: a rapidez com que o contacto respondeu
* **Ligações**: Abrir na caixa de entrada, Ver na Flowella

## Utilizar as atividades em fluxos de trabalho

As mesmas quatro atividades alimentam os acionadores de fluxo de trabalho HubSpot do Flowella. Pode inscrever um contacto quando uma atividade ocorre, ou manter um contacto num passo **Atrasar até ocorrer um evento** até que tal aconteça.

| Atividade | Acionador de fluxo de trabalho | Utilização típica |
| - | - | - |
| Formulário concluído | Form Completed | Processar as respostas do formulário e ramificar com base na resposta |
| Mensagem enviada | Message Sent | Registar atividade de saída ou iniciar um temporizador de seguimento |
| Mensagem lida | Message Read | Fazer seguimento apenas depois de o contacto ter visto a mensagem |
| Resposta recebida | Text Reply | Encaminhar o contacto com base no que respondeu |

<Note>
  O padrão mais eficaz é **enviar e esperar**: envie um modelo, adicione um passo **Atrasar até ocorrer um evento** definido para um evento Flowella, como Form Completed, e ramifique consoante o evento tenha acontecido na sua janela escolhida. Consulte [Ações de fluxo de trabalho](/hubspot/workflow-actions) para a configuração completa, incluindo como filtrar o acionador Text Reply pelo conteúdo da mensagem.
</Note>

## Ativar ou desativar os eventos de atividade de contacto

Os quatro eventos são escritos por uma **capacidade** ao nível da organização. Pode ligar ou desligar toda a funcionalidade sem desinstalar a aplicação HubSpot.

Vá a **Definições → HubSpot → Eventos de atividade de contacto** e alterne o interruptor.

* **Ativado (predefinição)** — O Flowella publica eventos de mensagem enviada, mensagem vista, resposta e formulário concluído na linha de tempo de cada contacto ligado.
* **Desativado** — O Flowella deixa de publicar novos eventos. As entradas existentes na linha de tempo são mantidas.

Desativar o interruptor é útil enquanto depura um fluxo de trabalho ruidoso, ou se um administrador do portal quiser manter temporariamente os dados WhatsApp fora da linha de tempo do CRM.

## Ligações profundas a partir da linha de tempo

Cada evento da linha de tempo tem duas ligações que pode clicar diretamente a partir do cartão de atividade:

* **Ver na Flowella** — utiliza o novo **caminho de caixa de entrada com âmbito de canal** (`/{org}/{waba}/{phone}/inbox/...`), para que aterre no canal certo mesmo que a sua conta Flowella abranja várias WABAs.
* **Abrir na caixa de entrada** — abre o tópico **live-messages** do HubSpot para a conversa, para que um agente possa responder a partir do HubSpot.

(Nos bastidores, a carga útil do evento v4 expõe estes como `flowellaRecordUrl` e `inboxUrl`. Anteriormente eram genéricos e falhavam em contas multicanal — ambos os URLs são agora gerados por canal.)

## Encontrar atividades num contacto

Abra qualquer registo de contacto e veja a linha de tempo **Atividades**. Os eventos Flowella aparecem sob a etiqueta **Flowella: WhatsApp Forms Integration**. Para ver apenas a atividade WhatsApp, filtre a linha de tempo por esse tipo de atividade. Estas mesmas atividades alimentam as propriedades de contacto e conversa utilizadas em [Relatórios e painéis](/hubspot/reporting-and-dashboards).

## Relacionado

<CardGroup cols={2}>
  <Card title="Ações de fluxo de trabalho" icon="git-branch" href="/hubspot/workflow-actions">
    Configure acionadores e ações Flowella em fluxos de trabalho HubSpot.
  </Card>

  <Card title="Relatórios e painéis" icon="chart-column" href="/hubspot/reporting-and-dashboards">
    Relate a atividade WhatsApp juntamente com os seus outros canais.
  </Card>

  <Card title="Canal personalizado" icon="inbox" href="/hubspot/custom-channel">
    Traga as conversas WhatsApp para a caixa de entrada do HubSpot.
  </Card>

  <Card title="Utilizar a caixa de entrada" icon="messages-square" href="/app/inbox">
    Leia e responda a conversas WhatsApp na Flowella.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.