Documentazione

App e integrazioni

Collega gli strumenti che il tuo team usa già — Stripe, Shopify, Mailchimp, MailerLite, Jira e Tracio. Le app installate mostrano dati live dei clienti come schede nel pannello della conversazione dell'Inbox, proprio accanto alla chat.

Panoramica#

Il marketplace delle app si trova in Impostazioni → App. Le app si installano una volta sola, per l'intero workspace: un admin collega il servizio con le credenziali del workspace e ogni membro del team con accesso all'inbox vede la scheda risultante nel pannello della conversazione. Gli operatori non installano mai nulla da soli — e nemmeno gli agenti IA.

Installazione a livello workspace

Un set di credenziali per workspace. Installare, modificare o rimuovere un'app vale per tutti allo stesso tempo.

Schede nell'Inbox

Ogni app installata disegna una scheda nel pannello della conversazione con dati live sulla persona con cui stai parlando.

Nessun riempitivo

Tutto ciò che è elencato nel catalogo si può installare oggi — non esiste una sezione "in arrivo". Una tessera di richiesta ti permette di dirci quale servizio manca.

Gestire le app richiede il permesso Installa e configura le app (incluso di default nei ruoli Owner e Admin, e assegnabile ai ruoli personalizzati). I membri del team che non lo hanno vedono comunque le schede delle app nelle conversazioni — solo, non possono installare né riconfigurare nulla.

Il catalogo delle app#

Oggi sono disponibili sei app:

AppCategoriaCosa vedono gli operatori nella conversazione
StripePagamentiAbbonamento e pagamenti recenti della persona con cui stai parlando
ShopifyCommercioOrdini recenti con stato del pagamento e dell'evasione
MailchimpMarketingStato di iscrizione, audience e tag della persona con cui stai parlando
MailerLiteMarketingStato di iscrizione, gruppi e data di registrazione della persona con cui stai parlando
JiraIssue trackingLe issue collegate a questa conversazione, e un clic per aprirne un'altra
TracioSicurezzaUmano o bot: il verdetto di Tracio sul visitatore del widget di chat

Cerchi un semplice link al tuo back-office? Non richiede account né token, quindi vive in Impostazioni → Generale → Link ai tuoi sistemi invece che nel catalogo delle app.

Installare un'app#

Apri Impostazioni → App, scegli una tessera e compila le credenziali richieste dall'app. Ogni campo rimanda alla pagina esatta della dashboard del vendor in cui il valore viene creato o si trova.

PassoDescrizione
1. Rivedi l'anteprimaPrima di incollare qualsiasi cosa, la pagina di configurazione mostra un esempio della scheda esatta che i tuoi operatori vedranno — costruito con dati inventati, così sai cosa condividerai con il workspace prima che una credenziale venga salvata.
2. Inserisci le credenzialiIncolla la chiave API o il token. I valori vengono ripuliti automaticamente — uno spazio o un a-capo finale dal copia-incolla non romperà l'installazione.
3. Salva e testaSalvare memorizza la configurazione; testare la connessione fa una chiamata reale al vendor ed è ciò che rende verde il chip di stato.

Ogni tessera dell'app porta un chip di stato che ti dice a che punto è l'installazione:

StatoSignificato
Non testataLe credenziali sono salvate, ma l'app non ha ancora risposto a una richiesta reale.
ConnessaIl vendor ha davvero risposto — la connessione è verificata, non solo salvata.
Richiede attenzioneIl vendor ha rifiutato le credenziali salvate (chiave revocata o scaduta). Le schede smettono di chiamare il vendor finché un admin non salva o ritesta l'app.
ErroreQualcos'altro è fallito — vedi il tooltip.
DisattivataUn admin ha spento l'app. La scheda scompare dall'Inbox senza che le credenziali vengano eliminate.

Credenziali e sicurezza#

Le credenziali delle app appartengono al workspace, e alcune regole le tengono al sicuro:

  • Cifrate a riposo. I campi segreti (chiavi API, token) sono cifrati per-chiave nello storage e non vengono mai mostrati di nuovo dopo il salvataggio.
  • Privilegio minimo dove il vendor lo consente. Stripe andrebbe collegato con una chiave ristretta che possa leggere Customers, Subscriptions, Charges e Invoices — più l'accesso in scrittura ai Refunds solo se gli operatori devono rimborsare da una conversazione. Se incolli una chiave ad accesso completo funziona comunque, ma la pagina delle impostazioni ti consiglierà di sostituirla.
  • Spostare una destinazione richiede di nuovo il segreto. Modificare un campo a cui la credenziale è legata — il dominio del negozio Shopify, l'URL del sito Jira — richiede di reinserire il token, così una credenziale salvata non può mai essere reindirizzata verso un host a cui non era destinata.
  • Revocare riguarda l'intero workspace. C'è un'installazione per app per workspace: se ruoti o revochi la chiave presso il vendor, la scheda di ogni membro del team smette di funzionare finché un admin non la aggiorna in Impostazioni → App.

Schede delle app nell'Inbox#

Una volta installata, ogni app appare come widget nel pannello di dettaglio della conversazione dell'Inbox. Aprire una conversazione recupera una scheda live dal vendor: chi è questo cliente in Stripe, i suoi ordini Shopify recenti, il suo stato nella newsletter, le issue Jira collegate al thread, o il verdetto di Tracio sul visitatore. La maggior parte delle schede rimanda anche al record corrispondente nella dashboard del vendor — il verdetto di Tracio vive interamente nel pannello.

Le schede sono oneste quando non hanno nulla da mostrare. Se il cliente non viene trovato — o la conversazione non ha un'identità utilizzabile — la scheda lo dice e spiega perché, invece di renderizzare un riquadro vuoto. Le risposte vengono messe brevemente in cache e il consumo è limitato per app, così un inbox aperto non brucia i limiti API del vendor.

Le schede seguono l'identità verificata#

Stripe, Shopify, Mailchimp e MailerLite cercano il cliente per indirizzo email — e solo per un indirizzo davvero verificato: uno coperto dall'identità firmata del widget (verifica dell'identità), o l'indirizzo From di una conversazione del canale email. Un indirizzo che un visitatore ha semplicemente digitato nella chat non viene usato affatto per le ricerche — altrimenti chiunque potrebbe digitare l'email di un cliente reale e vederne la cronologia dei pagamenti. In quel caso la scheda spiega che l'indirizzo non è coperto da un'identità verificata.

Jira e Tracio non si basano sull'email — le schede Jira appartengono alle issue collegate della conversazione, e Tracio al visitatore del widget — quindi funzionano anche quando non esiste un indirizzo verificato.

Se l'indirizzo della conversazione non trova nulla, Respondo prova anche l'altro indirizzo noto del contatto (per esempio dopo un merge di contatti), ed etichetta la scheda con l'indirizzo che ha usato.

Cosa mostra ciascuna app#

Stripe#

Una finestra in sola lettura sulla fatturazione del cliente: nome, email, saldo del conto e un ID cliente copiabile, più l'abbonamento — badge di stato, piano, valore mensile e data di inizio — e i pagamenti recenti con i numeri di fattura. I rimborsi sono l'unica scrittura opzionale: un admin deve attivare Consenti rimborsi dal pannello della conversazione nelle impostazioni dell'app (disattivato di default), l'operatore ha bisogno del permesso Esegui rimborsi e cancellazioni, e ogni rimborso va confermato digitando REFUND — Stripe non può annullare un rimborso una volta inviato.

Shopify#

Ordini recenti in sola lettura — numero d'ordine, data, totale, stato del pagamento e dell'evasione — con link a ciascun ordine e al record del cliente nel tuo admin Shopify. Si collega con il dominio del tuo negozio e un token Admin API di una custom app con gli scope read_customers e read_orders.

Mailchimp#

L'iscritto come lo vede Mailchimp: badge di stato, audience, tag, engagement e attività recente nelle campagne (invii, aperture, clic). È disponibile un'azione: Disiscrivi, per onorare una richiesta "smettete di scrivermi" senza lasciare la conversazione. È irreversibile via API — Mailchimp permette a una persona di riscriversi solo da sé tramite un modulo di iscrizione — quindi richiede una conferma digitata. Nota che le chiavi API di Mailchimp non hanno scope: la chiave che colleghi può leggere e scrivere tutto nell'account.

MailerLite#

Stato di iscrizione, gruppi, data di registrazione, engagement e attività recente nelle campagne. Due azioni: Disiscrivi (annullabile — l'API di MailerLite supporta la re-iscrizione) e Riscrivi, per rimettere qualcuno in lista su sua richiesta.

Jira#

Un collegamento bidirezionale tra conversazioni e issue di Jira Cloud. La scheda elenca le issue collegate a questa conversazione con il loro stato attuale, e offre Crea issue (archiviata nel progetto scelto, collegata automaticamente) e Collega esistente / Scollega per le issue che esistono già. I cambi di stato fatti in Jira rifluiscono attraverso un webhook: la pagina delle impostazioni dell'app mostra un indirizzo webhook segreto da incollare nel tuo sito Jira, e da quel momento la scheda rispecchia lo stato live della issue. Le issue vengono create come l'account Atlassian che colleghi, e la scheda vede esattamente ciò che vede quell'account.

Ogni azione eseguita dal pannello è vincolata ai permessi di ruolo — Usa le azioni delle app per disiscrizione, re-iscrizione e issue Jira, e Esegui rimborsi e cancellazioni per i rimborsi. Dove un'app offre anche un interruttore di capacità a livello workspace — oggi è Consenti rimborsi dal pannello della conversazione di Stripe — l'interruttore decide se la capacità esiste, e spegnerlo blocca tutti, incluso l'owner del workspace.

Tracio: umano o bot#

Tracio risponde a un'unica domanda su un visitatore del widget di chat: è un umano o un bot? Installare l'app abilita l'SDK di rilevamento di Tracio dentro il tuo widget di chat Respondo — le nuove conversazioni dal widget ricevono automaticamente un verdetto, mostrato come chip sulla scheda Tracio nel pannello della conversazione.

ChipSignificato
UmanoIl controllo server-side di Tracio non ha trovato segnali di bot per questo visitatore.
Bot · 93%Bot rilevato, con la confidenza di Tracio. La scheda elenca anche i segnali dietro il verdetto.
Non verificatoIl controllo server-side di Tracio non è disponibile in questo momento — la scheda ripiega sul verdetto riportato dal browser e lo dice.
ID contraffattoL'ID visitatore inviato dal browser è sconosciuto a Tracio — la dichiarazione sembra contraffatta.

Si collegano due chiavi: una chiave pubblica che attiva l'SDK nel widget, e una chiave segreta Data API usata per la verifica server-side del verdetto. Senza la verifica server-side, la dichiarazione "non sono un bot" di un browser non è affidabile da sola — e quando la dichiarazione del browser è in disaccordo con il verdetto del server, la scheda mostra entrambi.

Tracio funziona solo per le conversazioni del widget di chat. Email, Telegram e gli altri canali non hanno un visitatore da ispezionare, quindi la loro scheda Tracio spiega che non c'è nulla da controllare. Un verdetto mancante non è un sospetto: gli ad blocker tagliano l'SDK a umani reali in continuazione, e le conversazioni più vecchie iniziate prima che Tracio fosse collegato non hanno verdetto.
L'SDK di Tracio esegue il fingerprinting dei visitatori del tuo sito. Ottenere il consenso dei visitatori (tramite il tuo CMP / banner dei cookie) è una tua responsabilità come proprietario del sito.

Limitazioni#

  • Le schede Stripe e Shopify sono in sola lettura — l'unica scrittura in tutta l'app Stripe è l'azione di rimborso, opzionale ed esplicitamente abilitata.
  • Le app basate sull'email (Stripe, Shopify, Mailchimp, MailerLite) richiedono un indirizzo email verificato. Le conversazioni di visitatori anonimi del widget o di canali senza indirizzo mostrano un'onesta scheda "niente da cercare".
  • Il supporto Jira copre solo Jira Cloud.
  • Mailchimp non offre la re-iscrizione: una volta disiscritta, solo la persona stessa può riscriversi tramite un modulo di iscrizione. Usa la re-iscrizione di MailerLite se quel flusso ti serve.
  • I verdetti di Tracio esistono solo per le conversazioni del widget con l'SDK caricato — mai per i canali email o messenger.