Los webhooks notifican a servicios externos como clientes de chat u otras API externas sobre eventos. Un webhook puede establecer una URL cuando ocurre un evento específico.
Phrase Orchestrator proporciona un servicio que monitorea y procesa notificaciones de sistemas de terceros. Este servicio permite a los usuarios conectar sus flujos de trabajo con una amplia variedad de sistemas externos que admiten solicitudes HTTP.
Los usuarios pueden crear una nueva activación para webhooks entrantes a partir de eventos externos con el sistema generando automáticamente una URL de webhook única con clave API para configurar el webhook de terceros. La URL del webhook generada es única y está directamente asociada con la cuenta y el flujo de trabajo del usuario, lo que significa que cada webhook está vinculado a un solo flujo de trabajo.
Configurar webhook entrante
Para configurar un webhook entrante, sigue estos pasos:
-
Arrastra y suelta una activación en un flujo de trabajo.
La activación aparece en el flujo de trabajo.
-
Haz clic en la activación para abrir la pestaña .
-
Selecciona la pestaña .
-
Copiar la .
Esta URL debe considerarse un secreto y no compartirse. Si se comparte accidentalmente, haz clic en Regenerate para crear uno nuevo e invalidar el existente.
-
Para enviar una carga útil con datos para usar dentro de los flujos de trabajo, proporciona el esquema de esa carga útil.
-
Para proporcionar un esquema, haz clic en Edit webhook.
-
Selecciona un :
Esquemas JSON son un estándar para definir cargas útiles JSON. Si un servicio existente que los utiliza, o un servicio externo para conectarse a Orchestrator proporciona uno, cópialo tal cual.
-
JSON
Proporciona una carga útil JSON de muestra para una configuración más simple, permitiendo probar el webhook sin definir reglas exactas.
-
JSON Schema
Define con precisión la estructura, los tipos de datos y las reglas de validación para los datos JSON.
-
-
Haz clic en Save payload schema.
Se muestra una vista previa de la estructura de datos esperada para la activación del webhook.
-
-
Si es necesario, abre la pestaña para agregar filtros a la activación.
-
Para activar un flujo de trabajo una vez que se haya publicado, envía una solicitud POST a la URL del webhook. Para flujos de trabajo que no tienen un esquema configurado, el cuerpo debe estar vacío. Si se aplica un esquema configurado, la carga útil debe coincidir con el esquema.
Los usuarios pueden configurar flujos de trabajo que no solo reciben datos, sino que también envían actualizaciones a sistemas externos automáticamente. La acción de webhook saliente permite a los usuarios activar automáticamente acciones específicas en sistemas externos.
Los webhooks en otros servicios se pueden activar a través de la acción Enviar solicitud HTTP.
Configura un webhook saliente
Para configurar un webhook saliente, sigue estos pasos: