Integrazioni

Collega DiffHook ai tuoi strumenti e flussi di lavoro esistenti.

n8n

n8n è una piattaforma di automazione del flusso di lavoro open source. Utilizza DiffHook come trigger webhook per avviare qualsiasi flusso di lavoro n8n quando una pagina cambia.

Impostare

1. In n8n, crea un nuovo flusso di lavoro e aggiungi un nodo Webhook
2. Imposta il metodo su POST e copia l'URL del webhook generato
3. In DiffHook, incolla l'URL in webhook per monitor quando crei un monitor (memorizzato come notification_config.webhook_url nell'API) o imposta un'area di lavoro predefinita in Impostazioni → Integrazioni
4. Aggiungi nodi downstream per elaborare il payload differenziale: invia un messaggio Slack, crea una voce Notion, aggiorna un foglio di calcolo, ecc.

Verifica della firma in n8n

Aggiungi un nodo Funzione prima della logica principale:

const crypto = require('crypto')
const secret = $env.DIFFHOOK_SIGNING_SECRET
const sig = $input.first().headers['X-Signature']
const body = JSON.stringify($input.first().body)
const expected = 'sha256=' + crypto.createHmac('sha256', secret).update(body).digest('hex')
if (sig !== expected) throw new Error('Invalid DiffHook signature')
return $input.all()

---

Zapier

Connetti DiffHook a oltre 6.000 app tramite Zapier.

Impostare

1. In Zapier, crea un nuovo Zap e scegli Webhooks di Zapier come trigger
2. Seleziona Catch Hook e copia l'URL del webhook
3. Incollalo come URL webhook personalizzato del monitor in DiffHook (API: notification_config.webhook_url) o utilizza il webhook predefinito dell'area di lavoro
4. Attiva il monitor una volta (usa Attiva ora nella dashboard) in modo che Zapier catturi un payload di esempio
5. Associa i campi (diff.summary, url, triggered_at, ecc.) al tuo passaggio di azione

Idee utili per Zap

• DiffHook → Slack: pubblica riepiloghi delle modifiche su un canale dedicato
• DiffHook → Google Sheets: registra ogni modifica in un foglio di calcolo per il monitoraggio
• DiffHook → Gmail: invia tramite email un rapporto personalizzato alle parti interessate
• DiffHook → Jira: crea automaticamente un ticket quando cambia la pagina dei prezzi di un concorrente

---

Make (ex Integromat)

Impostare

1. In Make, crea un nuovo scenario e aggiungi un modulo Webhook → Webhook personalizzato
2. Copia l'URL del webhook e incollalo in DiffHook come webhook personalizzato del monitor (API: notification_config.webhook_url) o utilizza l'area di lavoro predefinita
3. Esegui Trigger now sul monitor in modo che Make possa determinare la struttura dei dati
4. Aggiungi ulteriori moduli per instradare il carico utile verso la destinazione desiderata

---

Slack (integrazione nativa)

DiffHook ha un'integrazione Slack nativa che non richiede un URL webhook. Vedere Canali di notifica per le istruzioni di configurazione.

---

Discord (integrazione nativa)

DiffHook ha un'integrazione Discord nativa utilizzando un flusso di codice bot + connessione. Vedere Canali di notifica per le istruzioni di configurazione.

---

Endpoint webhook personalizzato

Se stai creando la tua integrazione, DiffHook pubblica un payload JSON su qualsiasi URL HTTPS pubblico configurato per monitor.

Vedi Ricezione di webhook per lo schema completo del payload e Verifica le firme per l'autenticazione.

Esempio: salvare le modifiche in un database

app.post('/diffhook', express.raw({ type: 'application/json' }), (req, res) => {
  res.status(200).send('OK')                    // respond immediately

  const sig = req.headers['X-Signature']
  if (!verifySignature(req.body, sig, process.env.SECRET)) return

  const event = JSON.parse(req.body)
  db.insert('page_changes', {
    monitor_id:   event.monitor_id,
    url:          event.url,
    summary:      event.diff.summary,
    changed_at:   event.triggered_at,
  })
})

---

Prossimamente

Sono previste le seguenti integrazioni:

• Notion: scrivi i record di modifica direttamente in un database Notion
• Airtable: aggiungi righe a una base su ogni modifica rilevata
• Lineare: crea automaticamente problemi per le modifiche monitorate
• PagerDuty / OpsGenie: avvisa su chiamata per cambiamenti critici di pagina

Se hai bisogno di un'integrazione non elencata qui, contatta support@diffhook.com o vota su roadmap.