I webhook sono disponibili solo per i piani Advanced e superiori.
Connettiti a vari sistemi e servizi come piattaforme di email marketing, strumenti CRM, piattaforme di e-commerce e software di gestione progetti per ricevere aggiornamenti in tempo reale sulla piattaforma su respond.io. Collegando l'URL del tuo webhook (endpoint REST) alla piattaforma, puoi sincronizzare gli eventi rilevanti con i tuoi CRM e database, garantendo informazioni accurate e aggiornate su tutti i tuoi sistemi.
Configurazione
Passaggio 1: Nelle impostazioni dell'area di lavoro, vai a Integrazioni > Webhook > Fai clic su Connetti
Passaggio 2: fare clic sul pulsante Aggiungi webhook per aggiungere un URL endpoint e selezionare un evento webhook
Per ricevere ed elaborare la richiesta è necessario l'endpoint URL specifico.
Eventi webhook
Ecco alcuni casi d'uso comuni per gli eventi webhook:
Conversazione chiusa - Ogni volta che una conversazione viene chiusa, aggiorna automaticamente i dettagli del Contatto o salva le informazioni della conversazione in un'app o in un sistema di terze parti per la registrazione e monitora il numero di conversazioni chiuse per l'analisi.
Nuovo Contatto - Ogni volta che viene aggiunto un nuovo Contatto, aggiungilo automaticamente al CRM, invia messaggi di benvenuto e notifica i membri del team.
Nuovo Messaggio in Uscita - Ogni volta che viene inviato un nuovo messaggio in uscita, invia automaticamente notifiche per ciascun messaggio in uscita, registra i dettagli del messaggio nel CRM e assegna tag o punteggi ai lead in base al contenuto del messaggio.
Nuovo Messaggio in Entrata - Ogni volta che ricevi un nuovo messaggio in entrata, invia automaticamente notifiche per ciascun messaggio in entrata, registra i dettagli del messaggio nel CRM e assegna tag o punteggi ai lead in base al contenuto del messaggio.
Contatto Aggiornato - Ogni volta che un Contatto viene aggiornato, aggiorna automaticamente le informazioni del Contatto nel CRM e invia notifiche ai membri del team pertinenti riguardo alle modifiche.
Conversazione Aperta - Ogni volta che una conversazione viene aperta, informa automaticamente i membri del team in tempo reale delle nuove conversazioni con i clienti e apre i dettagli della conversazione.
Assegnatario del Contatto aggiornato - Ogni volta che viene aggiornato l'assegnatario di un Contatto, informa automaticamente i membri del team quando vengono assegnati a un nuovo Contatto e gestisce i compiti di follow-up o i promemoria.
Tag Contatto aggiornato - Ogni volta che un tag di Contatto viene aggiornato, aggiorna automaticamente i punteggi dei lead, gestisce le liste per l'email marketing e invia campagne di marketing mirate in base ai tag del Contatto.
Nuovo Commento - Ogni volta che viene aggiunto un nuovo commento, notifica automaticamente i membri del team e sincronizza i commenti tra respond.io e altri sistemi.
Chiamata terminata (chiamate vocali) – Ogni volta che termina una chiamata vocale (completata o persa), invia automaticamente i dati relativi alla chiamata ai tuoi sistemi esterni, come i sistemi CRM, gli strumenti di analisi o le piattaforme interne di reportistica. Ciò può includere lo stato della chiamata, la durata, i dettagli dell'agente o dell'agente AI vocale e, se abilitato, le registrazioni, le trascrizioni e i riepiloghi della chiamata.
Per maggiori informazioni sui dati che possono essere trasmessi con questi eventi webhook, consulta la nostra documentazione API Webhooks.
FAQ e risoluzione dei problemi
Perché il mio webhook continua a disattivarsi automaticamente e come posso riattivarlo?
Il tuo webhook potrebbe essere disattivato automaticamente se il numero di tentativi falliti supera la soglia di 30 errori ogni 30 minuti; tieni presente che questa quota di errori è condivisa tra tutti i webhook. Se ciò accade, riceverai una notifica via email dell'errore. Per evitare la disattivazione, monitora regolarmente i log del tuo endpoint per individuare eventi webhook falliti.
Inoltre, il tuo endpoint deve restituire una risposta 200 OK entro 5 secondi. Il mancato rispetto di quanto sopra viene conteggiato ai fini del tuo limite di errori e potrebbe portare alla disattivazione automatica.
Per riattivare il tuo webhook, segui questi passaggi:
Vai a Impostazioni del Workspace
Vai a Integrazioni > Webhook
Trova il tuo webhook e fai clic su «Abilita» nella colonna Azione
Per visualizzare i log degli eventi webhook, puoi votare la richiesta di funzionalità.
Perché i miei webhook di respond.io sono in ritardo?
I ritardi si verificano se il tuo endpoint non risponde entro 5 secondi, facendo sì che il nostro sistema webhook ritenti e metta in coda gli eventi. Ecco come funziona la nostra configurazione:
Raggruppiamo gli eventi per endpoint per evitare che un singolo endpoint sovraccarichi il sistema.
Gli eventi vengono elaborati in ordine e, se il tuo endpoint impiega troppo tempo per rispondere, vengono effettuati nuovi tentativi a 30, 60 e 90 secondi, fino a un limite di 3 minuti prima che l'evento venga scartato.
Per evitare ritardi, ti consigliamo di ottimizzare il modo in cui il tuo sistema gestisce gli webhook in arrivo. Questo aiuterà a garantire una consegna tempestiva degli eventi.
Perché non vedo registrazioni delle chiamate, trascrizioni o riepiloghi nel payload del mio webhook?
I dati relativi alle chiamate negli eventi webhook dipendono dalle impostazioni del tuo Workspace. Se la registrazione delle chiamate, le trascrizioni o i riepiloghi delle chiamate sono disabilitati, i campi corrispondenti verranno restituiti come null o omessi dal payload. Le chiamate perse non includono registrazioni, trascrizioni o riepiloghi.
