Webhooks
Un webhook de entrada es una dirección a la que otro sistema envía JSON. Cada webhook pertenece a un formulario: una carga que llega se convierte en un envío de ese formulario para el empleado que nombra la carga, y ese envío puede disparar una automation. Los webhooks se crean en el formulario, en su panel lateral Webhook; Settings los enumera todos en un solo sitio.

Cómo funciona un webhook
Sección titulada «Cómo funciona un webhook»- El endpoint es
POST /api/webhook/<webhook id>con la cabeceraAuthorization: Bearer <secret>y un cuerpo JSON. El panel muestra la URL y la Header que hay que enviar: “Post a JSON body here, with the secret as a bearer token.” - El cuerpo nombra al empleado con
subject_idy las respuestas bajofields. El ajuste Subject del formulario dice de qué sistema de origen viene ese id, por ejemplo un id de empleado de BambooHR. - Cada llamada se responde con
202en cuanto se acepta; la pestaña History es el registro de lo que fue de cada carga. Las entradas llevan un código comosubmitted,unknown-subject,missing-fields,invalid-fields,ambiguous-fieldsoalready-submitted. - Envía una cabecera
Idempotency-Keypara que los reintentos sean seguros: una repetición de la misma clave se responde otra vez con202pero no se procesa una segunda vez. - Una carga que Pyn no pudo aceptar genera un aviso en Notices; un llamador que repite un mismo error actualiza un único aviso en lugar de generar muchos. También se puede enviar un correo a los administradores; consulta Configura los correos de notificación.
- Un webhook no acepta nada hasta que tiene un secreto, y un webhook archivado deja de aceptar cargas.
Qué puedes hacer aquí
Sección titulada «Qué puedes hacer aquí»- Crea o sustituye el secreto de un webhook
- Renombrar un webhook desde su panel: edita el Title y pulsa Enter, o haz clic fuera, para guardar
- Leer el History de cargas y exportar todo el registro como CSV desde el panel lateral Webhook del formulario
- Archivar un webhook desde su menú …
Dónde está en la app
Sección titulada «Dónde está en la app»Abre /settings/general/webhooks en Pyn, o abre Settings en la navegación principal y selecciona Webhooks bajo General. Para crear un webhook, abre el formulario en Forms, selecciona Settings en el carril y después Add Webhook.
Relacionado
Sección titulada «Relacionado»- Crea o sustituye el secreto de un webhook antes de la primera carga.
- Forms para crear el webhook y elegir su subject.
- Notices para las cargas que Pyn no pudo aceptar.