La mayoría de las automatizaciones se inician con un evento de tu salón. Hay dos disparadores que no: Webhook inicia una automatización cuando otro sistema envía una petición a su URL, por ejemplo un formulario de tu sitio web. Manual la inicia cuando haces clic en Ejecutar.
Antes de empezar
- Necesitas el rol Super administrador o Propietario.
- Tu salón necesita una suscripción activa.
- Crea una automatización desde cero. Consulta Crear una automatización desde cero.
Iniciar una automatización desde un webhook
- 1
Paso 1 de 4
Elige el disparador Webhook
Haz clic en el paso Iniciar automatización. Haz clic en el campo Disparador, elige Otros y después Webhook.
Verás:El cuadro de diálogo muestra una URL del webhook con un botón para copiarla.
- 2
Paso 2 de 4
Protege la URL con una condición
La URL del webhook es pública. Cualquiera que la tenga puede iniciar la automatización, así que añade una Condición que solo tu sistema pueda cumplir, por ejemplo un encabezado secreto.
Usa la pestaña Constructor, o escribe una expresión en la pestaña Expresión, como
{{ $request.headers.authorization === "Bearer your-secret" }}. Los nombres de los encabezados van en minúsculas. La automatización solo se inicia cuando toda la condición es verdadera.Haz clic en Guardar y después en Guardar en la parte superior del editor. Los cambios en el disparador solo se aplican después de guardar la automatización.
- 3
Paso 3 de 4
Usa los datos de la petición en tus pasos
La petición está disponible en el grupo de variables Solicitud:
{{ $request.body.phoneNumber }}: un campo del cuerpo de la petición{{ $request.query.source }}: un parámetro de consulta, de?source=...en la URL{{ $request.headers.authorization }}: un encabezado{{ $request.method }}: el método HTTP
Por ejemplo, usa
{{ $request.body.emailAddress }}como destinatario de un paso Enviar notificación. - 4
Paso 4 de 4
Envía una petición
Desde tu otro sistema, envía una petición POST con un cuerpo JSON o de formulario a la URL del webhook.
Verás:La respuesta tiene el estado 202 y un
executionId. Está vacío cuando no se cumplió la condición. La ejecución aparece en el Historial de la automatización.
Límites y errores del webhook
- Cada webhook acepta hasta 60 peticiones por minuto y 1.000 por hora. Las peticiones que superan el límite se rechazan.
- Si la automatización está desactivada, la petición se rechaza con un mensaje que indica que la automatización no está activa.
- Si la suscripción de tu salón no está activa, la petición se rechaza.
- Las cookies y los encabezados de sesión de Softalon no se transmiten a la automatización.
Iniciar una automatización manualmente
- 1
Paso 1 de 2
Elige el disparador Manual
Haz clic en el paso Iniciar automatización. Haz clic en el campo Disparador, elige Otros y después Manual. Guarda el paso y la automatización.
- 2
Paso 2 de 2
Ejecútala
En la página Automatizaciones, abre el menú de la tarjeta de la automatización y haz clic en Ejecutar. La opción solo aparece en las automatizaciones con el disparador Manual, y la automatización debe estar activa.
Verás:Un mensaje Workflow iniciado. La ejecución aparece en Historial.
Una ejecución manual no tiene evento, así que solo están disponibles las variables de Otros, como el nombre de tu salón. Los destinatarios tienen que ser direcciones fijas, como tu propio correo electrónico.
Preguntas frecuentes
No. La URL del webhook solo acepta peticiones POST.