Webhook

Push di eventi come passaggio a operatore, nuovi messaggi, fine conversazione, ticket ed elaborazione documenti, con regole di verifica della firma e di retry.

Nel pannello di amministrazione, in «Impostazioni bot», inserisci l'indirizzo webhook. Intestazioni della richiesta:

IntestazioneDescrizione
X-AICS-Event-IdID dell'evento; usalo per la deduplicazione
X-AICS-Timestamp / X-AICS-SignatureIl metodo di verifica della firma è lo stesso dell'interfaccia di ricerca ordini

Corpo della richiesta: {"id", "type", "created_at", "data"}.

EventoQuando
conversation.handoffPassaggio a un operatore umano (quando come modalità di passaggio è selezionato «Invia al mio sistema» o «Notifica entrambi»)
conversation.messageIn modalità manuale, il cliente invia un nuovo messaggio
conversation.closedConversazione terminata (data.conversation.closed_by indica chi l'ha terminata)
conversation.ratedIl cliente ha valutato una conversazione terminata: data.rating, data.comment
ticket.createdNuovo ticket (inclusi i messaggi lasciati dal cliente quando il servizio clienti è offline): data.ticket, data.description
ticket.updatedModifiche a stato, priorità, assegnatario e altri campi del ticket: data.changes è {字段: [旧, 新]}
ticket.repliedL'operatore ha risposto al cliente: data.reply
document.ready / document.failedElaborazione del documento completata o non riuscita

Una risposta 2xx è considerata riuscita; altrimenti viene ritentata con backoff a 30 secondi, 2 minuti, 10 minuti… fino a un massimo di 12 ore, per un totale di 8 tentativi. L'ordine non è garantito.

Questa pagina ti è stata utile?

Ultimo aggiornamento: