Crea un Webhook
- Vai a Impostazioni → API e Webhook → Webhook
- Clicca su + Crea webhook
- Inserisci l’URL del tuo webhook (deve essere pubblicamente accessibile)
- Clicca su Salva
Gestisci Webhook
Modifica: Fai clic sul webhook → Aggiorna URL → Salva Elimina: Fai clic sul webhook → Elimina → ConfermaEventi
Twenty invia webhook per questi tipi di eventi:
Tutti i tipi di eventi vengono inviati all’URL del tuo webhook. Il filtraggio degli eventi potrebbe essere aggiunto nelle versioni future.
Formato del payload
Ogni webhook invia una richiesta HTTP POST con un corpo JSON:Rispondi con uno status HTTP 2xx (200-299) per confermare la ricezione. Le risposte non 2xx vengono registrate come errori di consegna.
Convalida del Webhook
Twenty firma ogni richiesta webhook per motivi di sicurezza. Convalida le firme per assicurarti che le richieste siano autentiche.Intestazioni
Passaggi di convalida
- Ottieni il timestamp da
X-Twenty-Webhook-Timestamp - Crea la stringa:
{timestamp}:{JSON payload} - Calcola HMAC SHA256 usando il segreto del tuo webhook
- Confronta con
X-Twenty-Webhook-Signature
Esempio (Node.js)
Webhooks vs Workflows
Per la ricezione di dati esterni, vedi Configura un trigger webhook.