Integraciones, APIs y Webhooks Automatiza flujos de trabajo y sincroniza datos de manera fluida utilizando las APIs y webhooks en tiempo real de idloom.

Introducción

Las APIs y webhooks en idloom ofrecen potentes herramientas para automatizar flujos de trabajo e integrar sistemas externos. Utilizando APIs, los usuarios pueden sincronizar datos entre idloom y otras aplicaciones de manera eficiente, mejorando la gestión de eventos. Por su parte, los webhooks permiten activar desencadenantes en tiempo real, asegurando que acciones específicas o notificaciones se realicen automáticamente cuando ocurren ciertos eventos en la plataforma.

Estas funciones son ideales para organizadores de eventos, desarrolladores y administradores de TI que desean personalizar y ampliar las capacidades de la plataforma.

Primeros pasos

En idloom, creemos firmemente en la propiedad de los datos, por lo que toda la información que recopiles es completamente tuya. Por eso, nuestros módulos de integración están disponibles desde la versión ligera, lo que te permite integrar idloom fácilmente en tu ecosistema de software, ya seas un usuario frecuente u ocasional.

Dirígete a la sección de integración de la aplicación de eventos y comienza una nueva integración. Puedes elegir entre integraciones nativas predeterminadas o crear una integración personalizada, que exploraremos a continuación.

Integración Personalizada

La integración se compone de cuatro elementos clave:

1. Ajustes Básicos: Define el nombre, el perfil que lo usará y si se utilizarán llamadas API, junto con la clave API necesaria.
2. Configuración Automática: Establece una estructura fija en los formularios de registro para garantizar datos consistentes.
3. Mapeo de Campos: Personaliza el envío de datos para garantizar la compatibilidad con la app externa.​​​​​​​
4. Webhooks: Habilita y configura webhooks para la transmisión de datos en tiempo real, vinculándolos a desencadenantes de idloom.

Habilitar Acceso a Datos de Perfil

Con la integración que estás creando, podrás acceder a la información de eventos y registros a través de las APIs o activar webhooks. Para ello, necesitas conectar el perfil correspondiente a la integración y habilitar el acceso API.

Para mejorar la seguridad de los datos, te recomendamos:

1. Crear integraciones separadas para diferentes perfiles.
2. Activar el acceso API solo cuando sea necesario.
3. Generar una nueva clave API al pasar de desarrollo a producción y rotarla periódicamente (cada 6-12 meses).

Crear y Gestionar Webhooks

Comienza agregando un webhook y seleccionando el desencadenante que deseas activar:

• event.create, event.update, event.delete, event.manual: Estos desencadenantes enviarán una carga útil REST de eventos a tu endpoint, usando el mismo formato que el método API Get Events. El desencadenante manual agrega una nueva opción en las acciones relacionadas con el evento.
• guest.create, guest.update, guest.delete, guest.manual: Estos desencadenantes enviarán una carga útil REST de asistentes, similar al método API Get Attendees. El desencadenante manual también añade una nueva opción en las acciones relacionadas con los asistentes.

A continuación, puedes especificar el nombre del webhook, la URL a la que enviarás la carga útil y el método HTTP que utilizarás (GET, POST, PUT, DELETE, PATCH). Si has seleccionado un desencadenante manual, el nombre del webhook se convertirá en la etiqueta para la nueva función en el menú.

También puedes configurar los encabezados de la solicitud, como tokens Bearer u otras configuraciones de seguridad.

Si deseas restringir el webhook a eventos específicos, introduce los valores UID, separados por comas. Esta información está disponible en la sección Geek > Analytics & Tracking de la configuración del evento.

Activar Webhooks de Integración en tus Perfiles

Estás casi listo. Aunque conectar una integración a perfiles y habilitar el acceso API proporciona acceso automático a todos los perfiles mediante llamadas API, esto no ocurre con los webhooks.

Para activar webhooks para una integración específica, ve a Perfiles de Eventos, selecciona un perfil, y dirígete a Geek > Integraciones. Desde allí, activa la integración deseada. Recuerda que solo puede estar activa una integración por perfil a la vez.

Anular la Integración Predeterminada de un Perfil para un Evento Específico

La buena noticia es que, independientemente de los webhooks activados para un perfil, puedes anularlos para un evento específico. Solo necesitas ir a la sección Geek > Integraciones en los ajustes del evento, seleccionar la integración que deseas aplicar, ajustar o sobrescribir los mapeos de campos si es necesario, e incluso elegir activar webhooks cuando se realice el pago de una inscripción.

¿Necesitas más personalización?

Si requieres procesamiento adicional o validación antes de enviar la carga útil, o mayor seguridad con SSL bidireccional, contacta a tu gerente de cuenta, quien enviará tu solicitud a nuestro equipo técnico.

Estamos comprometidos a ofrecer la mejor documentación posible, incluso para contenido técnico. Si tienes preguntas o sugerencias, no dudes en comunicarte con nosotros. Tus comentarios nos ayudarán a mejorar esta guía y la sección de preguntas frecuentes (FAQ).

¡A disfrutar!

El equipo de idloom