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

## O que cada atividade regista

### Formulário concluído

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

* **Tipo**: Modelo
* **Origem**: WhatsApp Flow
* **Formulário**: o nome do formulário preenchido, por exemplo Get Started
* **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:

* **Direção**: Saída
* **Tipo**: Modelo ou Texto
* **Estado**: Enviado
* **Modelo**: o nome do modelo, por exemplo `flowella_form_reminder`
* **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:

* **Direção**: Entrada (recibo)
* **Tipo**: Texto
* **Tempo até ler**: 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:

* **Direção**: Entrada
* **Tipo**: Texto
* **Mensagem**: o conteúdo da resposta
* **Tempo de resposta**: 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>