Adios
← FLUJOS DE TRABAJO / WEBHOOK

Convierte los eventos entrantes en trabajo útil.

Recibir un evento, transformar su carga útil, y entregarlo al siguiente servicio.

EL FLUJO

Del activador al resultado.

Un camino trazable desde un evento entrante hasta una respuesta comprobada del servicio de destino.

  1. 01 →

    Receive

    Define el evento webhook y la carga útil que envía tu aplicación.

  2. 02 →

    Transform

    Analiza la solicitud y selecciona los campos que necesita el siguiente paso.

  3. 03 →

    Deliver

    Llama a tu endpoint de destino e inspecciona la respuesta registrada.

USA ESTA RECETA

Tu flujo de trabajo,
en YAML.

  • Establece context.destination_url en un endpoint que acepte un pedido como JSON.
  • Crea API_TOKEN en los secretos de Adios. El destino debe aceptarlo en la cabecera X-API-Key.
  • Envía un evento order.created con la carga útil de ejemplo que aparece junto al YAML.
Configurar referencias a secretos →

Copia o descarga el manifiesto, configura tus valores y añádelo a través de Flujos de trabajo o de tu espacio de trabajo de IA. Abrir la consola no crea ni activa un flujo de trabajo.

  1. Analizar peticiones
  2. Transformar JSON
  3. Llamar a API
webhook-delivery.yaml
Descargar
workflow_id: webhook-delivery
title: Route a webhook
enabled: true
triggers:
  - type: webhook
    event: order.created

context:
  destination_url: https://api.example.com/orders

steps:
  - step_id: parse
    kind: request-parser
    command:
      extract:
        order: .payload.order

  - step_id: order
    kind: data-json
    dependencies: [parse]
    command:
      from_step: parse
      path: .order

  - step_id: deliver
    kind: http
    dependencies: [order]
    command:
      method: POST
      url: "{{ .context.destination_url }}"
      headers:
        X-API-Key: secret://API_TOKEN
      body: "{{ .steps.order.output }}"

Configuración Configura la URL de destino y el secreto API_TOKEN para la cabecera X-API-Key. Envía los datos de ejemplo con el evento order.created.

Datos de evento de ejemplo{"order":{"id":"ord_1042","total":49,"currency":"USD"}}

RESULTADO ESPERADO

Saber qué buscar.

Con el evento de ejemplo, el destino recibe {"id":"ord_1042","total":49,"currency":"USD"}. El paso deliver registra el cuerpo de su respuesta.

request-parser extrae campos; no valida un esquema de pedidos. Añade validación en tu aplicación o en un paso de script si hay campos obligatorios.

PRUEBA TU CONFIGURACIÓN

Comprueba una ejecución completa.

  • El cuerpo entregado debe contener id, total y currency, sin el objeto order que los envuelve.
  • Gestiona los ID de pedidos repetidos en el destino antes de conectar eventos reales. Este ejemplo no los deduplica.
  • Prueba un pedido ausente y una solicitud fallida al destino; después inspecciona el error del paso en el historial de ejecución.
Adapta esta receta con tu agente de IA

Ayúdame a crear un flujo de trabajo de procesamiento de webhooks en Adios. Primero pide una carga útil de ejemplo, el nombre del evento, el endpoint de destino y las referencias a secretos necesarias. Usa un paso request-parser o data-json para seleccionar los campos y un paso HTTP para entregar el resultado. Explica cómo se gestionarán los eventos duplicados y los fallos. Muéstrame el flujo de trabajo y un plan de pruebas antes de crear o activar nada. No envíes datos reales de clientes durante las pruebas.

Abrir Flujos de trabajo ↗

SIGUE CONECTANDO

Más recetas de flujo de trabajo.