Skip to main content
Twenty invia un HTTP POST al tuo URL ogni volta che un record viene creato, aggiornato o eliminato. Tutti i tipi di oggetto sono supportati, inclusi gli oggetti personalizzati.

Crea un Webhook

  1. Vai a Impostazioni → API e Webhook → Webhook
  2. Clicca su + Crea webhook
  3. Inserisci l’URL del tuo webhook (deve essere pubblicamente accessibile)
  4. Clicca su Salva
Il webhook si attiva immediatamente e inizia a inviare notifiche.

Gestisci Webhook

Modifica: Fai clic sul webhook → Aggiorna URL → Salva Elimina: Fai clic sul webhook → Elimina → Conferma

Eventi

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

  1. Ottieni il timestamp da X-Twenty-Webhook-Timestamp
  2. Crea la stringa: {timestamp}:{JSON payload}
  3. Calcola HMAC SHA256 usando il segreto del tuo webhook
  4. Confronta con X-Twenty-Webhook-Signature

Esempio (Node.js)

Webhooks vs Workflows

Per la ricezione di dati esterni, vedi Configura un trigger webhook.