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

Conversation
Lead → webhook
Votre fiche CRM
Issue → API
↩ le revenu revient à la conversation
Olotalk capture et score le lead puis l'envoie à votre webhook ; votre système crée l'enregistrement CRM et, à chaque jalon, appelle l'API d'issue, ce qui ferme la boucle pour rattacher le revenu à la conversation d'origine.

Quand un visiteur soumet le formulaire de capture de lead dans l’assistant, Olotalk :

  1. 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 ;
  2. assigne un statut : qualified (≥ 60), new (21–59) ou dismissed (≤ 20, aucun signal positif) ;
  3. dispatche le lead vers vos canaux de notification. Par défaut, le webhook se déclenche pour chaque lead soumis (new comme qualified, jamais dismissed), alors que l’alerte e-mail ne se déclenche que pour les qualified ;
  4. 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

Comment ça s'additionne+20Base+30Tarifs / démo / intégration+15Cas d'usage ≥ 20 caractères+10Email professionnel…
Qualifié >= 60
0100
Écarté<= 20
Nouveau21-59
Qualifié>= 60
Gagné= 100
Chaque lead soumis obtient un score de 0 à 100 à partir de signaux cumulés. À 60, il passe en qualifié, ce qui déclenche l'alerte email. Une issue gagnée force ensuite le score à 100.
SignalPoints
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 :

ScoreStatutSignification
≥ 60qualifiedLead à fort signal ; déclenche l’alerte e-mail
21–59newSignal partiel ; mérite une revue
≤ 20dismissedAucun 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

meeting
opportunity
GagnéGagné
À mesure qu'un lead progresse, vous renvoyez des issues via POST. meeting et opportunity suivent le pipeline ; seule une issue won (avec valueCents) compte pour le revenu attribué.

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"
}
ChampTypeRequisDescription
type"meeting" | "opportunity" | "won"✓Type d’étape de conversion
occurredAtdatetime ISO 8601✓Quand la conversion a eu lieu dans votre système
valueCentsentier (centimes USD)—Valeur de revenu. Comptée dans les totaux de revenu uniquement si type vaut "won"
noteschaîne (max 1000 caractères)—Note libre
externalIdchaî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"
  }
}
StatutSignification
201Outcome enregistré (ou mis à jour si externalId correspondait déjà)
400Erreur de validation ; consultez details dans le corps
401Clé API absente ou invalide
404Lead introuvable ou n’appartenant pas à cet assistant
429Limite 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

  1. Ouvrez Integrations dans le dashboard et trouvez HubSpot.
  2. Cliquez sur Connect HubSpot. Vous serez redirigé vers l’écran OAuth HubSpot.
  3. Autorisez Olotalk dans le portail ciblé.
  4. 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

Le visiteur confirme le CTA
Upsert contact
Créer le deal
Associer
Mettre à jour le montant sur won
À la confirmation du CTA, Olotalk crée ou met à jour un contact HubSpot à partir de l'email, crée un deal et les associe. Plus tard, si vous signalez une issue gagnée avec une valeur, le montant du deal est mis à jour.

Quand un visiteur confirme le CTA hubspot_create_contact_deal, Olotalk :

  1. upsert un contact HubSpot par adresse e-mail ;
  2. crée un deal HubSpot associé à ce contact ;
  3. 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 :

  1. Olotalk capture et score le lead.
  2. Olotalk POSTe le payload du lead vers votre webhookUrl.
  3. Votre couche d’intégration crée ou met à jour l’enregistrement CRM.
  4. Quand cet enregistrement atteint un état meeting, opportunity ou won, votre système appelle le callback d’outcome avec l’ID CRM comme externalId.

En pratique, ce pattern fonctionne déjà avec tout CRM disposant d’une API publique contact/lead/deal.

CRMMapping typique depuis Olotalk
SalesforceLead ou Contact + Opportunity
PipedrivePerson + Deal
Zoho CRMLead ou Contact + Deal
Microsoft Dynamics 365Lead ou Contact + Opportunity
AttioPerson + Deal
CloseContact + Opportunity
HighLevelContact + Opportunity
FreshsalesContact + Deal
InsightlyContact + Opportunity
monday Sales CRMContact + élément de board Deal
Tout CRM avec API publiqueCré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, opportunity ou won à 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, revenu won sur 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é