Ir al contenido
PynPyn

Crea un webhook

Algunas respuestas ya existen en otro sistema: una formación completada en tu LMS, una solicitud de equipo en una herramienta de tickets, un documento firmado. Un webhook en un formulario permite que ese sistema publique la respuesta en Pyn como un envío, que queda asociado al empleado que nombra.

  • Eres Admin.
  • El formulario está construido y publicado, con etiquetas de campo que tu otro sistema pueda mapear. Consulta Crea un formulario.
  • El otro sistema puede enviar el id de cada empleado en tu HRIS, el mismo id que Pyn tiene de esa integración.
The Settings drawer on a form with a webhook: the secret callout with Replace Secret, the Subject select set to Employee File ID, the example body and the log listing the recorded submissions and the rejected payload.
El panel lateral Settings de un formulario, con la URL, la cabecera, el sujeto y el cuerpo de ejemplo del webhook.
  1. En Pyn, abre Flows en la navegación izquierda, selecciona Forms y después el formulario.

  2. Selecciona Settings en la barra a la derecha del editor. El panel lateral dice Add a webhook to let another system submit this form on an employee’s behalf. Selecciona Add Webhook. Si el webhook no se puede añadir, un toast dice Could not add this webhook y el panel lateral se queda como estaba.

  3. En la parte superior del panel lateral, el aviso dice This webhook accepts nothing until it has a secret. Selecciona Create Secret; el aviso pasa a decir Copy this secret now. It is shown once and cannot be retrieved later. Cópialo en el otro sistema y después selecciona Done. Si el secreto no se puede generar, un toast dice Could not create the secret y el aviso se queda como estaba. Un webhook que ya tiene secreto dice This webhook already has a secret. Replace it if the old one has been lost. y ofrece en su lugar Replace Secret; mira más abajo.

  4. Bajo el aviso, copia la URL y anota la cabecera: Authorization: Bearer <secret>.

  5. En Subject, selecciona el sistema de origen cuyo id enviará el otro sistema, por ejemplo BambooHR Employee ID o Workday Worker ID. La descripción dice The submission is recorded against the employee holding this id.

  6. Lee el ejemplo bajo Post a body of this shape. Nombra cada campo por su alias (la etiqueta en camel case) con un valor de ejemplo, más subject_id.

  7. Envía una carga de prueba desde el otro sistema y lee el registro al pie del panel lateral (Payloads this webhook has taken, and what became of them.). Una entrada verde dice Recorded a submission for the … identifier …; una roja nombra el problema.

  • Replace Secret rota el secreto en un solo paso y el antiguo deja de funcionar de inmediato; actualiza el sistema que llama antes de confirmar.
  • El registro muestra las 20 entradas más recientes. En cuanto hay una entrada, un icono de exportación a su lado descarga el registro completo como pyn-webhook-log.csv (receivedAt, outcome, action, code, message, eventId, subjectId, submissionId).
  • Una carga descartada también genera un aviso en Notices, y el mismo error repetido mantiene un único aviso vigente en lugar de muchos; su fila ofrece Acknowledge y después Archive. La configuración de notificaciones del workspace decide si se envía un correo a todos los admins o solo al owner.

Las cargas aceptadas aparecen como envíos en el panel lateral Activity del formulario, y el registro del empleado lleva cualquier valor de Buddy o Mentor. Cada webhook admite un solo envío por empleado; una repetición se registra como already-submitted. API del webhook enumera el endpoint, las cabeceras, el cuerpo, las respuestas y todos los códigos del registro.