Conecta Rinkel con tu CRM, helpdesk, Slack o una herramienta propia. Con la API y los webhooks de Rinkel, los datos de tus llamadas llegan justo donde los necesitas — y automatizas un montón de trabajo manual.
Bueno saberlo ❗
La API y los webhooks están disponibles para los planes Professional y Expert (los webhooks antes eran solo para Expert — ahora también están disponibles para Professional). Es trabajo técnico: un desarrollador o responsable de IT lo tiene listo en un momento, aunque también puedes configurarlo tú mismo si tienes algo de tiempo.
Toda la documentación técnica está en developers.rinkel.com (en inglés). ¿Buscas inspiración? Echa un vistazo a la página de integraciones para ver ejemplos concretos.
¿Qué es una clave API y para qué la necesitas?
Una clave API es un código único — similar a una contraseña — que permite a tu sistema acceder a los datos de tu cuenta de Rinkel. Sin clave, sin acceso.
Creas una clave API en MyRinkel (aquí).
Atención ❗ Trata tu clave API como una contraseña. No la compartas públicamente ni la incluyas en código que vayas a subir a un repositorio público.
Empezar con la API de Rinkel
La API funciona con REST y encontrarás todos los endpoints, parámetros y ejemplos en developers.rinkel.com.
Trabajar con webhooks
Un webhook envía automáticamente un mensaje a tu sistema cada vez que ocurre algo en Rinkel. Por ejemplo: ¿llega una llamada entrante? Abre un ticket. ¿Finaliza una llamada? Actualiza la ficha del cliente en tu CRM.
Configurar un webhook
Ve a esta página en MyRinkel.
Elige el webhook que quieres configurar e introduce la URL de tu endpoint (debe poder recibir solicitudes POST).
¿Qué eventos puedes usar?
Llamada entrante — llega una llamada (aún sin responder). Envía id, datetime, to y from.
Llamada saliente — realizas una llamada (aún sin responder). Mismos campos que arriba.
Inicio de llamada — la llamada ha sido respondida. Envía id, datetime, answeredBy y la opción del menú de bienvenida seleccionada, si la hay.
Fin de llamada — la llamada ha finalizado. Envía id, datetime y cause (seis motivos posibles: sin respuesta, respondida, bloqueada, buzón de voz, cola de llamadas, fuera del horario de atención).
¿Tienes AI Insights? También puedes usar el evento Call insights para enviar el resumen, el análisis de sentimiento y los temas a tu propio sistema. Vincúlalo a una llamada usando el mismo id de llamada.
Los campos exactos del payload los encontrarás en developers.rinkel.com.
Seguridad
Todo el tráfico de webhooks va por HTTPS y el payload es JSON. En tu lado, acepta solo las solicitudes del dominio de Rinkel.
¿Tu webhook no funciona?
Revisa estos puntos:
¿Es correcta la URL de tu endpoint y está accesible desde internet?
¿Acepta tu endpoint solicitudes POST?
¿Devuelve tu aplicación un 200 OK al recibir la solicitud?
¿Permites solicitudes del dominio de Rinkel?
¿Sigue sin funcionar? Envíanos el mensaje de error a [email protected] — te ayudamos a resolverlo.
Preguntas frecuentes
¿En qué planes puedo usar la API y los webhooks?
Professional y Expert.
¿Puedo enviar AI Insights a mi CRM?
Sí, mediante el evento webhook Call insights. Vincúlalo a otros eventos webhook con el mismo id de llamada si también necesitas los números de teléfono.
Quiero ver el nombre del que llama en directo en mi CRM durante una llamada entrante — ¿es posible?
Sí. Usa el webhook de llamada entrante para enviar los datos directamente a tu CRM en el momento en que llega la llamada.
¿Funciona Rinkel con Zapier, Make o Integrately?
La integración directa con Zapier ya no está disponible. Con los webhooks puedes conectar Rinkel tú mismo con cualquier plataforma que los reciba — Zapier, Make e Integrately funcionan perfectamente.