Integración con Webhooks Seguir
¿Qué es un Webhook?
Un Webhook es un sistema utilizado por una aplicación para enviar información en tiempo real a otras aplicaciones. Un webhook envía la información al mismo tiempo en que ésta se registra, lo que significa que te permite obtener la información al momento.
Hemos desarrollado los webhooks de Easypromos para enviar en tiempo real la información que se obtiene en un promoción a un sistema externo, para que así los organizadores de la promoción puedan programarse integraciones más avanzadas.
Ejemplo de casos de usos de webhooks en Easypromos:
- Recibir en tiempo real la información de un usuario nuevo que se registra en un concurso para añadirla en un CRM.
- Recibir en tiempo real la información del premio ganado por un usuario cuando gira una ruleta de premios para procesar el premio.
NOTA: La integración con webhooks está disponible únicamente para las promociones creadas con la versión Marca Blanca de la plataforma.
A continuación te explicamos cómo habilitar la integración con webhook en tu aplicación.
Tipos de eventos de los webhooks de Easypromos
Puedes utilizar los webhooks de Easypromos para configurar y recibir notificaciones cuando ocurre un evento específico.
Existen 2 tipos de eventos:
- Webhook al registrar un nuevo usuario: se enviará la información de un usuario nuevo que se registra en la promoción. En caso que el usuario tenga que validar su email para registrarse, el webhook se enviará cuando el usuario valide su email. Este webhook es ideal para recibir la información de los usuarios registrados en tiempo real e insertarlos en un CRM o un sistema de gestión de usuarios.
- Webhook al registrar una nueva nueva participación de usuario: se enviará la información concreta de la participación de un usuario. Por ejemplo, se envía la información del premio ganado por un usuario al girar una ruleta, o al jugar al rasca y gana, o se enviará los puntos obtenidos por un usuario en un juego.
Antes de Empezar
Antes de iniciar el proceso deberás tener en cuenta los siguientes puntos:
- La integración con webhooks es una funcionalidad avanzada y, por lo tanto, se deben tener conocimientos avanzados en programación o bien contar con un desarrollador.
- Necesitas disponer de un servidor que acepte llamadas HTTP POST, así como poder escribir un script que realice una acción como respuesta.
- Los webhooks únicamente se pueden configurar en promociones del tipo Marca Blanca
- Puedes tener múltiples webhooks en una mismo promoción, por si quieres enviar la información en tiempo real a varios destinos.
Integrarse con los webhooks consta de 2 pasos:
-
- Paso 1 - Preparar la promoción para que envíe el webhook: lo debe hacer la persona de Marketing que está configurando la promoción desde la interfaz de gestión de Easypromos.
- Paso 2 - Programar la recepción y el proceso del webhook: lo debe hacer la persona de Informática que programará el script o programa que recibirá el webhook, y procesará su información.
Paso 1 - Preparar la promoción para que envíe el webhook
Para realizar este paso es necesario tener acceso al panel de gestión de la promoción en Easypromos. Este paso lo realizará normalmente la persona de marketing que gestiona la promoción y tiene acceso a Easypromos.
Para preparar la promoción para que se envíen los webhook deberá habilitarse la integración con webhooks desde el panel de gestión de la promoción en Easypromos. Deberás seguir estos pasos:
1. Accede a la página de gestión de la promoción y haz clic en ‘Integraciones’:
2. A continuación, haz clic en la imagen de ‘Webhooks’ para habilitar la integración:
3. Accederás a la página de configuración de la integración con webhooks, donde podrás configurar las opciones siguientes:
a) Webhook Version: Selecciona la versión en como quieres recibir la información de los Webhooks.
- Versión 2.0 (recomendada): es la versión disponible desde Abril 2022. Su definición y especificación sigue el estándar Openapi 3.1-
- Versión 1.0 (obsoleta): versión inicial de los Webhook de Easypromos que se mantiene para compatibilidad con promociones e integraciones antiguas.
b) Webhook URL: Es la URL donde enviremos la información.
c) Webhook Key (opcional): Opcionalmente puedes añadir una referencia al Webhook a través de este campo de texto alfanumérico. Este campo se enviará junto con la información del Webhook. Utilízalo para validar que el Webhook realmente lo envía Easypromos.
d) Webhook Type: Es el tipo de evento que dispara el webhook. Tienes dos opciones:
- On register a new user: Se dispara el Webhook cuando se registra un nuevo usuarios en la promoción. El Webhook incluye toda la información de registro del usuario.
- On register a new participation from a user: Se dispara el Webhook cuando se registra una nueva participación de un usuario en la promoción. El Webhook incluye la información de la participación, la del usuario participante, e incluye la información del premio, si la participación ganó un premio. Este tipo de evento, únicamente está disponible en promociones que tengan habilitado el sistema de Login.
Paso 2 - Programar la recepción y proceso del webhook
Para realizar este paso es necesario tener conocimientos de programación web. Este paso lo realizará el programador que desarrollará la integración de la información obtenida en Easypromos con un sistema externo.
La información se enviará en peticiones HTTP_POST y el cuerpo del mensaje (payload) vendrá en formato JSON.
La especificación de la información del webhook ha sido definida siguiendo el estándar OpenApi 3.1. A continuación te presentamos el acceso a la especificación:
- On register a new user: ver documentación y ejemplos.
- On register a new participation: ver documentación y ejemplos.
Consideraciones en el desarrollo:
- El sistema considerará el intento de envío del webhook erróneo si la url en destino no responde en 5 segundos
- El sistema realizará 3 reintentos seguidos en caso de intento errónea. Tras 3 intentos erróneos, se descartará la tarea, y no se volverá a enviar.
¿Puedo testear o validar los webhooks?
Sí, puedes utilizar servicios online gratuítos como por ejemplo requestbin.com para testear los webhooks:
- Abre requestbin.com
- Haz click en Crear nuevo Request. Deberás identificarte con una cuenta de Github o Google.
- Copia la URL del Request creada en tu configuración de webhook
A continuación participa en la promoción y verifica el webhook recibido en requestbin.com:
¿Puedo editar o eliminar un webhook?
Si, una vez que hayas creado los diferentes webhooks, en la página de integraciones/webhooks, se visualizarán todos los webhooks que hay creados. Se podrán editar y o eliminar. Se verán en una lista, y con la tipología de cada uno de los webhooks (si es un webhook de usuarios únicos o de participaciones).
Comentarios
0 comentarios
Inicie sesión para dejar un comentario.