Adios
← WORKFLOW / WEBHOOK

Trasforma gli eventi in arrivo in attività utili.

Ricevi un evento, trasforma i suoi dati e passali al servizio successivo.

IL FLUSSO

Dal trigger al risultato.

Un percorso tracciabile dall’evento in ingresso alla verifica della risposta del servizio successivo.

  1. 01 →

    Receive

    Definisci l’evento del webhook e i dati che la tua applicazione invia.

  2. 02 →

    Transform

    Analizza la richiesta e seleziona i campi necessari al passaggio successivo.

  3. 03 →

    Deliver

    Chiama l’endpoint di destinazione e verifica la risposta registrata.

USA QUESTA RICETTA

Il tuo workflow,
in YAML.

  • Imposta context.destination_url su un endpoint che accetta un ordine in formato JSON.
  • Crea API_TOKEN nei segreti di Adios. La destinazione deve accettarlo nell’header X-API-Key.
  • Invia un evento order.created con i dati di esempio mostrati accanto al YAML.
Configura i riferimenti ai segreti →

Copia o scarica il manifest, configura i valori e aggiungilo dalla sezione Workflow o dal tuo spazio di lavoro IA. Aprire la console non crea né abilita un workflow.

  1. Analizza richieste
  2. Trasforma JSON
  3. Chiama API
webhook-delivery.yaml
Scarica
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 }}"

Configurazione Configura l’URL di destinazione e il segreto API_TOKEN per l’header X-API-Key. Invia i dati di esempio con l’evento order.created.

Payload di un evento di esempio{"order":{"id":"ord_1042","total":49,"currency":"USD"}}

RISULTATO PREVISTO

Sappi cosa cercare.

Con l’evento di esempio, la destinazione riceve {"id":"ord_1042","total":49,"currency":"USD"}. Il passaggio deliver registra il corpo della risposta.

request-parser estrae i campi, ma non convalida lo schema di un ordine. Se i campi sono obbligatori, aggiungi la convalida nell’applicazione o in un passaggio script.

PROVA LA CONFIGURAZIONE

Verifica un’esecuzione completa.

  • Il corpo inviato deve contenere id, total e currency, senza l’oggetto order che li racchiude.
  • Gestisci gli ID degli ordini ripetuti a destinazione prima di collegare gli eventi reali. Questo esempio non li deduplica.
  • Prova un ordine mancante e una richiesta alla destinazione che fallisce, poi verifica l’errore del passaggio nella cronologia delle esecuzioni.
Adatta questa ricetta con il tuo agente IA

Aiutami a creare un workflow Adios per elaborare webhook. Prima chiedimi un esempio dei dati ricevuti, il nome dell’evento, l’endpoint di destinazione e i riferimenti ai segreti necessari. Usa un passaggio request-parser o data-json per selezionare i campi e un passaggio HTTP per consegnare il risultato. Spiega come verranno gestiti eventi duplicati ed errori. Mostrami il workflow e un piano di prova prima di creare o attivare qualsiasi cosa. Non inviare dati reali dei clienti durante le prove.

Apri Workflow ↗

CONTINUA A COLLEGARE

Altre ricette di workflow.