Collegare intoCHAT a Zapier e Make
Usa intoCHAT in Zapier e Make: trigger istantanei per nuovi lead, moduli inviati, prenotazioni, richieste di reso, passaggi e richieste di live chat, azioni per chattare con un agente e aggiungere conoscenza, e come collegarsi con una chiave API.
intoCHAT ha app per Zapier e Make. Avviano uno Zap o uno scenario nel momento in cui succede qualcosa sul tuo agente, per esempio un nuovo lead, e permettono a uno Zap o a uno scenario di inviare un messaggio al tuo agente o di aggiungere qualcosa alla sua conoscenza. Si basano sulla REST API e sui webhook, quindi lavorano con gli stessi dati e gli stessi limiti.
Quali piani includono le app
Le app usano la REST API, inclusa nei piani Starter, Pro ed Enterprise. Con Free non puoi creare la chiave API di cui hanno bisogno. Se il tuo account torna al piano Free, le app smettono di funzionare finché non passa di nuovo a Starter o a un piano superiore. Vedi Quali piani includono l'API.
Ogni risposta che l'agente scrive per Send a message to an agent conta come un messaggio del tuo piano, come nel widget di chat. I trigger e le altre azioni non consumano messaggi.
Che cosa è disponibile
Trigger
| Trigger | Si avvia quando | Evento |
|---|---|---|
| New lead | Un visitatore lascia i suoi dati di contatto, nel modulo lead o in chat. | lead.created |
| New form submission | Un visitatore invia uno dei tuoi moduli in chat. | form.submitted |
| New booking | Un visitatore prenota un appuntamento dalla chat. Vedi Prenotazione con Cal.com o Calendly. | booking.created |
| New return request | Un visitatore chiede di restituire o cambiare articoli di un ordine verificato. Vedi Stato degli ordini e resi. | return.requested |
| Hand-off requested | L'agente invia una conversazione al tuo team via email. Vedi Passaggio via email. | handoff.requested |
| Live chat requested | L'agente chiede al tuo team di intervenire in una chat. Vedi Live chat. | live_chat.requested |
| New conversation | Inizia una nuova conversazione con l'agente. | conversation.created |
I primi sei sono istantanei: intoCHAT invia l'evento nel giro di pochi secondi, come invia un webhook. New conversation non ha un webhook, quindi lo strumento controlla le nuove conversazioni secondo la propria pianificazione, per esempio ogni pochi minuti in Zapier, a seconda del tuo piano Zapier o Make.
Ogni trigger chiede l'Agent da osservare; l'elenco mostra tutti gli agenti del tuo account. L'output del trigger sono i data dell'evento, con i campi descritti in Che cosa viene inviato, per esempio email, name e conversationId per un nuovo lead.
Azioni
| Azione | Che cosa fa |
|---|---|
| Send a message to an agent | Invia un messaggio e restituisce la risposta dell'agente e l'ID della conversazione. Indica un Session ID, per esempio l'indirizzo email del cliente, per continuare ogni volta la stessa conversazione. Vedi Inviare un messaggio. |
| Add a Q&A pair | Aggiunge una domanda e la sua risposta alla conoscenza dell'agente e avvia l'addestramento. Una domanda che l'agente ha già riceve la nuova risposta. |
| Add a text snippet | Aggiunge un testo con titolo alla conoscenza dell'agente e avvia l'addestramento. |
| Find conversation (una ricerca in Zapier, Get a conversation in Make) | Trova una conversazione tramite il suo ID, con la sua trascrizione. Usala dopo un trigger per leggere l'intera chat. |
La nuova conoscenza conta nei caratteri di addestramento dell'agente, e l'agente la usa quando l'addestramento è terminato. Vedi Testo e Q&A.
Collegare con una chiave API
- In intoCHAT, nella barra laterale sotto Settings, clicca su API keys.
- In Create a key, dai alla chiave un Name che riconoscerai, per esempio
Zapier. - In Access, lascia Every scope, including ones added later. Per limitare invece la chiave, scegli Only the scopes I choose e seleziona gli scope della tabella qui sotto.
- Clicca su Create key, poi su Copy.
- In Zapier o Make, aggiungi un passaggio intoCHAT, scegli di collegare un nuovo account e incolla la chiave in API key.
Usa una chiave per ogni strumento, così puoi revocarne una senza fermare l'altro. Vedi Creare una chiave API.
| Scope | Serve per |
|---|---|
agents:read | Il collegamento e l'elenco Agent |
webhooks:write | I trigger istantanei |
leads:read | I dati di esempio per New lead, New form submission, New booking e New return request in Zapier |
conversations:read | New conversation, Find conversation e i dati di esempio per Hand-off requested e Live chat requested in Zapier |
chat | Send a message to an agent |
sources:write | Add a Q&A pair e Add a text snippet |
Come funzionano i trigger istantanei
Quando attivi uno Zap, o aggiungi un trigger istantaneo in uno scenario Make, lo strumento chiede a intoCHAT di inviare quell'evento a un proprio indirizzo. intoCHAT lo salva come webhook sull'agente:
- Compare nella scheda Leads dell'agente sotto Webhooks, con l'etichetta via Zapier o via Make. Vedi Webhook creati dalle integrazioni.
- Viene inviato, ritentato e registrato come qualsiasi webhook, quindi Recent deliveries mostra che cosa è stato inviato allo strumento.
- Quando disattivi lo Zap, o elimini il trigger o lo scenario in Make, lo strumento rimuove di nuovo il webhook.
Il webhook di ogni evento è firmato, ma Zapier e Make non possono controllare la firma, quindi le app non usano il segreto di firma. L'indirizzo che lo strumento fornisce a intoCHAT è riservato al tuo Zap o scenario.
Dati di esempio
Quando provi un trigger, Zapier carica fino a tre degli ultimi eventi reali di quel tipo dell'agente. Se non ce ne sono ancora, per esempio prima della tua prima prenotazione, mostra un esempio con gli stessi campi, così puoi comunque associarli. In Make l'esempio è incluso nel modulo; esegui lo scenario una volta e genera un evento reale per vedere dati reali.
Revocare una chiave
Revocare una chiave in Settings, API keys ferma le app che la usano dalla loro richiesta successiva, ed elimina i webhook che quella chiave ha creato per Zapier o Make, con la loro cronologia degli invii. Gli Zap e gli scenari restano attivi ma non ricevono più eventi. Per ricollegarti, crea una nuova chiave, aggiorna il collegamento in Zapier o Make e disattiva e riattiva lo Zap (in Make, ricrea il webhook del trigger), così viene creato un nuovo webhook.
Limiti
- Valgono i limiti della REST API: 60 richieste al minuto per chiave, e i messaggi del piano per Send a message to an agent. Vedi Limiti di frequenza.
- Un agente può avere fino a 25 webhook delle integrazioni, oltre ai 5 che aggiungi tu. Disattivare gli Zap che non usi più li libera.
- I trigger non includono le modifiche fatte in seguito, come una prenotazione cancellata o una richiesta di reso gestita.
- I dati di esempio di Hand-off requested ricostruiti dai passaggi passati non hanno il
summary(non viene conservato); gli eventi in tempo reale lo hanno.
Risoluzione dei problemi
- Il collegamento non riesce. Controlla che la chiave inizi con
ic_live_, che non sia stata revocata e che il tuo account sia su Starter o un piano superiore. - Un trigger dice che alla chiave manca uno scope. Crea una chiave con Every scope, oppure con gli scope elencati sopra, e ricollegati.
- Uno Zap non riceve più eventi. Controlla la scheda Leads dell'agente: se il suo webhook via Zapier non c'è più, è stato rimosso in intoCHAT oppure la sua chiave è stata revocata. Disattiva e riattiva lo Zap per registrarlo di nuovo. Se il webhook è Paused, riattivalo.
- Troppi webhook. Disattiva gli Zap o elimina i trigger Make che non usi più, oppure rimuovi i loro webhook nella scheda Leads.
Passi successivi
- Che cosa contiene ogni evento: Webhook.
- Tutti gli endpoint usati dalle app: REST API.
- Pubblica gli stessi eventi in un canale Slack senza alcuno strumento: Notifiche Slack.