Come testare un webhook

Aggiornato il

In SyBox, questo si fa in Impostazioni > Integrazioni > Webhook.

  1. Assicurati che il webhook sia attivo. Se è disattivato, vedrai "Attiva prima questo webhook."
  2. Sulla sua scheda, fai clic su "Invia evento di test". Vedrai "Un evento di test è in arrivo. Il risultato apparirà in Consegne."
  3. Pochi secondi dopo si apre l'elenco "Consegne" che mostra la risposta del tuo server. La scheda mostra anche l'ultima risposta ricevuta dal tuo server con l'orario. Una risposta corretta (ad esempio "HTTP 200") appare in verde. Gli errori appaiono in rosso. "Ultima consegna: mai" indica che non è ancora stato recapitato alcun evento.
    To test a webhook: "HTTP 200" marked on the screen in SyBox

Un evento di test contiene "event": "test" e non trasporta dati dei clienti. Puoi inviarne uno ogni pochi secondi; se riprovi prima, vedrai "È stato inviato un test poco fa. Riprova tra qualche secondo."

Domande

Ho perso la chiave di firma.

Non può essere mostrata nuovamente. Modifica il webhook, inserisci una nuova chiave a tua scelta in "Chiave di firma", salva e aggiorna il valore sul tuo server.

Il mio webhook è stato disattivato senza che io facessi nulla.

SyBox lo ha disattivato dopo che il tuo server ha restituito errori per 20 volte consecutive per più di un'ora. Vedi "Disattivato automaticamente" qui sopra: ripara il server e riattiva il webhook entro 24 ore affinché gli eventi in attesa vengano inviati.

Il mio webhook non riceve alcun dato.

Fai prima clic su "Invia evento di test" sulla sua scheda e controlla in "Consegne". Verifica poi questi quattro elementi: (1) il webhook è attivo; (2) è stato selezionato almeno un evento; (3) è associato al numero WhatsApp corretto o a "Tutti i numeri"; (4) il canale da cui è arrivato il messaggio è tra quelli supportati dai webhook (WhatsApp, Messenger, Instagram, Telegram, TikTok o Live Chat; non email o SMS). Controlla poi l'esito dell'ultima consegna sulla scheda.

La scheda mostra un errore in rosso, come HTTP 404 o 500.

SyBox ha contattato correttamente l'indirizzo, ma il tuo server ha risposto con un errore. Controlla l'URL e consulta i log del tuo server.

Non riesco a creare un webhook, il sistema dice che non sono autorizzato.

Per creare un webhook o riattivarlo occorrono sia il permesso "Gestisci i canali" sia "Mostra il numero del contatto". Rivolgiti all'amministratore.

Altre informazioni su Webhook.