Ir al contenido
PynPyn

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.

The Webhooks view in Settings, listing the workspace's inbound webhooks.
Settings > General > Webhooks lists every inbound webhook created on a form.
  • El endpoint es POST /api/webhook/<webhook id> con la cabecera Authorization: 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_id y las respuestas bajo fields. 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 202 en cuanto se acepta; la pestaña History es el registro de lo que fue de cada carga. Las entradas llevan un código como submitted, unknown-subject, missing-fields, invalid-fields, ambiguous-fields o already-submitted.
  • Envía una cabecera Idempotency-Key para que los reintentos sean seguros: una repetición de la misma clave se responde otra vez con 202 pero 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.
  • 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ú …

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.