Crear y gestionar Webhooks

Pingen ofrece notificaciones automáticas a través de Webhooks para eventos importantes. Por ejemplo, se le informa en tiempo real tan pronto como se envía una carta, si presenta algún problema o si se ha marcado como no entregable. Esto le permite ejecutar automáticamente otras acciones sin tener que consultar activamente la API de Pingen para detectar cambios.

Crear Webhooks

Los Webhooks se pueden crear directamente en la aplicación Pingen a través del elemento de navegación «Administración de la Organización» --> «Webhooks», haciendo clic en el botón «Añada su primer Webhook».

A continuación, hay que seleccionar la categoría de evento deseada para el Webhook. Pingen ofrece las siguientes categorías de eventos:

• Problemas con documentos : Cualquier evento relacionado con problemas en el envío de una carta. Generalmente se debe a inconvenientes en el procesamiento, por ejemplo: si un PDF no está en formato A4, si un PDF contiene contenido en las zonas restringidas, si no hay Credits suficientes, etc.
• Documentos  enviados : Cualquier evento relacionado con la entrega postal, por ejemplo: si una carta ha sido enviada al servicio postal o si se ha recibido un identificador de seguimiento postal.
• Documentos no entregados: Cualquier evento relacionado con la información de si, y por qué, una carta no pudo ser entregada por el servicio postal.
• Documentos entregados: Cualquier evento relacionado con el envío de cartas con confirmación de entrega (como cartas certificadas).
• Suscripciones al canal: Eventos relacionados con la aceptación  o el rechazo de communicaciones a través de canales digitales especificos (por ejemplo eBill) por parte de los destinatarios

Una vez seleccionada una categoría de evento, es necesario especificar la URL del Webhook (la URL a la que Pingen debe enviar los Webhooks) y el secreto de firma. Es imprescindible que la URL del Webhook sea accesible a través del puerto 443. El Secreto se utiliza para garantizar que solo se procesen los datos procedentes de fuentes fiables. Se puede utilizar cualquier cadena de caracteres (32 caracteres como máximo) como Secreto. Si se especifica un Secreto, asegúrese de que este valor se valide durante el procesamiento de los Webhooks.

Gestionar los Webhooks

Se puede acceder a la gestión de los Webhooks directamente en Pingen a través del elemento de navegación «Organización de la Administración» --> «Webhooks», haciendo clic en el Webhook correspondiente:

La gestión de Webhooks ofrece un resumen de todas las solicitudes enviadas hasta el momento. Además, en la esquina superior derecha, también puedes enviar una solicitud de prueba y volver a enviar las solicitudes que hayan fallado.

La vista general muestra la información más importante, así como el estado de la solicitud. Las solicitudes pueden tener los siguientes estados:

• Éxito: El Webhook se ha transmitido con éxito
• Inténtalo de nuevo: l Webhook aún no se ha enviado con éxito. No obstante, Pingen puede volver a intentar el envío hasta 7 veces
• Fallido : El Webhook no se ha podido enviar correctamente a pesar de varios intentos

Al hacer clic en una consulta, se puede abrir la vista detallada de dicha consulta:

En la vista detallada, puedes ver tanto el contenido de la solicitud como la respuesta correspondiente de la URL de destino. Los Webhooks cuyo estado sea «Fallido» también se pueden volver a enviar directamente a través del enlace de la barra lateral.

Eliminar Webhooks

Los Webhooks se pueden eliminar directamente en Pingen a través del elemento de navegación «Administración de la Organización» --> «Webhooks». Basta con pasar el cursor por encima del Webhook deseado y hacer clic en el icono de la papelera.