Webhooks

Aprenda a crear y personalizar los Webhooks en su Programa de Referidos

¿Qué es un Webhook?
Los webhooks son "devoluciones de llamada HTTPS definidas por el usuario" activadas por eventos en este caso desde su Programa de Referidos con Genius Referrals.

Algunos aspectos a tener en cuenta:

  • Se envía un HTTPS POST a cada URL de suscripción con datos relevantes, en formato JSON, cuando se activa un evento, por ejemplo, al registrar un nuevo miembro, bono o recompensa.
  • Al suscribirse a un Webhook, su aplicación puede ejecutar código inmediatamente después de que ocurran eventos específicos en su Programa de Referidos.
  • Se considera una entrega de un Webhook como "entregado correctamente" cuando Genius recibe un estado de respuesta 200. De lo contrario se reintenta entregar continuamente el Webhook después de un intervalo de tiempo determinado. Por 48 horas se reintenta entregar el Webhook, durante este período Genius intenta entregar el Webhook 20 veces en total:
1- Se espera 2 segundos al enviar si no hay respuesta o da error, Genius vuelve a intentar 4 veces en el primer minuto es decir cada 15 segundos y así hasta 1 minuto.
2- Las restantes 16 veces se enviaran en grupos de a 4 con 1 hora y media de diferencia entre cada grupo. El primer grupo se enviaran cada 1 hora y media y las 4 últimas cada 4 horas y media.
Tenga en cuenta: Para realizar pruebas a esta integración existen varios servicios en línea que puede utilizar para crear URLs de carga, como:
Creación de un Webhook
Al adicionar un webhook se enviará una solicitud POST a la URL que defina con detalles de cada evento seleccionado. Para crear un webhook primero debe:

  1. Iniciar sesión en su cuenta de Genius Referrals .
  2. Haga clic en la sección Integración ubicada en el menú de navegación del lado izquierdo.
  3. Desde ahí, dará clic en Webhooks, y luego en Agregar webhook. Accederá a una nueva pantalla para completar el proceso de creación. Siga los pasos a continuación.

Información General

  • URL de Carga
Debe introducir la URL del servidor que recibirá las solicitudes POST del webhook.

  • Tipo de contenido
A continuación, debe seleccionar que tipo de contenido que se entregara el contenido, pueden entregarse utilizando diferentes tipos de contenido:
  • El tipo de contenido application/json como solicitud POST.
  • El tipo de contenido application/x-www-form-urlencoded como parámetro de forma payload.

  • Seguridad- Secreto
El secreto en un Webhook es como una contraseña utilizada para evitar que otras aplicaciones envíen datos incorrectos a su URL de Carga. Le permite asegurarse que las solicitudes enviadas a la URL sean del destinatario correcto.

  • Eventos
Los eventos son el centro principal de los webhooks. Puede enviar todos los eventos o seleccionar que eventos en específico desea que sean enviados.

  • Activo
Indica si el Webhook esta activo o no. Puedes elegir inhabilitar la entrega de cargas de webhooks si deseleccionas "Activo".

  • Verificación SSL
Si tu "URL de carga" es un sitio seguro (HTTPS), deberás configurar los ajustes de verificación de SSL. En este caso tendrás dos opciones Habilitar e Inhabilitar la verificación SSL. Si tu URL no es segura (HTTP) esta opción no se mostrará. Se recomiendo siempre dejar habilitada.

Cuando termine, haga clic en el botón Guardar.
Edición y Eliminación de un Webhook

Los Webhooks se mostrarán en un listado en el cual desde las acciones de cada Webhook podrá Editar y Eliminar respectivamente.

  1. Busca el Webhook que deseas modificar.
  2. En las acciones aparecerán las opciones Editar y Eliminar.
  3. En el caso de Editar siempre recuerde guardar los cambios.
  4. Para Eliminar siempre se le pedirá confirmación antes de realizar la acción.
Entregas

Los Webhooks se mostrarán en un listado en el cual desde las acciones de cada Webhook podrá visualizar las Entregas.

  1. Busca el Webhook que deseas visualizar.
  2. En las acciones aparecerán varias opciones dentro de ellas Entregas.
  3. Se mostrara un listado de todas las entregas realizadas ordenas por fecha de entrega y el estado (Enviado-Reenviado-Fallo el envio respectivo de cada entrega.
Fallo el Envío
Reenviado
Enviado
Detalles de la entrega
Dentro de la lista de entregas podrás visualizar los detalles individuales de cada entrega. Incluyendo la solicitud y la respuesta.

  • Solicitud
La pestaña solicitud de entregas del Webhook te proporciona información sobre qué Encabezados se enviaron y los detalles acerca de la Carga útil de JSON.

  • Respuesta
La pestaña de respuesta lista la forma en que tu servidor respondió una vez que recibió la carga útil y el código de estado de la respuesta. Te proporciona información los Encabezados y a cualquier dato adicional dentro del Cuerpo de la respuesta.
  • Volver a entregar un Webhook
Si falla un envío, automáticamente el sistema lo enviará nuevamente teniendo en cuenta la frecuencia ya establecida en el sistema en este caso a los 30 segundos. Pero si desea reenviarlo nuevamente manualmente lo puede hacer siguiendo los siguientes pasos:

1- Dentro de la propia sección de detalles de entrega, haga clic en el evento "Volver a Entregar" para que se envié el evento de ese webhook nuevamente.
2- Confirmar la acción, recuerde que siempre se le pedirá confirmación antes de realizar la acción.
¿Fue útil esta página?
LANGUAGE