Webhook posterior a la llamada

{
  "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 de Famulor 1.0 (legado). Esta página se aplica únicamente a Famulor 1.0 (app.famulor.de) y se conserva por compatibilidad. Para la plataforma actual, usa la referencia de la API de Famulor 2.0.

El Webhook posterior a la llamada se envía automáticamente a la URL de webhook que hayas configurado después de que cada llamada se complete. Este webhook incluye los detalles de la llamada, las variables extraídas, la transcripción y, opcionalmente, la URL de la grabación.

Configuración del webhook

Para activar los Webhooks posteriores a la llamada:

Configura la URL de webhook de tu asistente en los ajustes del asistente
Activa “Post call webhook” en la configuración del asistente
Define las variables posteriores a la llamada que quieres que la IA extraiga

Formato de la solicitud

El webhook se envía como una solicitud POST a la URL configurada con el siguiente payload JSON:

Estructura del payload

integer

Identificador único de la llamada

string

Número de teléfono del cliente en formato E.164 (p. ej. “+1234567890”) o null si no está disponible

string

Número de teléfono usado por el asistente en formato E.164 o null si no está disponible

integer

Duración de la llamada en segundos

string

Estado final de la llamada (p. ej. “completed”, “busy”, “failed”)

object

Variables extraídas por la IA según la configuración de tu esquema posterior a la llamada

Mostrar Ejemplo de variables extraídas

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

object

Variables pasadas al asistente antes de que empezara la llamada

string

Transcripción completa de la conversación

string

URL para descargar la grabación de la llamada (solo se incluye si “Include recording in webhook” está activado en los ajustes del asistente)

string

Marca de tiempo ISO 8601 de cuándo se inició la llamada

string

Marca de tiempo ISO 8601 de cuándo se completó la llamada (tomada del updated_at del registro de la llamada)

object

Información del lead (solo se incluye para llamadas de campaña)

Mostrar Propiedades del lead

integer

Identificador único del lead

string

Número de teléfono del lead

object

Variables asociadas al lead

string

Estado actual del lead

string

Cuándo se creó el lead

string

Cuándo se actualizó el lead por última vez

object

Información de la campaña (si está disponible)

Mostrar Propiedades de la campaña

integer

ID de la campaña

string

Nombre de la campaña

string

Estado de la campaña

string

Hora de inicio permitida de la campaña

string

Hora de fin permitida de la campaña

array

Días permitidos de la campaña

integer

Número máximo de llamadas simultáneas para la campaña

integer

Número máximo de reintentos para los leads

integer

Intervalo de reintento en minutos

string

Cuándo se creó la campaña

string

Cuándo se actualizó la campaña por última vez

Ajustes del webhook

Puedes configurar las siguientes opciones para tu Webhook posterior a la llamada:

Enviar el webhook solo si se completa: envía el webhook únicamente para las llamadas completadas correctamente
Incluir la grabación en el webhook: incluye el campo recording_url en el payload
Variables personalizadas: define variables personalizadas que la IA debe extraer de la conversación

Notas importantes

Los campos customer_phone y assistant_phone pueden ser null si la información no está disponible
El campo recording_url solo se incluye si has activado “Include recording in webhook” en los ajustes de tu asistente
El objeto lead solo se incluye para llamadas que forman parte de una campaña
El objeto extracted_variables contiene las variables que definiste en la configuración del esquema posterior a la llamada de tu asistente

{
  "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
}

Páginas relacionadas: Introducción y Guía de autenticación, y Ejemplos de integración de la API.

Referencia de la API

Asistentes de IA

Carpetas

Etiquetas

Leads

Campañas

Automatizaciones

Acciones durante la llamada

Chatbot de IA

Respuestas de IA

Bases de conocimiento

SMS

WhatsApp

Números de teléfono

Trunks SIP

Llamadas

Webhooks

Webhook posterior a la llamada

Configuración del webhook

Formato de la solicitud

Estructura del payload

Ajustes del webhook

Notas importantes

​Configuración del webhook

​Formato de la solicitud

​Estructura del payload

​Ajustes del webhook

​Notas importantes

Configuración del webhook

Formato de la solicitud

Estructura del payload

Ajustes del webhook

Notas importantes