In breve
- Nove eventi tra cui scegliere.Conversazioni, messaggi, passaggi, stato, lead, contatti, valutazioni, prenotazioni e utilizzo.
- Firmati con uno standard aperto.Ogni consegna segue Standard Webhooks, così il suo server può dimostrare che arriva da OneType.
- Nuovi tentativi per circa tre giorni.Una consegna non riuscita viene ritentata con un calendario da 5 secondi fino a 24 ore.
- Un registro da cui rinviare.Veda ogni tentativo per 30 giorni e invii di nuovo qualsiasi evento con un clic.
Un lead che resta solo in uno strumento di chat è un lead che viene dimenticato. Un webhook è un messaggio che OneType invia a un indirizzo sul suo server ogni volta che accade qualcosa. Lo usi per aggiungere lead al suo CRM, aprire ticket, avvisare il suo team o aggiornare una dashboard, senza che nessuno copi i dati a mano.
Gli eventi
- conversation.created: un visitatore avvia una conversazione.
- conversation.message.created: un messaggio è completato, dal visitatore, dall'agente o dal suo team.
- conversation.handoff.requested: il visitatore o l'agente chiede una persona.
- conversation.status.changed: aperta, passata a un operatore, risolta, non risolta o fallita.
- lead.captured e contact.identified: un visitatore lascia i suoi dati di contatto o viene riconosciuto come uno dei suoi utenti che hanno effettuato l'accesso.
- usage.threshold.reached: il suo workspace raggiunge l'80% o il 100% dell'utilizzo mensile.
Ogni consegna porta lo stesso oggetto che l'API REST restituisce per quella risorsa, quindi un messaggio indica se è stato scritto dall'IA. Può iscrivere un endpoint ad alcuni eventi o a tutti.
Lo configuri nella dashboard
In “Developer”, “Webhooks”, un proprietario o amministratore aggiunge un indirizzo https e sceglie gli eventi. Il segreto di firma viene mostrato una sola volta, quindi lo conservi subito. Clicchi su “Send test” per consegnare un ping firmato e vedere il codice di risposta e i tempi. Può ruotare il segreto in qualsiasi momento: per 24 ore sia il vecchio sia il nuovo segreto firmano ogni consegna, così nulla si rompe mentre cambia.
Consegne su cui contare
Risponda con qualsiasi 2xx entro 10 secondi e la consegna è valida. Se il suo server fallisce o è lento, OneType riprova dopo 5 secondi, 30 secondi, 2 minuti, 10 minuti, 30 minuti, 1 ora, 3 ore, 6 ore, 12 ore, poi ogni 24 ore per tre volte. La consegna avviene almeno una volta, quindi conservi l'intestazione webhook-id, che resta uguale a ogni nuovo tentativo, e ignori i duplicati. L'ordine non è garantito.
Un endpoint che fallisce sempre per tre giorni viene disattivato, e i proprietari vedono un banner con “Turn back on”. Il registro delle consegne conserva ogni tentativo per 30 giorni con stato, codice, tempi e un estratto della risposta, e “Redeliver” invia di nuovo un evento.
Sicurezza
Ogni richiesta è firmata secondo Standard Webhooks con un timestamp, così può rifiutare richieste vecchie o riproposte. OneType consegna solo a indirizzi https pubblici, mai a reti private, e non segue i reindirizzamenti. La documentazione per sviluppatori include codice di verifica per Node.js, Python e PHP.
Idee per il suo primo endpoint
- Aggiunga ogni contatto lead.captured al suo CRM o alla sua mailing list.
- Apra un ticket nel suo helpdesk su conversation.handoff.requested.
- Avvisi il canale del suo team quando una conversazione viene passata a un operatore.
- Avvisi l'amministrazione quando arriva usage.threshold.reached.
Solo proprietari e amministratori possono vedere e gestire gli endpoint, e i segreti non vengono più mostrati dopo la prima volta. Gli altri colleghi non vedono affatto i webhook.