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
Wenn ein Besucher das Lead-Capture-Formular im Assistant absendet, dann:
- bewertet Olotalk den Lead (0–100) anhand von Intent-Typ, Konfidenz, Unternehmensangabe, Qualität des Use Cases und E-Mail-Domain;
- vergibt es einen Status:
qualified(≥ 60),new(21–59) oderdismissed(≤ 20, keine positiven Signale); - versendet es den Lead an Ihre Benachrichtigungskanäle. Standardmäßig feuert der Webhook für jeden eingereichten Lead (
newundqualified, niedismissed), die E-Mail-Benachrichtigung dagegen nur fürqualified; - 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
| Signal | Punkte |
|---|---|
| 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:
| Score | Status | Bedeutung |
|---|---|---|
| ≥ 60 | qualified | Starkes Signal; löst die E-Mail-Benachrichtigung aus |
| 21–59 | new | Teilweise Qualifikation; sollte geprüft werden |
| ≤ 20 | dismissed | Kein 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
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"
}
| Feld | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
type | "meeting" | "opportunity" | "won" | ✓ | Typ des Conversion-Meilensteins |
occurredAt | ISO-8601-Datetime | ✓ | Wann die Conversion in Ihrem System passiert ist |
valueCents | Integer (USD-Cent) | — | Umsatzwert. Wird nur dann in Umsatzsummen eingerechnet, wenn type gleich "won" ist |
notes | String (max. 1000 Zeichen) | — | Freitextnotiz |
externalId | String (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"
}
}
| Status | Bedeutung |
|---|---|
201 | Outcome gespeichert oder aktualisiert |
400 | Validierungsfehler; prüfen Sie details im Response-Body |
401 | Fehlender oder ungültiger API-Key |
404 | Lead nicht gefunden oder gehört nicht zu diesem Assistant |
429 | Rate 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
- Öffnen Sie im Dashboard Integrations und suchen Sie HubSpot.
- Klicken Sie auf Connect HubSpot. Sie werden zur HubSpot-OAuth-Seite weitergeleitet.
- Autorisieren Sie Olotalk im gewünschten Portal.
- Sie werden mit einer Bestätigung
hubspot=connectedzurü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
Wenn ein Besucher den CTA hubspot_create_contact_deal bestätigt, dann:
- upsertet Olotalk einen HubSpot-Contact anhand der E-Mail-Adresse,
- erstellt es einen HubSpot-Deal, der mit diesem Contact verknüpft wird,
- 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:
- Olotalk erfasst und bewertet den Lead.
- Olotalk POSTet den Lead-Payload an Ihre konfigurierte
webhookUrl. - Ihre Integrationsschicht erstellt oder aktualisiert den CRM-Datensatz.
- Wenn dieser Datensatz einen Status wie
meeting,opportunityoderwonerreicht, ruft Ihr System den Outcome-Callback auf und übergibt die CRM-ID alsexternalId.
In der Praxis funktioniert dieses Muster bereits mit jedem CRM, das öffentliche APIs für Kontakte, Leads oder Deals bereitstellt.
| CRM | Typisches Mapping aus Olotalk |
|---|---|
| Salesforce | Lead oder Contact + Opportunity |
| Pipedrive | Person + Deal |
| Zoho CRM | Lead oder Contact + Deal |
| Microsoft Dynamics 365 | Lead oder Contact + Opportunity |
| Attio | Person + Deal |
| Close | Contact + Opportunity |
| HighLevel | Contact + Opportunity |
| Freshsales | Contact + Deal |
| Insightly | Contact + Opportunity |
| monday Sales CRM | Contact + Deal-Board-Item |
| Jedes andere CRM mit Public API | Contact-/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,opportunityoderwonohne 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 undwon-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