Webhook e consegne

Prima di iniziare

• Feature/capability e receiver proprio HTTPS.

Passo dopo passo

1. 01

   Apri Amministrazione → Webhook nel reparto corretto. In Nuovo webhook inserisci nome, endpoint HTTPS ed eventi, uno per riga; ticket.* seleziona eventi ticket, * tutti gli eventi. Un endpoint HTTP non abilita la creazione e gli indirizzi loopback o special-use vengono rifiutati.

2. 02

   Crea la sottoscrizione e trasferisci il segreto mostrato una volta al ricevente autorizzato tramite il canale previsto. Chiudi il pannello dopo averlo conservato; non inserirlo in screenshot, ticket o chat di supporto.

3. 03

   Modifica nome, endpoint o eventi e usa Sottoscrizione attiva/Salva webhook per sospendere o riattivare. Controlla lo stato Paused/In pausa prima di fare manutenzione al ricevente.

4. 04

   In Consegne recenti filtra per sottoscrizione; zero consegne significa che non ci sono esiti da verificare. Solo con un proprio receiver HTTPS pronto, produci un evento sintetico e verifica HMAC/CloudEvents, codice HTTP e tentativi.

5. 05

   Controlla gli errori prima di un replay, disponibile per dead-letter. Coordina la rotazione del segreto con il ricevente e verifica poi una nuova consegna.

Il risultato da verificare

Consegne persistenti e indipendenti per destinazione.

Limiti e attenzioni

• Gli indirizzi non ammessi vengono rifiutati. Una consegna riuscita non dimostra che il sistema ricevente abbia elaborato l'evento. Usa solo destinatari che sei autorizzato a configurare e verificare.
• Attivare Webhook non configura il ricevente HTTPS. Prepara il ricevente e verifica con un evento di prova autorizzato la firma HMAC, il formato CloudEvents, la risposta HTTP e i tentativi registrati. Se non ci sono consegne, non ci sono esiti da verificare.

Continua con le guide correlate