Come inviare le trascrizioni delle chat tramite webhook
Le istruzioni riportate di seguito sono valide solo per desktop e laptop.
Utilizzando i webhook, puoi ricevere le trascrizioni di tutte le chat inviate a un URL di endpoint a tua scelta. La trascrizione viene inviata quando tutte le conversazioni con un cliente sono terminate, di solito dopo 3 minuti di inattività.
Se stai utilizzando altre applicazioni per ricevere il payload dal tuo account tawk.to, ricordati di configurarle prima.
Successivamente, segui questi passaggi per creare un webhook per le trascrizioni delle chat:
Accedi al tuo account tawk.to.
Nella dashboard, seleziona la proprietà per la quale desideri creare un webhook. Passa il mouse sopra il nome della proprietà per assicurarti di aver selezionato quella corretta.


4.Nel menu di Amministrazione, seleziona Webhook sotto la sezione Impostazioni.

Nota: puoi avere fino a 10 webhook per ogni proprietà.




Questo attiva il webhook quando tutte le chat con il cliente sono terminate. Una trascrizione dell'intera conversazione viene inviata dopo 3 minuti di inattività. Ecco un esempio del payload:



Nota: tawk.to invia un payload JSON quando questo evento viene attivato.Per tutti i dettagli, consulta la documentazione webhook nel Developer Portal.
Per informazioni su come convertire file JSON, consulta questa guida:Come posso convertire file JSON?
Gestione dei webhookUna volta creati i webhook, potresti doverli aggiornare o rimuovere quando la tua configurazione cambia. Ecco come fare:
- Per abilitare/disabilitare un webhook, attiva o disattiva l’interruttore in alto a destra del webhook corrispondente.
- Per modificare un webhook, clicca sull’icona a forma di matita (edit). Aggiorna il nome, l’endpoint o gli eventi necessari, quindi salva le modifiche.
- Per eliminare un webhook, clicca sull’icona a forma di cestino (delete). Questo rimuove il webhook e interrompe tutte le future consegne dei dati a quell’endpoint.

Suggerimento:Tieni la tua lista di webhook ordinata rimuovendo gli endpoint che non usi più. Questo aiuta a evitare trasferimenti di dati non necessari e mantiene le tue integrazioni più sicure.
Controlla il payload
l payload della trascrizione include dettagli sulla chat, sul visitatore e sulla cronologia dei messaggi. Consulta la documentazione webhook del Developer Portal per vedere la struttura e pianificare come il tuo sistema deve elaborare i dati.
Mantienilo sicurotawk.to firma ogni webhook con una firma HMAC-SHA1. Usa l’intestazione X-Tawk-Signature e il tuo webhook secret per confermare che la richiesta sia autentica.Pianifica i tentativi di ritrasmissione
Se il tuo endpoint non risponde in tempo (30 secondi) o restituisce un errore, tawk.to riproverà per un massimo di 12 ore. Assicurati che il tuo sistema possa gestire richieste duplicate in modo sicuro.
Gestisci gli allegatiAlcune chat includono file. Il webhook fornisce metadati e URL per gli allegati. Decidi se scaricarli e archiviarli.
Considera la privacyLe trascrizioni possono contenere informazioni personali. Archiviali e usali in modo responsabile per rispettare le norme sulla protezione dei dati.
Testa prima di andare in produzioneEsegui alcune chat di prova e verifica che le trascrizioni arrivino come previsto. Questo ti aiuta a individuare problemi prima di inviare i dati ai sistemi live.
Risorse aggiuntiveEsplora il nostro Developer Portal per informazioni dettagliate sui payload dei webhook e esempi di integrazione.
Se hai commenti su questo articolo o hai bisogno di ulteriore assistenza:
Contattaci via live chat
Prenota una chiamata con il nostro team
Visita la nostra community
