Quando viene ricevuto un webhook

​

Creare con l’IA

​

Configurazione

​

Come configurarlo

1. Apri l’Automazione e aggiungi un nuovo trigger.
2. Seleziona Quando viene ricevuto un webhook.
3. Il trigger genera immediatamente un URL webhook univoco. Copialo: ti servirà per il sistema esterno.
4. (Facoltativo ma consigliato) Fai clic su Genera token per abilitare l’autorizzazione con Token Bearer. Viene prodotto un token che deve essere incluso nell’intestazione Authorization delle richieste in arrivo.
5. Salva e attiva l’Automazione.
6. Configura il sistema esterno affinché invii una richiesta POST all’URL webhook. Se hai abilitato l’autorizzazione, includi il token nell’intestazione.
7. Invia una richiesta di prova (consulta gli esempi seguenti). Controlla la cronologia delle esecuzioni dell’Automazione per verificare che i dati siano stati ricevuti correttamente.
8. Aggiungi i passaggi delle azioni. Fai clic su + in qualsiasi Campo di un’azione per fare riferimento ai valori del corpo JSON del webhook.

​

Dati disponibili per i passaggi successivi

{
  "order_id": "12345",
  "customer": "Alice",
  "amount": 99.95
}

​

Personalizzare la risposta

{"challenge":"{{body.challenge}}"}

​

Provare il webhook

curl -X POST https://your-teable-instance.com/api/webhook/base/bseXXXXXXXXXXXX/workflow/wflXXXXXXXXXXXX \
  -H "Content-Type: application/json" \
  -d '{"test": true, "message": "Ciao da curl"}'

curl -X POST https://your-teable-instance.com/api/webhook/base/bseXXXXXXXXXXXX/workflow/wflXXXXXXXXXXXX \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer your-generated-token" \
  -d '{"order_id": "12345", "status": "paid"}'

curl -X POST https://your-teable-instance.com/api/webhook/base/bseXXXXXXXXXXXX/workflow/wflXXXXXXXXXXXX \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer your-generated-token" \
  -d '{
    "event": "invoice.paid",
    "data": {
      "invoice_id": "INV-001",
      "amount": 250.00,
      "currency": "USD",
      "customer_email": "alice@example.com"
    }
  }'

​

Limiti di frequenza

​

Procedure consigliate per la sicurezza

• Usa sempre l’autorizzazione tramite Token Bearer per i webhook di produzione. Chiunque scopra un URL webhook pubblico può attivarlo.
• Mantieni privato l’URL webhook. Trattalo come una password. Non eseguirne il commit in repository pubblici e non condividerlo in canali aperti.
• Rigenera il token se sospetti che sia stato compromesso. Puoi generare un nuovo token dal pannello del trigger in qualsiasi momento.
• Convalida i dati nel workflow. Non presumere che i dati in arrivo siano ben formati. Usa filtri o passaggi di script per verificare la presenza dei Campi obbligatori prima dell’elaborazione.
• Monitora la cronologia delle esecuzioni. Controlla regolarmente i log di esecuzione dell’Automazione per individuare richieste impreviste o non autorizzate.

​

Quando utilizzarlo

• Ricevere eventi di pagamento da Stripe o PayPal. Configura un webhook Stripe affinché invii eventi invoice.paid all’Automazione Teable, creando o aggiornando automaticamente i Record degli ordini.
• Accettare gli invii dei moduli dal tuo sito web. Indirizza il modulo di contatto o di registrazione del sito all’URL webhook per creare Record direttamente in Teable.
• Acquisire dati da dispositivi IoT. Sensori o dispositivi in grado di inviare richieste HTTP possono trasmettere i dati a Teable per il monitoraggio e gli avvisi.
• Collegare pipeline CI/CD. Attiva workflow quando una build riesce o non riesce: crea Record, invia notifiche o aggiorna lo stato del progetto.
• Ricevere eventi da qualsiasi strumento SaaS. Molti strumenti (GitHub, Jira, Shopify, Twilio e altri) supportano le notifiche webhook. Indirizzale al webhook Teable per automatizzare workflow tra strumenti diversi.

​

Suggerimenti

• Il webhook accetta soltanto richieste POST. GET, PUT e gli altri metodi non attivano l’Automazione.
• Invia sempre un’intestazione Content-Type: application/json. Se il corpo non contiene JSON valido, il trigger potrebbe non analizzare correttamente i dati.
• Se devi inviare dati da un sistema che non supporta intestazioni personalizzate (per l’autorizzazione Bearer), valuta la modalità pubblica aggiungendo però nel corpo JSON una chiave segreta che il workflow convalidi tramite un filtro o uno script.
• Per il debug, puoi usare servizi come webhook.site per esaminare ciò che il sistema esterno invia effettivamente prima di indirizzarlo a Teable.

​

Contenuti correlati

• Azione Richiesta HTTP — la controparte in uscita: chiama API esterne dal workflow
• Esegui script — per l’elaborazione avanzata dei payload webhook
• Azione Ciclo (batch) — elabora gli array nei payload webhook