DocumentaciónAyuda

Rotar o desactivar el webhook

Genera una URL y un secreto nuevos si el secreto se perdió o se expuso, o desactiva el webhook para dejar de recibir eventos.

En esta página

Rotar el webhook reemplaza su URL y su secreto por unos nuevos: los anteriores dejan de funcionar al instante. Desactivarlo hace que la URL deje de aceptar eventos, sin borrar la integración ni sus eventos.

Antes de empezar

  • Necesitas el rol Administrador. Con otro rol, estos botones no aparecen en la tarjeta.

  • Coordina con quien administra el sistema externo: después de rotar, tendrá que configurarlo con los datos nuevos.

Rotar el webhook

Hazlo si perdiste el secreto, si crees que alguien más lo conoce o como parte de tu cambio periódico de llaves.

  1. Entra a Configuración → Integraciones.

  2. En la tarjeta de la integración, presiona Rotar.

  3. Confirma en ¿Rotar el webhook de "…"? con Sí, rotar. El aviso recuerda que el sistema externo dejará de poder enviar eventos hasta que lo configures con los datos nuevos.

  4. Se abre Webhook activado con la URL y el secreto nuevos. Cópialos y configura tu sistema, como en Activar el webhook y enviar eventos.

  5. Presiona Ya lo copié, cerrar y, en ¿Ya copiaste el secreto?, confirma con Sí, cerrar.

Entre la rotación y la reconfiguración del sistema externo, sus eventos se rechazan y no quedan registrados. Ten listo el cambio en el otro sistema antes de rotar.

Desactivar el webhook

Hazlo cuando dejes de usar el sistema o quieras cortar el envío de eventos de inmediato.

  1. En la tarjeta de la integración, presiona el botón Desactivar webhook (junto a Rotar).

  2. Confirma en ¿Desactivar el webhook de "…"? con Sí, desactivar. El aviso recuerda que podrás volver a activarlo después, con un secreto nuevo.

Verás Webhook desactivado. y el campo Webhook de la tarjeta dirá Desactivado.

Volver a activarlo

Presiona Webhook en la tarjeta. Se generan de inmediato una URL y un secreto nuevos y se abre Webhook activado: la URL y el secreto anteriores no se recuperan.

Si solo quieres dejar de recibir eventos por un tiempo y conservar la misma URL y secreto, edita la integración y cambia su Estado a Pausada. Ver Editar, pausar o eliminar una integración.

Qué pasa después

Los eventos que ya llegaron se conservan en Eventos recibidos. Mientras el webhook está desactivado, los envíos del sistema externo se rechazan.

Relacionado

Buscar en SofIA Gestión

Escribe al menos 2 letras para buscar en SofIA Gestión.

↑↓ moverse · Enter abrir · Esc cerrar