Documentazione

Webhook — Panoramica e configurazione Pro

I webhook Savebase collegano la libreria a strumenti di automazione come Zapier, Make, Slack, Airtable, Discord o il tuo backend. Quando un post viene salvato, taggato, eliminato o ripristinato, Savebase invia un HTTP POST all’endpoint registrato.

Funzione Pro

I webhook sono disponibili con Pro e Lifetime. Passa al piano superiore in savebase.space/pricing.

Panoramica

Quando si verifica un evento, Savebase invia un payload JSON firmato a tutti gli endpoint attivi registrati per quell’evento. Puoi registrarne più di uno, ad esempio uno per integrazione.

Configurare un webhook

1

Vai su Impostazioni → Webhook

Vai a Dashboard → Settings → Webhooks.
2

Fai clic su Aggiungi webhook

Inserisci l’URL dell’endpoint (deve essere HTTPS), un’etichetta facoltativa e seleziona gli eventi a cui iscriverti.
3

Copia il segreto di firma

Dopo aver creato il webhook, mostra e copia il Segreto di firma. Usalo per verificare che le richieste provengano da Savebase.
4

Prova l’endpoint

Fai clic su Invia evento di prova per inviare subito dati di prova.

Eventi supportati

EventoQuando si attiva
post.savedUn nuovo post viene aggiunto alla tua libreria
post.taggedViene aggiunto un tag a un post
post.deletedUn post viene spostato nel cestino
post.restoredUn post viene ripristinato dal cestino

Formato del payload

Tutti gli eventi condividono lo stesso contenitore JSON:

bash
{
  "event": "post.saved",
  "timestamp": "2026-03-11T12:00:00.000Z",
  "data": {
    "id": 123,
    "url": "https://x.com/user/status/...",
    "title": "Post title or null",
    "source": "x",
    "author_name": "username",
    "tags": ["design", "ai"],
    "saved_at": "2026-03-11T12:00:00.000Z"
  }
}

Integrazione Zapier

1

Crea un nuovo Zap

In Zapier, fai clic su Create Zap e cerca Webhooks by Zapier come app trigger.
2

Scegli Catch Hook

Seleziona Catch Hook. Zapier genererà un URL webhook univoco.
3

Registra l’URL in Savebase

Copia l'URL di Zapier in Settings → Webhooks e seleziona gli eventi.
4

Prova il trigger

Salva un post. Zapier rileva il payload: associa data.url, data.title e così via ai passaggi delle tue azioni.
5

Aggiungi la tua azione

Collega qualsiasi azione Zapier: riga Google Sheets, messaggio Slack, pagina Notion, post Discord.

Nessuna verifica nativa della firma in Zapier

Aggiungi un passaggio Filter o Code in Zapier per verificare il X-Savebase-Signature header se serve la verifica di sicurezza.

Make (Integromat)

1

Crea un nuovo scenario

In Make, aggiungi un Webhook → Webhook personalizzato modulo trigger.
2

Registrati in Savebase

Copia l'URL di Make in Settings → Webhooks.
3

Determinare la struttura dei dati

Salva un post in Savebase: Make rileva automaticamente la struttura del payload.
4

Crea il tuo scenario

Mappa data.url, data.source e altri campi ai moduli successivi, come Airtable, Notion o email.

Precedente

Risoluzione dei problemi

Avanti

Sicurezza e firma HMAC