Aller au contenu principal
Actions

Envoyer les données d'appel à votre système

Après chaque appel, envoyez le résumé, la transcription et les données recueillies à votre CRM, à votre webhook ou à votre base de données.

Appel API envoie l'appel à votre propre système une fois celui-ci terminé — le résumé, la transcription, l'humeur et tout ce que l'agent a recueilli. Utilisez-le pour créer un lead dans votre CRM, lancer une automatisation ou tenir vos propres registres. Si votre système est indisponible, la requête est relancée et rien n'est perdu.

Le configurer​

  1. Ajouter l'action

    Ouvrez l'agent → Actions → Ajouter un outil → Post call → Appel API.

  2. La diriger vers votre endpoint
    ChampCe qu'il faut saisir
    Nomp. ex. Synchronisation des leads CRM
    ConditionQuand l'envoyer, p. ex. si l'appelant veut acheter. Vide : après chaque appel
    URL du point de terminaison APIVotre endpoint, p. ex. https://hooks.example.com/hanc
    Méthode HTTPPOST pour la plupart des systèmes ; GET, PUT, PATCH, DELETE fonctionnent aussi
    En-têtes, Paramètres de requêteFacultatifs, p. ex. une clé API
  3. Façonner la requête (facultatif)
    • Corps (JSON) — vos propres champs. Tapez {{ pour insérer une variable d'appel, p. ex. {"lead": "{{firstname}} {{lastname}}", "phone": "{{call_from}}"}.
    • Envoyer uniquement mes champs — omet les données d'appel standard, pour un système qui n'accepte que sa propre structure.
  4. Décider de ce qui se passe en cas d'échec
    • Nouvelles tentatives en cas d'échec — les pauses avant chaque nouvelle tentative quand votre endpoint ne répond pas par 2xx. Par défaut : 1 min, 5 min, 30 min, 2 h, 6 h, 24 h, 48 h.
    • Notification en cas d'échec — un e-mail après la dernière tentative (par défaut), après chaque tentative échouée, ou jamais. Envoyer à : vide signifie le propriétaire du compte.

Que recevra mon endpoint ? dans l'éditeur montre la requête exacte.

Ce que reçoit votre endpoint​

Pour POST, PUT et PATCH, un corps JSON — vos champs fusionnés avec ceux de l'appel :

{
  "id": "6ac7ea6eca60c6024b465c70",
  "agent_id": "6ac2a93e36bad261cf088684",
  "call_from": "+431234567890",
  "call_to": "+439876543210",
  "direction": "inbound",
  "call_type": "phone",
  "call_status": "success",
  "start_timestamp": 1730000000000,
  "end_timestamp": 1730000187000,
  "duration": 187000,
  "transcription": [
    { "speaker": "agent", "content": "Hello…", "timestamp": 1730000001000 },
    { "speaker": "user", "content": "Hi…", "timestamp": 1730000003000 }
  ],
  "call_summary": "Customer asked about pricing…",
  "task_achieved": true,
  "sentiment": { "sentiment": "positive", "explanation": "…" },
  "custom_analysis_data": { "name": "John", "email": "john@example.com" },
  "collected_data": {},
  "transfer_history": [],
  "recording_url": "https://…",
  "disconnection_reason": "user_hangup",
  "is_anonymous": false,
  "is_simulation": false,
  "created_at": 1730000000000,
  "updated_at": 1730000187000
}

Pour GET et DELETE, les mêmes champs passent dans la chaîne de requête, sans les champs imbriqués (transcription, humeur, données recueillies).

Chaque requête porte X-Hanc-Delivery-Id — identique pour toutes les tentatives d'une même livraison, ce qui vous permet d'ignorer les doublons — ainsi que X-Hanc-Attempt avec le numéro de la tentative. Chaque tentative expire au bout de 30 secondes. Toutes les tentatives sont listées dans CRM → Communications, où une livraison échouée peut être renvoyée. Détails : Webhooks et livraison.

Cas d'usage​

  • Créer un lead ou un ticket dans votre CRM.
  • Lancer une automatisation no-code avec les données de l'appel.
  • Tenir votre propre archive d'appels.
Sur cette page