¿Cómo integro Rinkel con otras herramientas mediante webhooks?

¿Estás buscando integrar My Rinkel usando la API (lanzada en mayo de 2024)? Por favor, dirígete al artículo sobre la API.

Ten en cuenta que: los webhooks son técnicos. Recomendamos encarecidamente ser o contratar a un desarrollador, o tener experiencia en TI para implementar webhooks en tus herramientas existentes. Por supuesto, si quieres trastear tú mismo y estás dispuesto a invertir tiempo para investigar cómo funcionan los webhooks, ¡también estás más que bienvenido!

En este FAQ, responderemos a las siguientes preguntas:

• ¿Por qué necesito un webhook?

• ¿Cómo configuro un webhook?

• ¿Qué datos se envían en un webhook?

• ¿Qué medidas de seguridad existen para los webhooks?

• ¿Qué debo hacer si mi webhook no funciona?

¿Por qué necesito un webhook?

Los webhooks son una forma eficiente de integrar diferentes servicios con My Rinkel. Al aprovechar los webhooks, puedes activar automáticamente ciertas acciones o actualizaciones en tus otras aplicaciones comerciales (como tu CRM, tu soporte técnico o herramientas de análisis) en función de las actividades de llamadas en Rinkel.

Por ejemplo, si se recibe una nueva llamada entrante, un webhook podría enviar instantáneamente estos datos a su punto final de URL, lo que a su vez podría crear automáticamente un nuevo ticket en su sistema de soporte técnico.

¿Cómo configuro un webhook?

Para configurar un webhook, debes especificar un punto final de URL en tu aplicación a donde Rinkel puede enviar los datos. Este punto final debe ser accesible a través de Internet y ser capaz de recibir solicitudes POST. Una vez que hayas configurado el punto final, puedes proporcionar la URL a Rinkel a través del Webphone, siguiendo los pasos a continuación:

1. Ve al teléfono web de Rinkel

2. Haz clic en el ícono de ajustes en la esquina superior izquierda y ve a Integraciones

3. Haz clic en el webhook que deseas configurar (llamadas entrantes, llamadas salientes, inicio de una llamada o finalización de una llamada)

4. Ingresa la URL del punto final en el campo provisto

5. Haga clic en URL de prueba para verificar si la URL es válida

6. Agrega una descripción del webhook (opcional)

7. Haz clic en guardar para guardar tus cambios.

Asegúrate de permitir que las solicitudes del dominio de Rinkel reciban correctamente las notificaciones de webhook.

¿Qué datos se envían en un webhook?

Rinkel ha creado 4 webhooks, que actualmente son los mismos webhooks utilizados para nuestra integración con Zapier:

• Llamadas entrantes

• Llamadas salientes

• El comienzo de una llamada

• El final de una llamada

Llamadas entrantes:

Este webhook se activa cuando se ha realizado una llamada entrante pero aún no se ha respondido.

• id: la identificación única de la llamada

• fecha&hora: La fecha y hora de la llamada

• a: el número de la persona que llama

• desde: El número de teléfono al que se llamó

El comienzo de una llamada:

Este webhook se activa en el momento en que usted o un colega responde la llamada entrante, o en el momento en que la persona a la que intenta llamar contesta el teléfono.

• id: la identificación única de la llamada

• fecha&hora: La fecha y hora de la llamada

• contestado por: el usuario que respondió la llamada (representado por una identificación de usuario única)

• elección: cualquier elección realizada en el menú de bienvenida (solo disponible para llamadas entrantes)

El final de una llamada:

Este webhook se activa cuando finaliza una llamada, por cualquiera de los cinco motivos disponibles.

• id: la identificación única de la llamada

• fecha&hora: La fecha y hora de la llamada

• causa: El motivo por el que se terminó la llamada (5 opciones: no contestada, contestada, en lista negra, buzón de voz, fuera de horario de atención)

¿Qué debo hacer si mi webhook no funciona?

Si tu webhook no funciona como se esperaba, aquí hay algunos pasos comunes para solucionar el problema:

1. Verifica el punto final: asegúrate de que la URL del punto final sea correcta y sea accesible a través de Internet.

2. Verifica el método HTTP: confirma que tu punto final está configurado para recibir solicitudes POST.

3. Inspecciona la solicitud y la respuesta: usa herramientas para capturar la solicitud entrante y ver si hay algún error. Además, asegúrate de que tu aplicación devuelva un código de estado HTTP correcto (200 OK) para acusar recibo de los datos.

4. Verifica el dominio de Rinkel: asegúrate de aceptar solicitudes del dominio de Rinkel.

5. Si aún tienes problemas, copia los mensajes de error que recibas y envíalos al equipo de soporte de Rinkel. Estaremos encantados de ayudarte a solucionar el problema.