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

# Flowella-Kontaktaktivität in HubSpot

> So erscheinen WhatsApp-Nachrichten und Konversationsereignisse in der HubSpot-Kontakt-Timeline und wie Sie sie für Reporting und Filter nutzen.

Jede WhatsApp-Interaktion, die Flowella abwickelt, wird als Timeline-Aktivität mit der Bezeichnung **Flowella: WhatsApp Forms Integration** in den HubSpot-Kontaktdatensatz zurückgeschrieben. So erhält Ihr Team neben E-Mails, Anrufen und Besprechungen eine vollständige Historie der WhatsApp-Interaktionen.

Jeder Aktivitätstyp ist außerdem als Flowella-Workflow-Trigger verfügbar und kann mit der HubSpot-Aktion **Verzögern, bis das Ereignis eintritt** verwendet werden, um einen Workflow anzuhalten, bis der Kontakt etwas auf WhatsApp tut.

<Note>
  Kontaktaktivitätsereignisse verwenden die **CRM Timeline v4**-Ereignis-API von HubSpot. Hinter den Kulissen heißen die vier Ereignistypen `flowella-message-sent`, `flowella-message-seen`, `flowella-reply` und `flowella-form-completed`. In der Timeline sehen Sie immer nur die benutzerfreundlichen Bezeichnungen, aber die zugrundeliegenden Ereignisnamen sind wichtig, wenn Sie benutzerdefinierte Berichte oder externe Integrationen auf der HubSpot-API aufbauen.
</Note>

## Für einen Kontakt verfolgte Aktivitäten

| Aktivität              | Aufgezeichnet, wenn                                                      | Workflow-Trigger | Verwendung mit Verzögern bis Ereignis | Timeline-v4-Ereignis      |
| ---------------------- | ------------------------------------------------------------------------ | ---------------- | ------------------------------------- | ------------------------- |
| Formular abgeschlossen | Ein Kontakt sendet ein von Flowella gesendetes WhatsApp-Flow-Formular ab | Form Completed   | Ja                                    | `flowella-form-completed` |
| Nachricht gesendet     | Flowella sendet eine ausgehende Nachricht oder Vorlage                   | Message Sent     | Ja                                    | `flowella-message-sent`   |
| Nachricht gelesen      | Der Kontakt öffnet eine von Flowella zugestellte Nachricht               | Message Read     | Ja                                    | `flowella-message-seen`   |
| Antwort empfangen      | Der Kontakt sendet eine Freitextantwort                                  | Text Reply       | Ja                                    | `flowella-reply`          |

## Was jede Aktivität aufzeichnet

### Formular abgeschlossen

Wird protokolliert, wenn ein Kontakt ein WhatsApp-Flow-Formular ausfüllt. Die Aktivität zeichnet auf:

* **Typ**: Vorlage
* **Quelle**: WhatsApp Flow
* **Formular**: der Name des ausgefüllten Formulars, zum Beispiel Get Started
* **Links**: Einreichung anzeigen, In Flowella anzeigen

### Nachricht gesendet

Wird protokolliert, wenn Flowella eine ausgehende Nachricht oder Vorlage an den Kontakt sendet. Die Aktivität zeichnet auf:

* **Richtung**: Ausgehend
* **Typ**: Vorlage oder Text
* **Status**: Gesendet
* **Vorlage**: der Vorlagenname, zum Beispiel `flowella_form_reminder`
* **Links**: In Posteingang öffnen, In Flowella anzeigen

### Nachricht gelesen

Wird protokolliert, wenn der Kontakt eine von Flowella zugestellte Nachricht öffnet. Die Aktivität zeichnet auf:

* **Richtung**: Eingehend (Empfangsbestätigung)
* **Typ**: Text
* **Zeit bis zum Lesen**: wie lange nach der Zustellung der Kontakt die Nachricht geöffnet hat
* **Links**: Nachricht in Flowella anzeigen

### Antwort empfangen

Wird protokolliert, wenn der Kontakt eine Freitextantwort sendet. Die Aktivität zeichnet auf:

* **Richtung**: Eingehend
* **Typ**: Text
* **Nachricht**: der Inhalt der Antwort
* **Antwortzeit**: wie schnell der Kontakt geantwortet hat
* **Links**: In Posteingang öffnen, In Flowella anzeigen

## Aktivitäten in Workflows verwenden

Dieselben vier Aktivitäten treiben die HubSpot-Workflow-Trigger von Flowella an. Sie können einen Kontakt einschreiben, wenn eine Aktivität eintritt, oder einen Kontakt an einem Schritt **Verzögern, bis das Ereignis eintritt** halten, bis sie eintritt.

| Aktivität              | Workflow-Trigger | Typische Verwendung                                                   |
| ---------------------- | ---------------- | --------------------------------------------------------------------- |
| Formular abgeschlossen | Form Completed   | Formularantworten verarbeiten und dann nach der Antwort verzweigen    |
| Nachricht gesendet     | Message Sent     | Ausgehende Aktivität protokollieren oder einen Nachfass-Timer starten |
| Nachricht gelesen      | Message Read     | Erst nachfassen, wenn der Kontakt die Nachricht gesehen hat           |
| Antwort empfangen      | Text Reply       | Kontakt basierend auf seiner Antwort weiterleiten                     |

<Note>
  Das stärkste Muster ist **Senden, dann warten**: Senden Sie eine Vorlage, fügen Sie einen Schritt **Verzögern, bis das Ereignis eintritt** hinzu, der auf ein Flowella-Ereignis wie Form Completed eingestellt ist, und verzweigen Sie dann darauf, ob das Ereignis in Ihrem gewählten Zeitfenster eingetreten ist. Unter [Workflow-Aktionen](/hubspot/workflow-actions) finden Sie die vollständige Einrichtung, einschließlich der Filterung des Text-Reply-Triggers nach Nachrichteninhalt.
</Note>

## Kontaktaktivitätsereignisse ein- oder ausschalten

Die vier Ereignisse werden von einer **Capability** auf Organisationsebene geschrieben. Sie können die gesamte Funktion ein- oder ausschalten, ohne die HubSpot-App zu deinstallieren.

Gehen Sie zu **Einstellungen → HubSpot → Kontaktaktivitätsereignisse** und betätigen Sie den Schalter.

* **Ein (Standard)** — Flowella veröffentlicht Message-Sent-, Message-Seen-, Reply- und Form-Completed-Ereignisse in der Timeline jedes verbundenen Kontakts.
* **Aus** — Flowella veröffentlicht keine neuen Ereignisse mehr. Bestehende Timeline-Einträge bleiben erhalten.

Das Ausschalten ist nützlich, während Sie einen lauten Workflow debuggen, oder wenn ein Portal-Admin WhatsApp-Daten vorübergehend aus der CRM-Timeline heraushalten möchte.

## Deep Links aus der Timeline

Jedes Timeline-Ereignis enthält zwei Links, die Sie direkt aus der Aktivitätskarte anklicken können:

* **In Flowella anzeigen** — verwendet den neuen **kanalbezogenen Posteingangspfad** (`/{org}/{waba}/{phone}/inbox/...`), sodass Sie auf dem richtigen Kanal landen, selbst wenn Ihr Flowella-Konto mehrere WABAs umfasst.
* **In Posteingang öffnen** — öffnet den HubSpot-**live-messages**-Thread der Konversation, sodass ein Agent von innerhalb von HubSpot antworten kann.

(Hinter den Kulissen stellt die v4-Ereignis-Payload diese als `flowellaRecordUrl` und `inboxUrl` bereit. Sie waren zuvor generisch und funktionierten bei Multi-Channel-Konten nicht — beide URLs werden nun pro Kanal generiert.)

## Aktivitäten zu einem Kontakt finden

Öffnen Sie einen beliebigen Kontaktdatensatz und sehen Sie sich die Timeline **Aktivitäten** an. Flowella-Ereignisse erscheinen unter der Bezeichnung **Flowella: WhatsApp Forms Integration**. Um nur WhatsApp-Aktivitäten zu sehen, filtern Sie die Timeline nach diesem Aktivitätstyp. Dieselben Aktivitäten speisen die Kontakt- und Konversationseigenschaften, die in [Berichte und Dashboards](/hubspot/reporting-and-dashboards) verwendet werden.

## Verwandt

<CardGroup cols={2}>
  <Card title="Workflow-Aktionen" icon="git-branch" href="/hubspot/workflow-actions">
    Flowella-Trigger und -Aktionen in HubSpot-Workflows einrichten.
  </Card>

  <Card title="Berichte & Dashboards" icon="chart-column" href="/hubspot/reporting-and-dashboards">
    Berichten Sie über WhatsApp-Aktivitäten neben Ihren anderen Kanälen.
  </Card>

  <Card title="Benutzerdefinierter Kanal" icon="inbox" href="/hubspot/custom-channel">
    Bringen Sie WhatsApp-Konversationen in den HubSpot-Posteingang.
  </Card>

  <Card title="Verwendung des Posteingangs" icon="messages-square" href="/app/inbox">
    WhatsApp-Konversationen in Flowella lesen und beantworten.
  </Card>
</CardGroup>