Webhooks ed eventi in RaiseNow Hub

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

Cosa sono i webhooks 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 interrogare periodicamente per aggiornamenti, il tuo sistema riceve l'informazione non appena l'evento si verifica.

Come funziona

Accesso ai webhooks

1. Vai a Impostazioni in RaiseNow Hub.

2. Seleziona Webhooks.

Questa sezione contiene tutte le opzioni per creare, gestire e monitorare webhooks ed eventi.

Creare e gestire i webhooks

Puoi creare nuovi webhooks per iscriversi agli eventi che interessano alla tua organizzazione, inclusi:

• Transazioni e pagamenti

• Abbonamenti

• Dati del sostenitore

• Modifiche relative all'organizzazione

Ogni webhook invia i dati dell'evento all'URL che definisci.

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

Ricerca e filtro dei webhooks

Per gestire configurazioni più grandi più facilmente, puoi cercare e filtrare i webhooks esistenti.

I filtri disponibili includono:

• UUID

• URL del webhook

• Alias del webhook

• Nome dell'evento

Questo ti aiuta a trovare rapidamente configurazioni specifiche e a mantenere organizzata la tua configurazione.

Visualizzare i log di consegna degli eventi

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

Puoi utilizzare questi log per:

• Verificare se gli eventi sono stati consegnati con successo

• Controllare lo stato dell'evento

• Risoluzione dei 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

Ritentare eventi webhook falliti

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. Vai su Impostazioni → Webhook
2. Apri la sezione Risposte e individua la risposta fallita
3. Clicca sul pulsante Resend nella vista dettagliata della risposta

Cosa aspettarsi

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

Rate limiting

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.