Webhook post-appel

{
  "id": 480336,
  "customer_phone": "+4915123456789",
  "assistant_phone": "+4912345678",
  "duration": 180,
  "status": "completed",
  "extracted_variables": {
    "customer_interested": true,
    "appointment_scheduled": false,
    "contact_reason": "product_inquiry",
    "follow_up_needed": true,
    "customer_budget": "10000-50000",
    "decision_maker": true,
    "next_contact_date": "2024-02-15"
  },
  "input_variables": {
    "customer_name": "Max Mustermann",
    "company": "Beispiel GmbH"
  },
  "transcript": "Assistant: Hello Mr. Mustermann! I am calling from Famulor...\nCustomer: Hello, yes I’m listening...",
  "recording_url": "https://recordings.famulor.de/call-480336.mp3",
  "created_at": "2024-01-15T10:30:00Z",
  "finished_at": "2024-01-15T10:33:00Z",
  "lead": {
    "id": 12345,
    "phone_number": "+4915123456789",
    "variables": {
      "customer_name": "Max Mustermann",
      "company": "Beispiel GmbH",
      "source": "website"
    },
    "status": "contacted",
    "created_at": "2024-01-14T09:00:00Z",
    "updated_at": "2024-01-15T10:33:00Z"
  },
  "campaign": {
    "id": 2324,
    "name": "New Customer Acquisition Q1 2024",
    "status": "in-progress",
    "allowed_hours_start_time": "09:00:00",
    "allowed_hours_end_time": "18:00:00",
    "allowed_days": ["monday", "tuesday", "wednesday", "thursday", "friday"],
    "max_calls_in_parallel": 5,
    "max_retries": 3,
    "retry_interval": 60,
    "created_at": "2024-01-01T08:00:00Z",
    "updated_at": "2024-01-15T10:00:00Z"
  }
}

{
  "id": 480337,
  "customer_phone": "+4917123456789",
  "assistant_phone": "+4912345678",
  "duration": 120,
  "status": "completed",
  "extracted_variables": {
    "issue_resolved": true,
    "customer_satisfaction": 9,
    "support_category": "technical"
  },
  "input_variables": {},
  "transcript": "Assistant: Hello! How can I assist you today?\nCustomer: I have a problem with...",
  "recording_url": null,
  "created_at": "2024-01-15T14:20:00Z",
  "finished_at": "2024-01-15T14:22:00Z",
  "lead": null,
  "campaign": null
}

API Famulor 1.0 (héritée). Cette page concerne uniquement Famulor 1.0 (app.famulor.de) et est conservée pour la compatibilité. Pour la plateforme actuelle, consultez la référence API Famulor 2.0.

Le Webhook post-appel est envoyé automatiquement à l’URL de webhook que vous avez indiquée, une fois chaque appel terminé. Ce webhook inclut les détails de l’appel, les variables extraites, la transcription et, en option, l’URL de l’enregistrement.

Configuration du webhook

Pour activer les Webhooks post-appel :

Configurez l’URL de webhook de votre assistant dans les paramètres de l’assistant
Activez « Post call webhook » dans la configuration de l’assistant
Définissez les variables post-appel que vous souhaitez que l’IA extraie

Format de la requête

Le webhook est envoyé sous forme de requête POST vers l’URL que vous avez configurée, avec la charge utile JSON suivante :

Structure de la charge utile

integer

Identifiant unique de l’appel

string

Numéro de téléphone du client au format E.164 (par ex. +1234567890) ou null si non disponible

string

Numéro de téléphone utilisé par l’assistant au format E.164, ou null si non disponible

integer

Durée de l’appel en secondes

string

Statut final de l’appel (par ex. completed, busy, failed)

object

Variables extraites par l’IA en fonction de la configuration de votre schéma post-appel

Afficher Exemple de variables extraites

{
  "customer_interested": true,
  "appointment_scheduled": false,
  "contact_reason": "product_inquiry",
  "follow_up_needed": true,
  "customer_budget": "10000-50000"
}

object

Variables transmises à l’assistant avant le début de l’appel

string

Transcription complète de la conversation

string

URL de téléchargement de l’enregistrement de l’appel (incluse uniquement si « Include recording in webhook » est activé dans les paramètres de l’assistant)

string

Horodatage ISO 8601 du début de l’appel

string

Horodatage ISO 8601 de la fin de l’appel (repris du champ updated_at de l’enregistrement d’appel)

object

Informations sur le lead (incluses uniquement pour les appels de campagne)

Afficher Propriétés du lead

integer

Identifiant unique du lead

string

Numéro de téléphone du lead

object

Variables associées au lead

string

Statut actuel du lead

string

Date de création du lead

string

Date de dernière mise à jour du lead

object

Informations sur la campagne (si disponible)

Afficher Propriétés de la campagne

integer

ID de la campagne

string

Nom de la campagne

string

Statut de la campagne

string

Heure de début autorisée de la campagne

string

Heure de fin autorisée de la campagne

array

Jours autorisés pour la campagne

integer

Nombre maximal d’appels simultanés pour la campagne

integer

Nombre maximal de tentatives pour les leads

integer

Intervalle entre les tentatives, en minutes

string

Date de création de la campagne

string

Date de dernière mise à jour de la campagne

Paramètres du webhook

Vous pouvez configurer les options suivantes pour votre Webhook post-appel :

Send webhook only on completed : envoie le webhook uniquement pour les appels terminés avec succès
Include recording in webhook : inclut le champ recording_url dans la charge utile
Custom variables : définit les variables personnalisées que l’IA doit extraire de la conversation

Remarques importantes

Les champs customer_phone et assistant_phone peuvent être null si l’information n’est pas disponible
Le champ recording_url n’est inclus que si vous avez activé « Include recording in webhook » dans les paramètres de votre assistant
L’objet lead n’est inclus que pour les appels faisant partie d’une campagne
L’objet extracted_variables contient les variables que vous avez définies dans la configuration du schéma post-appel de votre assistant

{
  "id": 480336,
  "customer_phone": "+4915123456789",
  "assistant_phone": "+4912345678",
  "duration": 180,
  "status": "completed",
  "extracted_variables": {
    "customer_interested": true,
    "appointment_scheduled": false,
    "contact_reason": "product_inquiry",
    "follow_up_needed": true,
    "customer_budget": "10000-50000",
    "decision_maker": true,
    "next_contact_date": "2024-02-15"
  },
  "input_variables": {
    "customer_name": "Max Mustermann",
    "company": "Beispiel GmbH"
  },
  "transcript": "Assistant: Hello Mr. Mustermann! I am calling from Famulor...\nCustomer: Hello, yes I’m listening...",
  "recording_url": "https://recordings.famulor.de/call-480336.mp3",
  "created_at": "2024-01-15T10:30:00Z",
  "finished_at": "2024-01-15T10:33:00Z",
  "lead": {
    "id": 12345,
    "phone_number": "+4915123456789",
    "variables": {
      "customer_name": "Max Mustermann",
      "company": "Beispiel GmbH",
      "source": "website"
    },
    "status": "contacted",
    "created_at": "2024-01-14T09:00:00Z",
    "updated_at": "2024-01-15T10:33:00Z"
  },
  "campaign": {
    "id": 2324,
    "name": "New Customer Acquisition Q1 2024",
    "status": "in-progress",
    "allowed_hours_start_time": "09:00:00",
    "allowed_hours_end_time": "18:00:00",
    "allowed_days": ["monday", "tuesday", "wednesday", "thursday", "friday"],
    "max_calls_in_parallel": 5,
    "max_retries": 3,
    "retry_interval": 60,
    "created_at": "2024-01-01T08:00:00Z",
    "updated_at": "2024-01-15T10:00:00Z"
  }
}

{
  "id": 480337,
  "customer_phone": "+4917123456789",
  "assistant_phone": "+4912345678",
  "duration": 120,
  "status": "completed",
  "extracted_variables": {
    "issue_resolved": true,
    "customer_satisfaction": 9,
    "support_category": "technical"
  },
  "input_variables": {},
  "transcript": "Assistant: Hello! How can I assist you today?\nCustomer: I have a problem with...",
  "recording_url": null,
  "created_at": "2024-01-15T14:20:00Z",
  "finished_at": "2024-01-15T14:22:00Z",
  "lead": null,
  "campaign": null
}

Pages associées : Introduction et Guide d’authentification, et Exemples d’intégration API.

Référence API

Assistants IA

Dossiers

Étiquettes

Prospects

Campagnes

Automatisations

Actions en cours d’appel

Chatbot IA

Réponses IA

Bases de connaissances

SMS

WhatsApp

Numéros de téléphone

Trunks SIP

Appels

Webhooks

Webhook post-appel

Configuration du webhook

Format de la requête

Structure de la charge utile

Paramètres du webhook

Remarques importantes

​Configuration du webhook

​Format de la requête

​Structure de la charge utile

​Paramètres du webhook

​Remarques importantes

Configuration du webhook

Format de la requête

Structure de la charge utile

Paramètres du webhook

Remarques importantes