Webhooks

I webhook inviano un POST HTTPS al tuo server ogni volta che succede qualcosa in Serpfull. Gestiscili in Integrazioni → Webhook (proprietari e amministratori). Per il formato del payload, le intestazioni e il codice di verifica, consulta il riferimento API dei Webhook.

Aggiungi un endpoint

• Apri Integrazioni → Webhook e premi Aggiungi endpoint.
• Inserisci un URL https pubblico sulla porta 443. Indirizzi privati, interni, loopback, link-local e metadata cloud sono rifiutati (controlliamo ogni indirizzo a cui l'host risolve, al salvataggio e ad ogni consegna), e i reindirizzamenti non sono seguiti.
• Aggiungi una descrizione opzionale, scegli i siti web coperti (tutti i siti, inclusi quelli futuri, o solo alcuni selezionati) e seleziona gli eventi da inviare.
• Copia il segreto di firma mostrato dopo il salvataggio. Puoi rivelarlo di nuovo dalla scheda dell'endpoint, o ruotarlo.

Diversi endpoint

Aggiungi quanti endpoint il tuo piano permette (il miglior piano tra i tuoi siti): Nessun piano 2, Starter 3, Growth 5, Scale 10, Pro 25, Enterprise 50. Ognuno ha il proprio segreto, siti web ed eventi, e può essere disattivato senza eliminarlo.

Per sito web

Gli eventi relativi a un sito web vanno solo agli endpoint che lo coprono. Disattivare l'integrazione Webhook per un sito mette in pausa i suoi eventi ovunque senza toccare i tuoi endpoint. Gli eventi dell'organizzazione (fatturazione) vanno a ogni endpoint iscritto a essi.

Test, registro e reinvio

Inviare un evento di test mette in coda un test.ping a quell'endpoint. Il registro di consegna conserva 30 giorni di tentativi con evento, codice di stato o errore, durata, numero tentativo e i corpi della richiesta e risposta (troncati). Filtralo per endpoint, evento o risultato, e premi Reinvia per inviare di nuovo qualsiasi evento con un nuovo set di tentativi.

Tentativi e disattivazione

Rispondi con qualsiasi 2xx entro 10 secondi. Altrimenti ritentiamo dopo 1 minuto, 5 minuti, 30 minuti, 2 ore, 6 ore, 12 ore e 24 ore (8 tentativi, circa 45 ore). Rispondi 410 Gone per fermare i tentativi su quell'evento. Se un endpoint continua a fallire per 3 giorni (e almeno 10 tentativi consecutivi), lo disattiviamo, scartiamo gli eventi in coda e notifichiamo il tuo team nell'app. L'integrazione Webhook mostrerà quindi Attenzione richiesta. Risolvi il ricevitore e riattiva l'endpoint.

Rotazione del segreto

Ruotare il segreto ti fornisce un nuovo segreto immediatamente. Per le successive 24 ore ogni richiesta è firmata sia con il segreto nuovo che con quello vecchio (due valori v1), così puoi aggiornare il ricevitore senza perdere eventi.

Da un assistente

Il connettore AI ha webhooks_list_endpoints, webhooks_create_endpoint, webhooks_update_endpoint, webhooks_delete_endpoint, webhooks_send_test, webhooks_list_deliveries e webhooks_redeliver. I segreti sono mostrati solo nella dashboard.