Panoramica

Test Action è una funzionalità di test in tempo reale disponibile su ogni step di azione per app esterne nel Workflow Builder. Quando clicchi il pulsante Test Action su una scheda di configurazione azione, il builder esegue quell'azione sull'app connessa come una vera chiamata API, usando i valori di input risolti, il tuo account connesso e lo stesso percorso di esecuzione che verrà usato a runtime. La risposta torna in un pannello laterale (Test Drawer) sul lato destro con due sezioni: Data In (cosa è stato inviato) e Data Out (la risposta grezza del provider, con i campi chiave mostrati come chip e card sopra il JSON).

Se il test ha successo, puoi cliccare "Use this as sample" per bloccare la risposta come schema indirizzabile — ogni campo, inclusi array e oggetti annidati, diventa disponibile come riferimento nei successivi step di azione e nei rami condizionali.

Informazioni su Test Action

Test Action fa parte delle funzionalità principali del Workflow Builder. È disponibile su ogni azione per app esterne — in tutte le integrazioni installate — e sostituisce il vecchio flusso di lavoro "pubblica, iscrivi un contatto di test, guarda i log" con un flusso di validazione pre-pubblicazione direttamente nel builder.

  • Disponibile su: ogni step di azione per app esterne (Find Contact, Create Card, Send Message, Update Record, e così via per tutte le integrazioni).

  • Esecuzione: chiamata API reale verso il provider live usando lo stesso account connesso che l'azione userà a runtime.

  • Output: un pannello laterale che mostra Data In, Data Out e (in caso di successo) l'opzione per bloccare la risposta come schema indirizzabile.

Prima di testare: prerequisiti

Un test verrà eseguito solo se sono soddisfatte le seguenti condizioni:

  • Account connesso — l'integrazione deve essere collegata tramite OAuth o API key nel menu a tendina "Connected Account" dell'azione. Un test non può essere eseguito con un account disconnesso.

  • Campi obbligatori — ogni input richiesto sull'azione deve essere compilato (valore letterale o variabile del workflow). Il pulsante Test rimane disabilitato finché gli input obbligatori non sono completi.

  • Custom value upstream risolvibili — se l'azione fa riferimento all'output di uno step di azione precedente, quello step precedente deve avere un sample salvato o deve essere stato testato in precedenza. Il builder ti chiede di fornirne uno se manca.

  • Accesso alla rete — Test Action effettua una vera chiamata API in uscita. Se il provider non è disponibile o il tuo account ha superato i limiti di frequenza, il test fallirà con il codice di errore del provider mostrato nel pannello.

Come eseguire un test

Step 1: Configura l'azione

  1. Apri il workflow e clicca sullo step di azione che vuoi testare (o aggiungine uno nuovo).

  2. Scegli l'integrazione e l'azione dal tab "Apps" — ad esempio, "Find Contact in Klaviyo" o "Create Card in Trello".

  3. Mappa ogni input obbligatorio — valori letterali, variabili del workflow o riferimenti agli output di azioni precedenti.

Step 2: Clicca Test Action

  1. Trova il pulsante "Test Action" sulla scheda di configurazione dell'azione. Si attiva una volta soddisfatti tutti i prerequisiti.

  2. Cliccalo. Il Test Drawer scorre in dal lato destro con un indicatore di avanzamento.

Step 3: Conferma se l'azione ha effetti collaterali

  1. Se l'azione crea o modifica dati nell'app connessa (Create Contact, Create Card, Update Record, Send Message, ecc.), appare un popup di conferma.

  2. Il testo del popup recita: "This action will actually perform a live test that may create or modify data in the connected app."

  3. Clicca "Yes, Run Test" per procedere, o "Cancel" per annullare. Il focus predefinito è su Cancel — le pressioni accidentali di Invio non avviano il test.

Step 4: Esamina Data In e Data Out

  1. In caso di chiamata riuscita, il pannello mostra Data In (gli input risolti inviati al provider) e Data Out (la risposta grezza del provider).

  2. I campi chiave appaiono come chip e card sopra il JSON; scorri attraverso il JSON espandibile per il payload completo.

  3. Clicca "Use this as sample" per bloccare lo schema di risposta per i passaggi successivi.

Step 5: Salva e continua

  1. Salva l'azione. I passaggi successivi possono ora fare riferimento a qualsiasi campo nello schema bloccato per nome.

  2. Se il test è fallito, correggi il campo problematico (evidenziato nella configurazione dell'azione) e clicca di nuovo "Test Action". Il pannello supporta un numero illimitato di nuovi test.

Schermata 1 — Test Action per le Integrazioni

Interpretare il Test Drawer

Il Test Drawer è composto da tre aree, dall'alto verso il basso:

  • Intestazione di stato — mostra l'esito (Success, Failure o In Progress), il codice di stato HTTP e la durata della chiamata.

  • Pannello Data In — gli input risolti inviati al provider. Questo è il payload post-interpolazione, non i campi del form che hai digitato. Usalo per verificare che le sostituzioni di variabili e le trasformazioni si siano risolte come previsto.

  • Pannello Data Out — la risposta grezza del provider. I campi chiave appaiono come chip e card sopra un albero JSON espandibile per un'ispezione completa. I payload di grandi dimensioni scorrono all'interno del pannello.

In caso di test riuscito, il pulsante "Use this as sample" appare in fondo al pannello. In caso di test fallito, il pannello mostra invece una card di errore strutturata — vedi la sezione Gestire i Fallimenti del Test di seguito.

Schermata 2 — Test Action per le Integrazioni