Come configurare un Webhook
Panoramica
Utilizzando il webhook Webio, è possibile configurare gli endpoint all'interno dell'organizzazione Webio per pubblicare o recuperare i dati. In particolare grazie ai Webhook puoi:
1) Ricevi notifiche di aggiornamento (Post Request) dalla tua organizzazione verso tuo sistema interno, ogniqualvolta un evento che sottoscrivi in Webio si verifica. Configura più endpoint all'interno della tua organizzazione Webio, scegli a quali eventi iscriverti e verifica le loro connessioni durante il processo di configurazione.
2) Ricevi GET Request da Webio: arricchisci le conversazioni dei bot con le informazioni del contatto provenienti dal tuo sistema interno: alcuni bot richiedono dati dal tuo sistema in tempo reale. Questi può essere utilizzato per arricchire le conversazioni in entrata con i dati dell'account o per includere dati in tempo reale provenienti dal tuo sistema interno.
Come configurare un Webhook
Per identificare la richiesta come proveniente da Webio, utilizza prima l'API key dell'organizzazione per generare un JWT token.
Per configurare un webhook per l'organizzazione:
- Accedi a Webio, fai clic su SETTINGS, quindi fai clic su ORGANIZATIONS.
- Seleziona l'organizzazione per la quale si desidera configurare il webhook, clicca su EDIT, quindi su INTEGRATIONS.
- Dalla sezione delle integrazioni, scorri verso il basso fino al webhook, quindi fai clic su ADD WEBHOOK.
Dovresti vedere la finestra sottostante. Inserisci il Callback URL a cui vuoi connetterci e seleziona quali eventi vuoi sottoscrivere. Un URL di Callback è un URL fornito dall'applicazione ricevente e funge da destinazione per il webhook per inviare i dati dell'evento.
Webio dispone di 5 webhook standard disponibili per iscriversi, 4 richieste post e 1 get.
Richieste POST
- Messaggi in entrata - Dettagli messaggio e contenuto di un messaggio in entrata ricevuto a un id canale assegnato all'organizzazione.
- Invia messaggio - Un aggiornamento dello stato del messaggio per confermare uno stato del messaggio è stato spostato da pendente ad inviato.
- Report di consegna - Un aggiornamento dello stato del messaggio per confermare uno stato del messaggio è stato spostato da uno stato inviato a uno stato di risultato.
- Pagamento - I dettagli di conferma di qualsiasi pagamento riuscito effettuato tramite WebioPay saranno restituiti al tuo endpoint.
Inoltre ricevi aggiornamenti quando la conversazione viene mossa di coda o quando viene chiusa. Oppure quando uno stato e stato assegnato alla conversazione o anche quando la conversazione viene assegnata ad uno dei tuoi agenti Webio.
Richiesta GET
- Questo richiede informazioni dal sistema per aggiornare i valori utilizzati all'interno dei campi webhook bot <<>>
- Webio invierà una richiesta all'endpoint configurato all'interno dell'organizzazione. La richiesta conterrà l'ID cliente (questo è un valore nullo per le conversazioni avviate in entrata), l'id del canale (ad es. numero di telefono) e i nomi dei campi dei parametri richiesti. Questo può essere utilizzato per aggiornare il contenuto dei messaggi con informazioni in tempo reale come le richieste di saldo correnti o fornire dati che il bot può utilizzare per l'identificazione e la verifica.
Testa la connessione
Per testare la connessione, dal pannello di integrazione, scorri verso il basso fino alla sezione webhook, trovare il webhook appena creato e fare clic su 'Test'.
Webio fornisce 5 test che possono essere eseguiti dalla schermata dell'organizzazione. Seleziona il test che si desidera eseguire dal menu a tendina.
Per aggiungere valori personalizzati nei bot tramite Webhook, inserisci <<>> dove si desidera. Questo può essere all'interno del contenuto del messaggio o all'interno delle condizioni appartenenti al Logical Branch.
Per il recupero di valori personalizzati solo un endpoint Webhook puo' essere usato per organizzazione.
Related Articles
Come aggiungere campi personalizzati (Custom Field Names)
Panoramica Quando costruisci il Campaign File, è sufficiente definire i nomi di campo personalizzati/custom field names (le intestazioni delle colonne del tuo campaign file) e organizzare i valori personalizzati (Custom Value) del contatto in colonne ...Tipi di Step
Panoramica I bot sono creati come un flusso di step. La conversazione automatica del Bot seguirà il flusso in base alle regole ed al percorso che hai configurato. Quando crei un nuovo step, è necessario scegliere quale tipo di step è, configurarlo e ...Come impostare lo Stato di una conversazione
Panoramica Quando impostai lo stato di una conversazione, questo verrà contrassegnato sulla conversazione stessa. Inoltre dalla schermata Insights è possibile controllare quante conversazioni sono aperte per stato - . Per impostare manualmente uno ...Come creare una Campagna Rapida
Panoramica La funzione Campagna Rapida, ti consente di inviare un semplice SMS ai tuoi contatti, senza la necessità di creare prima un bot. Questo e' molto utile quando sei di fretta e non hai la necessita' che il tuo contatto interagisca con una ...Come creare una campagna in uscita (Outbound Campaign)
Panoramica La schermata Campaigns di Webio semplifica il modo in cui gestisci le programmazioni (Schedules) dei tuoi bots. Ti permette di inviare bot ai tuoi contatti consentendoti di configurare Campagne in in entrata o uscita ed utilizzando canali ...