Leads und Conversions

Olotalk erfasst Besucher-Intent, bewertet Leads und schließt den Attribution-Loop, wenn diese Leads in Ihrem CRM oder Kalendertool konvertieren. Outcomes fließen zurück in Olotalk, sodass sich jede Unterhaltung mit Umsatz verknüpfen lässt.


So funktionieren Conversions

Konversation
Lead → Webhook
Ihr CRM-Eintrag
Outcome → API
↩ Umsatz wird der Konversation zurückzugeordnet
Olotalk erfasst und bewertet den Lead und sendet ihn an Ihren Webhook; Ihr System erstellt den CRM-Eintrag und ruft bei jedem Meilenstein die Outcome-API auf, so schließt sich der Kreis und Umsatz wird der ursprünglichen Konversation zugeordnet.

Wenn ein Besucher das Lead-Capture-Formular im Assistant absendet, dann:

  1. bewertet Olotalk den Lead (0–100) anhand von Intent-Typ, Konfidenz, Unternehmensangabe, Qualität des Use Cases und E-Mail-Domain;
  2. vergibt es einen Status: qualified (≥ 60), new (21–59) oder dismissed (≤ 20, keine positiven Signale);
  3. versendet es den Lead an Ihre Benachrichtigungskanäle. Standardmäßig feuert der Webhook für jeden eingereichten Lead (new und qualified, nie dismissed), die E-Mail-Benachrichtigung dagegen nur für qualified;
  4. speichert es den Lead mit E-Mail, Name, Unternehmen, Use Case, Seiten-URL, Intent, Score und einer asynchron erzeugten KI-Zusammenfassung der Session.

Die Webhook-Zustellung wird verfolgt und bei Fehlschlägen mit exponentiellem Backoff erneut versucht.


Lead-Scoring-Referenz

So addiert es sich+20Basis+30Pricing / Demo / Integration+15Use Case ≥ 20 Zeichen+10Geschäftliche E-Mail…
Qualifiziert >= 60
0100
Verworfen<= 20
Neu21-59
Qualifiziert>= 60
Gewonnen= 100
Jeder eingereichte Lead erhält aus gestapelten Signalen einen Score von 0–100. Ab 60 wird er zu `qualified`, das löst die E-Mail-Benachrichtigung aus. Ein späteres `won` setzt den Score auf 100.
SignalPunkte
Basis (das Formular wurde überhaupt abgesendet)20
Intent: pricing, demo oder integration+30
Intent: support+12
Intent-Konfidenz ≥ 85%+10
Firmenname angegeben+10
Use Case ≥ 20 Zeichen+15
Geschäftliche E-Mail-Domain (nicht kostenlos)+10

Status-Schwellen:

ScoreStatusBedeutung
≥ 60qualifiedStarkes Signal; löst die E-Mail-Benachrichtigung aus
21–59newTeilweise Qualifikation; sollte geprüft werden
≤ 20dismissedKein positives Signal; Basisrauschen

Ein Lead wird außerdem auf won gesetzt (Score fix 100), wenn Sie unten einen won-Outcome über den Callback melden.


Closed-Loop-Attribution: der Outcome-Callback

meeting
opportunity
GewonnenGewonnen
Wenn ein Lead voranschreitet, senden Sie Outcomes per POST zurück. `meeting` und `opportunity` verfolgen die Pipeline; nur ein `won`-Outcome (mit `valueCents`) zählt zum zugeschriebenen Umsatz.

Sobald ein Lead in Ihrem System konvertiert, etwa ein gebuchtes Meeting, eine Opportunity oder gewonnener Umsatz, senden Sie das Ereignis an Olotalk zurück, um den Attribution-Loop zu schließen. Erst dadurch wird aus „Webhook zugestellt“ tatsächlich „Umsatz zurechenbar“.

Assistant-API-Key

Der Outcome-Callback verwendet einen API-Key pro Assistant, nicht das globale Dashboard-Secret. Jeder Assistant hat also eigene Credentials, die Sie pro Integration rotieren oder widerrufen können.

Erzeugen oder rotieren Sie den Key im Builder: Öffnen Sie Ihren Assistant über Assistants, gehen Sie zum Schritt Installation und klappen Sie Installationsdomains & API-Schlüssel auf. Dort finden Sie Generate key. Der Klartext-Schlüssel wird nur einmal angezeigt; kopieren Sie ihn sofort. Olotalk speichert nur den SHA-256-Hash.

Format: olk_ gefolgt von 64 Hex-Zeichen.

Endpoint

POST /public/v1/assistants/{assistantId}/leads/{leadId}/outcome
Authorization: Bearer olk_{your_assistant_api_key}
Content-Type: application/json

Request-Body

{
  "type": "meeting",
  "occurredAt": "2026-04-15T14:00:00Z",
  "notes": "Demo über Calendly gebucht",
  "externalId": "evt_cal_abc123"
}
FeldTypErforderlichBeschreibung
type"meeting" | "opportunity" | "won"✓Typ des Conversion-Meilensteins
occurredAtISO-8601-Datetime✓Wann die Conversion in Ihrem System passiert ist
valueCentsInteger (USD-Cent)—Umsatzwert. Wird nur dann in Umsatzsummen eingerechnet, wenn type gleich "won" ist
notesString (max. 1000 Zeichen)—Freitextnotiz
externalIdString (max. 255 Zeichen)—Idempotency-Key. Ihre stabile Event-ID, z. B. eine Calendly-UUID oder HubSpot-Activity-ID

Response

201 Created

{
  "ok": true,
  "outcome": {
    "id": "cm9...",
    "type": "meeting",
    "valueCents": null,
    "occurredAt": "2026-04-15T14:00:00.000Z",
    "createdAt": "2026-04-15T14:01:00.000Z",
    "externalId": "evt_cal_abc123"
  }
}
StatusBedeutung
201Outcome gespeichert oder aktualisiert
400Validierungsfehler; prüfen Sie details im Response-Body
401Fehlender oder ungültiger API-Key
404Lead nicht gefunden oder gehört nicht zu diesem Assistant
429Rate Limit überschritten; nach 60 Sekunden erneut versuchen

Mehrere Outcomes pro Lead

Ein Lead kann im Zeitverlauf mehrere Outcomes ansammeln. Rufen Sie den Endpoint einmal pro Conversion-Event auf; Olotalk speichert sie alle.

# Schritt 1 — Meeting gebucht
curl -X POST https://api.olotalk.com/public/v1/assistants/ast_oltk_7Kd2mQxRv9TbNhLpW3Zsy/leads/cm9xyz/outcome \
  -H "Authorization: Bearer olk_your_assistant_api_key" \
  -H "Content-Type: application/json" \
  -d '{"type":"meeting","occurredAt":"2026-04-15T14:00:00Z","externalId":"evt_cal_abc123"}'

# Schritt 2 — Umsatz gewonnen (3 Wochen später)
curl -X POST https://api.olotalk.com/public/v1/assistants/ast_oltk_7Kd2mQxRv9TbNhLpW3Zsy/leads/cm9xyz/outcome \
  -H "Authorization: Bearer olk_your_assistant_api_key" \
  -H "Content-Type: application/json" \
  -d '{"type":"won","occurredAt":"2026-05-06T09:00:00Z","valueCents":480000,"externalId":"deal_hs_789xyz"}'

Outcome-Attribution im Dashboard

Ihre Analytics-Seite aggregiert diese Outcomes für Sie: Conversions nach Typ (meeting / opportunity / won), Gesamtumsatz und Aufschlüsselung pro Assistant. In die Umsatzsumme fließen nur Werte aus won-Outcomes ein.


Lead-Attribution im Dashboard

Ihre Leads-Seite listet jeden erfassten Lead, filterbar nach Status (new / qualified / dismissed), Intent (pricing / demo / integration / support / general) und Assistant. Dieselbe Ansicht zeigt außerdem Attribution: Leads pro Intent, Top-Seiten nach Lead-Volumen und einen Qualified-Funnel pro Assistant.


HubSpot-Integration

Olotalk hat eine native HubSpot-Integration. Wenn sie verbunden ist, erzeugt ein Besucher, der den CTA Create HubSpot contact & deal bestätigt, automatisch einen HubSpot-Contact und einen Deal. Kein Zapier, kein manueller Export.

HubSpot verbinden

  1. Öffnen Sie im Dashboard Integrations und suchen Sie HubSpot.
  2. Klicken Sie auf Connect HubSpot. Sie werden zur HubSpot-OAuth-Seite weitergeleitet.
  3. Autorisieren Sie Olotalk im gewünschten Portal.
  4. Sie werden mit einer Bestätigung hubspot=connected zurück zu Ihrem Assistant geleitet.

Die Verbindung gilt pro Assistant. Mehrere Assistants können dasselbe HubSpot-Portal verwenden, oder jeder Assistant kann auf ein anderes zeigen.

Was passiert, wenn der CTA feuert

Besucher bestätigt CTA
Kontakt upserten
Deal erstellen
Verknüpfen
Betrag bei won aktualisieren
Wenn der CTA bestätigt wird, erstellt oder aktualisiert Olotalk einen HubSpot-Kontakt anhand der E-Mail, erstellt einen Deal und verknüpft beide. Wenn Sie später ein `won` mit Wert melden, aktualisiert Olotalk den Deal-Betrag.

Wenn ein Besucher den CTA hubspot_create_contact_deal bestätigt, dann:

  1. upsertet Olotalk einen HubSpot-Contact anhand der E-Mail-Adresse,
  2. erstellt es einen HubSpot-Deal, der mit diesem Contact verknüpft wird,
  3. assoziiert es Deal und Contact über die HubSpot-Association-API.

Die resultierende hubspotDealId wird in Olotalk zur Nachverfolgbarkeit gespeichert.

Den Loop schließen: Deal-Betrag bei won patchen

Wenn Sie einen won-Outcome mit valueCents > 0 melden, aktualisiert Olotalk automatisch das Feld amount des zugehörigen HubSpot-Deals.

curl -X POST https://api.olotalk.com/public/v1/assistants/ast_oltk_7Kd2mQxRv9TbNhLpW3Zsy/leads/cm9xyz/outcome \
  -H "Authorization: Bearer olk_your_assistant_api_key" \
  -H "Content-Type: application/json" \
  -d '{"type":"won","occurredAt":"2026-05-06T09:00:00Z","valueCents":480000,"externalId":"deal_hs_789"}'

Der Outcome wird auch dann gespeichert, wenn das HubSpot-Patching fehlschlägt.

Token-Refresh

HubSpot-Access-Tokens laufen ab. Olotalk speichert Access- und Refresh-Token und erneuert sie automatisch vor jedem API-Call, wenn der Ablauf unmittelbar bevorsteht.

Trennen

Gehen Sie zu Integrations, öffnen Sie HubSpot und klicken Sie auf Disconnect. Die gespeicherten Tokens werden widerrufen und die Verbindung entfernt.


Weitere CRM-Integrationen

HubSpot ist aktuell die einzige native CRM-Integration. Alle anderen folgen dem generischen Handoff-Muster:

  1. Olotalk erfasst und bewertet den Lead.
  2. Olotalk POSTet den Lead-Payload an Ihre konfigurierte webhookUrl.
  3. Ihre Integrationsschicht erstellt oder aktualisiert den CRM-Datensatz.
  4. Wenn dieser Datensatz einen Status wie meeting, opportunity oder won erreicht, ruft Ihr System den Outcome-Callback auf und übergibt die CRM-ID als externalId.

In der Praxis funktioniert dieses Muster bereits mit jedem CRM, das öffentliche APIs für Kontakte, Leads oder Deals bereitstellt.

CRMTypisches Mapping aus Olotalk
SalesforceLead oder Contact + Opportunity
PipedrivePerson + Deal
Zoho CRMLead oder Contact + Deal
Microsoft Dynamics 365Lead oder Contact + Opportunity
AttioPerson + Deal
CloseContact + Opportunity
HighLevelContact + Opportunity
FreshsalesContact + Deal
InsightlyContact + Opportunity
monday Sales CRMContact + Deal-Board-Item
Jedes andere CRM mit Public APIContact-/Lead-Erstellung oder -Update + späterer Outcome-Callback

Wann ein CRM gut passt

Ein CRM passt gut zu Olotalk, wenn es Folgendes unterstützt:

  • Kontakte, Leads, Deals oder Opportunities über HTTP erstellen oder aktualisieren,
  • OAuth oder API-Key-Authentifizierung,
  • ausgehende Webhooks oder eine andere Event-Mechanik, damit meeting, opportunity oder won ohne manuelle Exporte an Olotalk zurückgemeldet werden können.

Native Roadmap

Nach aktuellem Stand sind die nächsten nativen CRM-Kandidaten nach HubSpot:

  • Salesforce
  • Pipedrive

Bis diese nativ ausgeliefert werden, bleibt das Muster aus Webhook plus Outcome-Callback der unterstützte Weg.


E-Mail-Benachrichtigungen für qualifizierte Leads

Hinterlegen Sie am Assistant eine Notify email, um benachrichtigt zu werden, sobald ein Lead den Status qualified erreicht. Die Einstellung finden Sie im Builder im Schritt Base unter Advanced configuration → Action policy.

Die Benachrichtigung wird fire-and-forget über dieselbe transaktionale E-Mail-Pipeline versendet wie die Passwort-Reset-Mails.


Dashboard

Die Seite /leads im Dashboard visualisiert all das:

  • Summary cards, total, qualified, new, dismissed
  • Outcome pipeline, meetings, opportunities, won-Anzahl und won-Umsatz über 30 Tage
  • Attribution section, Intent-Balken und Top-Seiten
  • Lead list, filterbar, paginiert, mit Score-Balken, KI-Zusammenfassung, Webhook-Status und HubSpot-Deal-Link