| Requisito | Especificación |
|---|---|
| Plan Safina | Pro o superior |
Introducción
En el mundo empresarial digital actual, la integración fluida de diferentes sistemas es esencial para diseñar tus flujos de trabajo de forma eficiente. Los webhooks se han convertido en una herramienta indispensable para intercambiar datos en tiempo real entre aplicaciones. En este artículo te mostramos cómo crear y utilizar webhooks para Safina AI, con el fin de automatizar y optimizar tu comunicación.
Safina AI, el innovador servicio de buzón de voz basado en IA de Alemania, ofrece a las empresas una solución inteligente para la gestión de llamadas. Mediante la integración de webhooks, puedes conectar la potencia de Safina con tus sistemas de negocio existentes y así generar un valor añadido aún mayor.
Conceptos básicos sobre webhooks
¿Qué son los webhooks?
Los webhooks son mensajes automatizados que se envían de una aplicación a otra cuando ocurren determinados eventos.
Guía relacionada: ¿Qué es un webhook y cómo funciona? Nuestra guía te explica de forma sencilla y con ejemplos cómo conectar tus aplicaciones de negocio con webhooks y automatizar procesos.
A diferencia de las APIs tradicionales, en las que tu aplicación debe consultar datos activamente, los webhooks funcionan según el principio “Push”: en cuanto ocurre un evento relevante, los datos se envían automáticamente a tu endpoint predefinido.
Diferencia entre webhooks y APIs
Mientras que las APIs funcionan según el modelo Request-Response y requieren consultas regulares (polling), los webhooks están orientados a eventos. Esto los hace especialmente eficientes para notificaciones en tiempo real y reduce el tráfico de datos innecesario.
Casos de uso típicos
- Notificaciones en tiempo real: Información inmediata sobre nuevas llamadas
- Integración de datos: Transferencia automática de datos de llamadas a sistemas CRM
- Flujos de trabajo automatizados: Activación de acciones basadas en el contenido o resultado de la llamada
Crear un webhook con tu CRM existente
Casi todas las plataformas CRM líderes admiten webhooks. Proporcionan automáticamente un endpoint seguro que puede recibir los datos de Safina. Solo necesitas copiar la URL correspondiente y la información de autenticación e introducirla en Safina.
Dado que la creación de webhooks funciona de forma ligeramente diferente en cada una de estas herramientas, te hemos enlazado aquí las instrucciones de algunos de los líderes del mercado.
Instrucciones de herramientas CRM habituales
| Nombre de la herramienta | Creación de un webhook |
|---|---|
| Salesforce | Erstellen eines Webhook-Datenaktionsziels |
| Hubspot | Webhooks |
| Zapier | How to get started with Webhooks by Zapier |
| Make | Webhooks |
| Zoho | Creating Webhooks |
| Microsoft Dynamics 365 | Use webhooks to create external handlers for server events |
| Freshsales CRM | What are webhooks? How to configure webhooks for Workflows? |
| Pipedrive | Webhooks |
| Monday | Webhooks |
| Insightly | Webhooks - How to Setup |
| Zendesk | Webhooks |
| SAP CRM | Manage Webhooks |
Añadir tu webhook en la app Safina
Con el plan Pro o superior configuras los webhooks en la app de Safina así:
-
Inicia sesión en la app Safina
-
Navega a la pestaña “Safina”
-
Haz clic en “Sincronizar CRM”
-
Ahora añade un nuevo webhook
-
No olvides guardar a continuación.
Campos de configuración del webhook en la app Safina AI
Al configurar un webhook en Safina AI, debes introducir la siguiente información:
| Campo | Descripción | Ejemplo |
|---|---|---|
| Nombre (solo para ti) | Un nombre interno para identificar el webhook | Hubspot Hook |
| Auth Type | El tipo de autenticación | API_KEY, Bearer |
| Token | Un token de seguridad para la autenticación | 550e8400-e29b-41d4-a716-446655440000, eyJ0eXAiOi... |
| Method | El método HTTP para la llamada al webhook | POST |
| URL | La URL de destino de tu endpoint webhook | https://tu-dominio.es/safina-webhook |
| Api Key Location | Dónde se coloca la clave API en la solicitud | Header, Body |
| Body Attribute Name | Nombre del atributo en el cuerpo de la solicitud | token |
| Header Name | Nombre del atributo en la cabecera de la solicitud | x-api-key |
Además, hay botones para Activar y Eliminar el webhook.
Ejemplos de uso
Integración CRM
Conecta Safina AI con tu sistema CRM para guardar automáticamente la información de llamadas como actividades o notas. Esto te permite tener una visión completa de la comunicación con tus clientes.
Creación automática de tareas
Basándose en el contenido de una llamada, puedes crear automáticamente tareas en tu herramienta de gestión de proyectos. Si un cliente informa de un problema técnico, por ejemplo, se crea automáticamente un ticket de soporte.
Business Intelligence
Recopila datos de llamadas para análisis e informes. Haz seguimiento del volumen de llamadas, consultas frecuentes y sentimiento del cliente para optimizar tus procesos de negocio.
Sistemas de notificación
Configura notificaciones para llamadas importantes o urgentes. Puedes enviar correos electrónicos, SMS o notificaciones push a los empleados responsables.
Qué datos envía Safina
El contenido exacto depende del evento. En call.ended suele llegar:
- Nombre del evento, ID y marca de tiempo
- Llamada: ID, hora, URL de audio, tracking y resumen
- Agente: ID y nombre
- Contacto: nombre, empresa y teléfono, si existen
Ejemplo de call.ended
{
"event": "call.ended",
"event_id": "evt_abc123",
"occurred_at": "2026-01-28T14:32:00.000Z",
"data": {
"call": {
"id": "call_abc123",
"timestamp": "2026-01-28T14:29:38.000Z",
"summary": {},
"call_tracking": {
"from_number": "+4917612345678",
"to_number": "+498962828095"
}
},
"agent": {
"id": "agent_123",
"name": "Safina"
},
"contact": {
"name": "Stefan Bauer",
"company": "Bauer Elektrotechnik GmbH",
"phone_number": "+4917612345678"
}
}
}
Eventos admitidos
| Evento | Descripción |
|---|---|
call.ended | La llamada ha terminado, con resumen |
Actualmente, Safina solo envía call.ended.
Autenticación y detalles técnicos
Safina admite Bearer Token, API Key (cabecera o body) y ninguna autenticación. También puedes añadir cabeceras HTTP propias.
- Métodos HTTP: POST (estándar), GET, PUT, PATCH, DELETE
- POST, PUT, PATCH y DELETE envían el payload en JSON.
- GET no incluye cuerpo de solicitud ni datos del evento en parámetros de consulta.
- Safina intenta la entrega entre una y tres veces, según el número de intentos configurado.
Preguntas frecuentes
¿Qué ocurre si mi servidor no está disponible?
Safina intenta la entrega entre una y tres veces. Si fallan todos los intentos, comprueba la URL y los datos de autenticación, y revisa los registros del receptor. Safina también intenta enviar un correo electrónico sobre el error.
¿Puedo usar más de un webhook?
Sí. Puedes configurar varios webhooks. Cada uno puede recibir call.ended, por ejemplo uno para tu CRM y otro para otro sistema.