Leads et conversions
Olotalk capte l’intention des visiteurs, score les leads et boucle l’attribution quand ces leads convertissent dans votre CRM ou votre outil de calendrier. Les outcomes reviennent ensuite dans Olotalk pour que chaque conversation puisse être reliée à du revenu.
Comment fonctionne la conversion
Quand un visiteur soumet le formulaire de capture de lead dans l’assistant, Olotalk :
- score le lead (0–100) à partir du type d’intention, du niveau de confiance, de la présence d’un nom d’entreprise, de la richesse du cas d’usage et du domaine e-mail ;
- assigne un statut :
qualified(≥ 60),new(21–59) oudismissed(≤ 20, aucun signal positif) ; - dispatche le lead vers vos canaux de notification. Par défaut, le webhook se déclenche pour chaque lead soumis (
newcommequalified, jamaisdismissed), alors que l’alerte e-mail ne se déclenche que pour lesqualified; - stocke le lead avec l’e-mail, le nom, l’entreprise, le cas d’usage, l’URL de page, l’intention, le score et un résumé IA asynchrone de la session.
La livraison webhook est suivie et rejouée avec backoff exponentiel si l’envoi initial échoue.
Référence du scoring des leads
| Signal | Points |
|---|---|
| Base (le formulaire a simplement été soumis) | 20 |
Intention : pricing, demo ou integration | +30 |
Intention : support | +12 |
| Confiance d’intention ≥ 85% | +10 |
| Nom d’entreprise fourni | +10 |
| Cas d’usage ≥ 20 caractères | +15 |
| Domaine e-mail professionnel (non gratuit) | +10 |
Seuils de statut :
| Score | Statut | Signification |
|---|---|---|
| ≥ 60 | qualified | Lead à fort signal ; déclenche l’alerte e-mail |
| 21–59 | new | Signal partiel ; mérite une revue |
| ≤ 20 | dismissed | Aucun signal positif ; bruit de base |
Un lead bascule aussi en won (score forcé à 100) quand vous renvoyez un outcome won via le callback ci-dessous.
Attribution en boucle fermée : callback des outcomes
Dès qu’un lead convertit dans votre système (meeting réservé, opportunité créée, revenu gagné), renvoyez l’information à Olotalk pour fermer la boucle d’attribution. C’est ce qui transforme “webhook livré” en “revenu attribuable”.
Assistant API key
Le callback d’outcome utilise une clé API par assistant et non le secret global du dashboard. Chaque assistant a sa propre clé, ce qui permet rotation ou révocation par intégration.
Pour générer ou faire tourner la clé, ouvrez votre assistant dans Assistants, allez à l’étape Installation et développez Domaines d’installation et clé API pour trouver Generate key. La clé en clair n’est affichée qu’une seule fois.
Format : olk_ suivi de 64 caractères hexadécimaux.
Endpoint
POST /public/v1/assistants/{assistantId}/leads/{leadId}/outcome
Authorization: Bearer olk_{your_assistant_api_key}
Content-Type: application/json
Corps de requête
{
"type": "meeting",
"occurredAt": "2026-04-15T14:00:00Z",
"notes": "Démo réservée via Calendly",
"externalId": "evt_cal_abc123"
}
| Champ | Type | Requis | Description |
|---|---|---|---|
type | "meeting" | "opportunity" | "won" | ✓ | Type d’étape de conversion |
occurredAt | datetime ISO 8601 | ✓ | Quand la conversion a eu lieu dans votre système |
valueCents | entier (centimes USD) | — | Valeur de revenu. Comptée dans les totaux de revenu uniquement si type vaut "won" |
notes | chaîne (max 1000 caractères) | — | Note libre |
externalId | chaîne (max 255 caractères) | — | Clé d’idempotence. Identifiant stable de l’événement, par ex. un UUID Calendly ou un ID d’activité HubSpot |
Réponse
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"
}
}
| Statut | Signification |
|---|---|
201 | Outcome enregistré (ou mis à jour si externalId correspondait déjà) |
400 | Erreur de validation ; consultez details dans le corps |
401 | Clé API absente ou invalide |
404 | Lead introuvable ou n’appartenant pas à cet assistant |
429 | Limite atteinte ; réessayez après 60 secondes |
Plusieurs outcomes pour un même lead
Un lead peut accumuler plusieurs outcomes dans le temps. Appelez l’endpoint une fois par événement de conversion ; Olotalk les stocke tous.
# Étape 1 — meeting réservé
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"}'
# Étape 2 — revenu gagné (3 semaines plus tard)
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"}'
Attribution des outcomes (dans le dashboard)
Votre page Analytics agrège ces outcomes : conversions par type (meeting / opportunity / won), revenu total et ventilation par assistant. Les totaux de revenu ne somment que les values des outcomes won.
Attribution des leads (dans le dashboard)
Votre page Leads liste chaque lead capturé, filtrable par statut (new / qualified / dismissed), intention (pricing / demo / integration / support / general) et assistant. La même vue affiche aussi une ventilation d’attribution : leads par intention, top pages par volume de leads et funnel qualified par assistant.
Intégration HubSpot
Olotalk propose une intégration HubSpot native. Quand elle est connectée, un visiteur qui confirme le CTA Create HubSpot contact & deal crée automatiquement un contact et un deal HubSpot, sans Zapier ni export manuel.
Connecter HubSpot
- Ouvrez Integrations dans le dashboard et trouvez HubSpot.
- Cliquez sur Connect HubSpot. Vous serez redirigé vers l’écran OAuth HubSpot.
- Autorisez Olotalk dans le portail ciblé.
- Vous êtes redirigé vers votre assistant avec une confirmation
hubspot=connected.
La connexion est par assistant. Plusieurs assistants peuvent partager un même portail, ou pointer vers des portails différents.
Ce qui se passe quand le CTA se déclenche
Quand un visiteur confirme le CTA hubspot_create_contact_deal, Olotalk :
- upsert un contact HubSpot par adresse e-mail ;
- crée un deal HubSpot associé à ce contact ;
- associe le deal au contact via l’API d’association HubSpot.
Le hubspotDealId obtenu est stocké dans Olotalk pour la traçabilité.
Boucler la boucle : mise à jour du montant sur won
Quand vous signalez un outcome won avec valueCents > 0, Olotalk met automatiquement à jour le champ amount du deal HubSpot correspondant.
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"}'
L’outcome reste enregistré même si la mise à jour HubSpot échoue.
Refresh de token
Les access tokens HubSpot expirent. Olotalk stocke access token et refresh token puis fait le refresh automatiquement avant chaque appel quand l’expiration est proche.
Déconnecter
Ouvrez Integrations, puis HubSpot, puis cliquez sur Disconnect. Les tokens stockés sont révoqués et la connexion supprimée.
Autres intégrations CRM
HubSpot est aujourd’hui la seule intégration CRM native. Tout le reste suit le même pattern générique :
- Olotalk capture et score le lead.
- Olotalk POSTe le payload du lead vers votre
webhookUrl. - Votre couche d’intégration crée ou met à jour l’enregistrement CRM.
- Quand cet enregistrement atteint un état
meeting,opportunityouwon, votre système appelle le callback d’outcome avec l’ID CRM commeexternalId.
En pratique, ce pattern fonctionne déjà avec tout CRM disposant d’une API publique contact/lead/deal.
| CRM | Mapping typique depuis Olotalk |
|---|---|
| Salesforce | Lead ou Contact + Opportunity |
| Pipedrive | Person + Deal |
| Zoho CRM | Lead ou Contact + Deal |
| Microsoft Dynamics 365 | Lead ou Contact + Opportunity |
| Attio | Person + Deal |
| Close | Contact + Opportunity |
| HighLevel | Contact + Opportunity |
| Freshsales | Contact + Deal |
| Insightly | Contact + Opportunity |
| monday Sales CRM | Contact + élément de board Deal |
| Tout CRM avec API publique | Création/mise à jour contact ou lead + callback d’outcome ensuite |
Quand un CRM est un bon candidat
Un CRM est un bon fit pour Olotalk s’il prend en charge :
- la création ou mise à jour de contacts, leads, deals ou opportunités via HTTP ;
- l’authentification OAuth ou par clé API ;
- des webhooks sortants, ou tout autre mécanisme d’événement, pour renvoyer
meeting,opportunityouwonà Olotalk sans export manuel.
Roadmap native
Selon la roadmap actuelle, les prochains CRM candidats après HubSpot sont :
- Salesforce
- Pipedrive
D’ici là, le pattern webhook + callback d’outcome reste la voie supportée.
Alertes e-mail sur lead qualifié
Définissez un Notify email sur l’assistant pour recevoir une alerte dès qu’un lead atteint le statut qualified. Réglage disponible sur l’étape Base, sous Advanced configuration → Action policy.
L’alerte est envoyée en fire-and-forget via le même pipeline e-mail transactionnel que les e-mails de reset de mot de passe.
Dashboard
La page /leads du dashboard expose tout cela visuellement :
- Summary cards, total, qualified, new, dismissed
- Outcome pipeline, meetings, opportunities, count
won, revenuwonsur 30 jours - Attribution section, barres d’intention et top pages
- Lead list, filtrable, paginée, avec score, résumé IA, statut webhook et lien vers le deal HubSpot si connecté