Integrazioni, migrazione e chiavi API

In Integrazioni (/app/integrations) può collegare reactive.chat agli strumenti già usati dal team. Le integrazioni si applicano all’intero spazio di lavoro. Possono configurarle proprietari e amministratori; un amministratore limitato a singoli progetti non può farlo.

Questa pagina descrive l’utilità delle integrazioni e come usarle. I dettagli tecnici, ad esempio sulla firma dei webhook, sono nella parte Integrazione tecnica.

Trasparenza sullo stato attuale

Sono disponibili collegamenti a oltre 30 servizi. La maggior parte è stata testata con controparti simulate, ma non è ancora stata eseguita con il servizio reale. La pagina delle integrazioni li contrassegna con «Non verificata con il servizio reale»; alcuni riportano «In corso». Webhook e Slack non hanno questa nota. Configuri un’integrazione non verificata, la provi con dati reali e ci segnali eventuali problemi tramite Invia feedback.

Configurare un’integrazione

1. Apra Integrazioni. In alto vede quante sono collegate, quante hanno un errore o sono in pausa e se ci sono consegne non riuscite.
2. Cerchi nel catalogo (Cerca integrazioni, filtro «Tutte» o «Non collegate») e faccia clic su Configura.
3. Inserisca le credenziali richieste dal servizio, solitamente una chiave API o un token del Suo account presso quel servizio.
4. Collega e attiva verifica subito la connessione e attiva l’integrazione. Con Salva senza attivare può rimandare l’attivazione.

In seguito può usare Modifica, Metti in pausa, Riattiva o Rimuovi. La rimozione elimina le credenziali memorizzate ed è irreversibile. Le credenziali vengono conservate cifrate.

Solo Google Drive dispone di un pulsante per accedere al servizio. Per tutti gli altri deve inserire personalmente le credenziali; per Slack, ad esempio, i dati di una Sua app Slack.

Quando un servizio non risponde

Ogni integrazione lavora tramite una coda. Se un servizio non risponde, la consegna viene ritentata più volte a intervalli crescenti; dopo ripetuti errori viene sospesa per un periodo («Temporaneamente sospesa: il servizio non ha risposto ripetutamente …»). Un evento non consegnato dopo circa un’ora viene scartato. Nella sezione Consegne non riuscite vede le più recenti, senza il loro contenuto.

Un messaggio di chat non attende mai un’integrazione. Se un servizio si blocca, la chat continua a funzionare senza interruzioni.

Che cosa è disponibile

Notifiche al team

• Slack: ogni nuova conversazione appare come thread in un canale. Rispondendo nel thread, il visitatore vede la risposta nella chat. /rc mostra lo stato. Può associare gli utenti Slack agli operatori.
• Microsoft Teams, Discord: notifiche tramite un indirizzo webhook.
• Telegram: notifiche a una chat tramite token del bot e ID chat.
• E-mail: notifiche a una casella del team.

Automazione

• Webhook: reactive.chat invia eventi firmati a un indirizzo https:// a Sua scelta: nuova conversazione, ogni messaggio, richiesta di passaggio a una persona, valutazione ricevuta, nuovo caso di errore. Anche Zapier, Make e n8n si collegano così. Può visualizzare, copiare e rigenerare il Segreto di firma; un nuovo segreto è valido immediatamente e quello precedente non lo è più.
• Zapier: tramite i REST hook dell’interfaccia. Non esiste ancora un’app pronta per Make e n8n; per questi usi i webhook.

Contesto nel pannello

Queste integrazioni mostrano nella colonna del contesto del pannello schede sul visitatore, ad esempio i suoi ordini o il suo contatto CRM, alcune con azioni:

• CRM: HubSpot, Pipedrive
• Negozio: Shopify, Shopware 6, WooCommerce
• Pagamenti: Stripe (con una chiave di lettura limitata)
• Sito web: WordPress
• Analisi: Matomo, Plausible, Google Analytics 4
• Errori: Sentry

La scheda contrassegna i dati basati su una dichiarazione non firmata del visitatore. Le azioni si eseguono con Esegui e una conferma.

Ticket, appuntamenti e telefono

• Zendesk, Freshdesk, Jira, Linear, GitHub: creare ticket o segnalazioni da una conversazione o da un caso di errore.
• Cal.com: mostrare e prenotare appuntamenti disponibili, anche tramite l’assistente IA.
• Twilio: SMS dal pannello e canale di invio per il canale SMS.

Fonti di conoscenza

• Notion, Confluence: importare contenuti nella knowledge base.
• Google Drive: nella knowledge base, «File e Google Drive» (vedere Knowledge base e centro assistenza).
• KB-Crawler: impostazioni della scansione del Suo sito.

Canali

• WhatsApp Business, Facebook Messenger, Instagram Direct: vedere Canali.

Passare da un altro provider

In Migrazione (/app/migration) può importare dati da un altro strumento di chat:

• Intercom e Crisp: tramite la loro interfaccia o un file di esportazione; per Crisp anche articoli di aiuto in Markdown,
• Tidio: tramite un file di esportazione,
• Zendesk: tramite l’esportazione JSON completa e quella del centro assistenza.

Come procedere:

1. Avvia una nuova migrazione e scelga la destinazione (In quale progetto?).
2. Connetti e vedi cosa c’è: vede i dati disponibili e un campione.
3. Cosa includere?: contatti, conversazioni, articoli.
4. Avvia la migrazione. Può usare Ferma o Scarta l’operazione.

Da sapere:

• Le conversazioni importate arrivano nel pannello chiuse.
• I contatti importati sono considerati non verificati.
• I dati sensibili nei testi vengono mascherati.
• Gli allegati arrivano come link, non come file.
• Una seconda esecuzione non crea duplicati.
• Le credenziali del vecchio provider vengono eliminate al termine dell’esecuzione.
• Le interfacce dei provider sono state testate senza account reali presso di loro; le importazioni da file sono state testate dall’inizio alla fine con file di esempio.

Con Sostituisci il codice, l’account converte un codice Intercom o Crisp esistente in un codice reactive.chat. I comandi JavaScript boot, open, identify e track mantengono gli stessi nomi di Intercom.

Chiavi API

In Chiavi API (/app/api-keys, proprietari e amministratori) può creare chiavi per l’interfaccia REST. Una chiave viene mostrata una sola volta; in seguito reactive.chat ne conserva solo un’impronta. La copi quindi subito in un luogo sicuro.

Alla creazione sceglie che cosa può fare la chiave:

• sola lettura
• lettura e scrittura
• solo importazione dati dei clienti: per l’importazione descritta in Dati dei clienti nella chat
• lettura + dati dei visitatori oppure lettura, scrittura + dati dei visitatori: solo con questi ambiti la chiave vede nome, e-mail e telefono dei visitatori

L’elenco mostra nome, prefisso, data e autore della creazione e ultimo utilizzo. Revoca ha effetto immediato ed è irreversibile.

Con una chiave può anche collegare reactive.chat a strumenti IA che supportano il Model Context Protocol (MCP); la pagina mostra esempi. Il funzionamento dell’interfaccia è descritto nella parte Integrazione tecnica.