# 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](/it/docs/rest-api) e sui [webhook](/it/docs/webhooks), quindi lavorano con gli stessi dati e gli stessi limiti.

> Le app sono pronte e diventano disponibili nelle directory di app di Zapier e Make una volta pubblicate lì. Fino ad allora puoi già collegare entrambi gli strumenti con il loro passaggio per i webhook in entrata e un [webhook](/it/docs/webhooks#aggiungere-un-webhook) di intoCHAT, oppure chiamare la [REST API](/it/docs/rest-api) dal loro passaggio HTTP.

## 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](/it/docs/rest-api#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](/it/docs/lead-collection) o in chat. | `lead.created` |
| **New form submission** | Un visitatore invia uno dei tuoi [moduli in chat](/it/docs/chat-forms). | `form.submitted` |
| **New booking** | Un visitatore prenota un appuntamento dalla chat. Vedi [Prenotazione con Cal.com o Calendly](/it/docs/booking). | `booking.created` |
| **New return request** | Un visitatore chiede di restituire o cambiare articoli di un ordine verificato. Vedi [Stato degli ordini e resi](/it/docs/orders). | `return.requested` |
| **Hand-off requested** | L'agente invia una conversazione al tuo team via email. Vedi [Passaggio via email](/it/docs/handoff). | `handoff.requested` |
| **Live chat requested** | L'agente chiede al tuo team di intervenire in una chat. Vedi [Live chat](/it/docs/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](/it/docs/webhooks#eventi). **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](/it/docs/webhooks#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](/it/docs/rest-api#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](/it/docs/text-and-qa).

## Collegare con una chiave API

1. In intoCHAT, nella barra laterale sotto **Settings**, clicca su **API keys**.
2. In **Create a key**, dai alla chiave un **Name** che riconoscerai, per esempio `Zapier`.
3. 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.
4. Clicca su **Create key**, poi su **Copy**.
5. 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](/it/docs/rest-api#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](/it/docs/webhooks#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](/it/docs/rest-api#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](/it/docs/webhooks).
- Tutti gli endpoint usati dalle app: [REST API](/it/docs/rest-api).
- Pubblica gli stessi eventi in un canale Slack senza alcuno strumento: [Notifiche Slack](/it/docs/lead-alerts-and-export#notifiche-slack).