Webhooksed eventi in RaiseNow Hub

Questo articolo spiega come le organizzazioni con piano Growth possono creare, gestire e monitorare i webhook in RaiseNow Hub. I webhook consentono di ricevere notifiche in tempo reale per eventi chiave, aiutando le organizzazioni a integrare in modo efficiente i dati di RaiseNow nei propri sistemi.

Cosa sono i webhook e gli eventi?

Un webhook è un messaggio automatico inviato da RaiseNow Hub a un URL definito quando si verifica un evento specifico.

Un evento è un'azione o un cambiamento nel sistema, ad esempio:

• Una nuova donazione

• Un pagamento riuscito

• Un abbonamento aggiornato

• Modifiche ai dati del sostenitore o dell'organizzazione

Invece di verificare periodicamente la presenza di aggiornamenti, il sistema riceve le informazioni non appena si verifica l’evento.

Come funziona

Accesso alla sezione Webhooks

1. Andare su Impostazioni in RaiseNow Hub.

2. Selezionare Webhooks.

Questa sezione contiene tutte le opzioni per creare, gestire e monitorare i webhook e gli eventi.

Creazione e gestione dei webhook

È possibile creare nuovi webhook per ricevere notifiche sugli eventi rilevanti per l’organizzazione, inclusi:

• Transazioni e pagamenti
• Abbonamenti
• Dati del sostenitore
• Modifiche relative all’organizzazione

Ogni webhook invia i dati dell'evento all'URL definito.

Per un elenco completo e aggiornato degli eventi supportati, consultare la Documentazione per sviluppatori.

Ricerca e filtro dei webhook

Per gestire più facilmente configurazioni complesse, è possibile cercare e filtrare i webhook esistenti.

I filtri disponibili includono:

• UUID
• URL del webhook
• Alias del webhook
• Nome dell'evento

Questo consente di individuare rapidamente configurazioni specifiche e di mantenere ordinata la configurazione dei webhook.

Visualizzazione dei log di consegna degli eventi

RaiseNow Hub conserva i log di consegna dei webhook per gli ultimi sei mesi.

È possibile utilizzare questi log per:

• Verificare se gli eventi sono stati consegnati con successo
• Controllare lo stato della consegna
• Risolvere eventuali problemi di consegna

I log degli eventi possono essere ricercati e filtrati per:

• Timestamp
• Nome dell'iscrizione all'evento
• URL del webhook
• Alias del webhook
• Stato della consegna
• UUID

Nuovo tentativo di invio degli eventi webhook non riusciti

Se la consegna di un evento webhook fallisce, puoi ritentarlo direttamente da RaiseNow Hub senza alcuna rielaborazione manuale al di fuori della piattaforma.

Come ritentare un evento

1. Andare su Impostazioni → Webhook.
2. Aprire la sezione Risposte e individuare la risposta fallita.
3. Fare clic su Resend nella vista dettagliata della risposta.

Cosa aspettarsi

• Un indicatore di caricamento conferma che l’evento è stato messo in coda per il reinvio
• Una notifica di successo o di errore viene mostrata al termine dell’operazione
• Il tentativo di reinvio viene registrato ed è visibile nella tabella Risposte per garantire una tracciabilità completa

Limite dei tentativi di reinvio

Per prevenire abusi, i tentativi di reinvio sono limitati a 5 al minuto. Quando il limite viene raggiunto, il pulsante Resend viene disabilitato e viene mostrato un messaggio esplicativo.