Ir al contenido
PynPyn

Crea o sustituye el secreto de un webhook

Un webhook se crea en un formulario pero no acepta nada hasta que tiene un secreto. Generas el secreto desde el panel del webhook, lo copias en el sistema que llama y lo sustituyes si se filtra o el otro sistema lo pierde. El secreto se muestra una sola vez y no se puede volver a leer.

  • Eres admin u owner.
  • El webhook existe. Si no, abre el formulario en Forms, selecciona Settings en el carril y después Add Webhook.
  • Tienes un lugar seguro donde pegar el secreto, como el almacén de credenciales del sistema que llama.
The Webhooks view in Settings, listing the workspace's inbound webhooks.
Settings > General > Webhooks lists every inbound webhook created on a form.
  1. En Pyn, abre Settings en la navegación izquierda y después Webhooks bajo General.

  2. Selecciona el webhook. Se abre su panel; sin secreto dice “This webhook accepts nothing until it has a secret.”

  3. Selecciona Create Secret. El panel muestra el secreto con “Copy this secret now. It is shown once and cannot be retrieved later.” Si el secreto no se puede generar, un toast dice Could not create the secret y el panel se queda como estaba.

  4. Cópialo, guárdalo en el sistema que llama y después selecciona Done.

  5. Copia la URL que aparece bajo “Post a JSON body here, with the secret as a bearer token.” y configura el sistema que llama para que envíe Authorization: Bearer <secret> con un cuerpo JSON.

  6. Para rotarlo más adelante, selecciona Replace Secret. La confirmación advierte “The current secret stops working immediately. Anything calling this webhook will need the new one.” Selecciona Replace y copia el valor nuevo. Si el secreto no se puede sustituir, un toast dice Could not replace the secret y el antiguo sigue funcionando.

Con un secreto en su sitio, el panel dice “This webhook already has a secret. Replace it if the old one has been lost.” Envía una carga de prueba desde el otro sistema: la pestaña History la muestra en unos segundos con su resultado, submitted para una carga que se convirtió en un envío, o un código de motivo como unknown-subject. Una carga enviada con un secreto incorrecto o ausente se responde con 404 y no aparece en el registro.

  • Webhooks para la forma de la carga y los códigos de resultado.
  • Forms para crear el webhook y definir su subject.