
Connettore Stripe per FreeScout
Funziona con Stripe
Il Connettore Stripe mette il contesto di pagamento e abbonamento del cliente accanto a una conversazione di FreeScout. Usa una chiave API Stripe limitata e di sola lettura, così può cercare informazioni senza modificare nulla in Stripe.
Cerchi la panoramica?
Cosa mostra il connettore
Quando una conversazione FreeScout ha un indirizzo email del cliente, il connettore cerca in Stripe il cliente corrispondente e i record di pagamento recenti. A seconda di ciò che trova, la barra laterale può mostrare:
- Identità del cliente, con il nome collegato al cliente Stripe, più l'email e la data di iscrizione del cliente.
- Gli abbonamenti mostrano un'icona di link che apre l'abbonamento in Stripe, il periodo, un punto di stato colorato, il prezzo unitario del primo articolo con il suo intervallo di fatturazione come
€49/moppure€120/y, e il nome del prodotto (con fallback al soprannome del prezzo, poi a un'etichetta generica). Colonne come Cancellazioni, Fine prova o Sconto compaiono solo quando un piano le prevede. - Pagamenti in una tabella in stile ordine: un'icona di link che apre il pagamento in Stripe, la data, un punto di stato con eventuale rischio Radar e icone di verifica carta, il totale e un elenco ridotto degli articoli acquistati.
- Rimborsi e contestazioni mostrati come dettagli sulla riga di pagamento a cui appartengono. La colonna Dettagli appare solo quando almeno una riga ha qualcosa da mostrare.
- Pagamenti falliti con un motivo di rifiuto disponibile, mostrati nella stessa colonna Details.
- Importi con il simbolo della valuta dove esiste, ad esempio
€61oppure$12.50, altrimenti il codice valuta; le date vengono visualizzate in modo compatto, comeSep 24 '26. - Totali Acquisito, Rimborsi e Netto per i pagamenti caricati.
- Collegamento email: quando un cliente scrive da un indirizzo diverso da quello in Stripe, collega un'email Stripe al thread e il pannello mostra i pagamenti di quel cliente.
- Il marchio, le ultime quattro cifre e la scadenza di un metodo di pagamento salvato.
Quando il connettore può vedere solo una parte della cronologia dei pagamenti, una singola nota sotto i totali indica che i totali coprono solo i pagamenti caricati. Non si ripete su ogni totale.
Il connettore limita ogni ricerca e verifica solo i record collegati a quel cliente. Non analizza l'intero account Stripe alla ricerca di contestazioni o cronologia dei pagamenti. Un risultato vuoto o parziale non prova che non esista altro record in Stripe.
Prerequisiti
Prima di iniziare, assicurati di avere:
- Un'installazione FreeScout funzionante.
- Accesso alla dashboard Stripe che consente di creare una chiave API limitata.
- Una licenza ReplyRabbit Pro o Team attiva, oppure una licenza standalone Stripe Connector. La licenza standalone costa 18 EUR come acquisto una tantum per installazione FreeScout.
- ReplyRabbit installato solo se desideri il contesto di commercio AI opzionale, abilitato esplicitamente, per le bozze.
Accedi a la tua dashboard di ReplyRabbit. Un piano ReplyRabbit Pro o Team attivo include il download del connettore. Se non hai nessuno dei due piani, acquista lì la licenza standalone, poi scarica il connettore e conserva la sua chiave di licenza nella dashboard.
Crea una chiave API Stripe con restrizioni
Il connettore richiede una chiave Stripe chiave con restrizioni, non una chiave segreta. Crea una nuova chiave con restrizioni nella dashboard di Stripe. Imposta Clienti, Abbonamenti, Fatture, Addebiti, PaymentIntents, PaymentMethods, e Contestazioni a Leggi, e imposta Prodotti a Leggi per mostrare i nomi dei piani di abbonamento. Senza la lettura di Products, gli abbonamenti ricadono sul nickname del prezzo o su un'etichetta generica. Lascia ogni autorizzazione non correlata su Nessuno.
Non incollare una chiave segreta
Copia la chiave con restrizioni quando Stripe la mostra. Trattala come una password. Il connettore la crittografa al salvataggio e non mostra mai più il valore completo.
Installa il connettore
Scarica il connettore Stripe
Accedi a app.replyrabbit.app. Scarica il connettore tramite il tuo piano ReplyRabbit Pro o Team attivo, oppure acquista prima la licenza standalone Stripe Connector.Caricalo su FreeScout
In FreeScout, apri Moduli, usa il controllo di caricamento per selezionare il ZIP e installalo.Attiva il modulo
Attiva Connettore Stripe dall'elenco Moduli di FreeScout.
Configura una casella di posta
Apri le impostazioni del connettore Stripe
Apri la casella di posta FreeScout che deve mostrare il contesto di pagamento Stripe, quindi scegli Connettore Stripe dal suo menu delle impostazioni.Incolla la chiave con restrizioni
Abilita il connettore e incolla la chiave Stripe con restrizioni di sola lettura. Se hai acquistato la licenza standalone del connettore, incolla anche la sua chiave di licenza dal tuo account ReplyRabbit. Una licenza ReplyRabbit Pro o Team installata sblocca automaticamente lo Stripe Connector. Salva le impostazioni.Verifica la chiave salvata
Usa Verifica la chiave salvata per confermare che Stripe accetta la chiave e la sua autorizzazione di lettura clienti.Controlla una conversazione corrispondente
Apri una conversazione il cui indirizzo email del cliente esiste in Stripe e conferma che il pannello Stripe appare nella barra laterale.
Ogni casella di posta FreeScout memorizza la propria chiave Stripe crittografata. Puoi connettere account Stripe diversi a caselle di posta diverse.
Abbina un cliente che scrive da un'email diversa
Stripe abbina in base all'indirizzo email della conversazione. Quando scrive un collega, o il cliente usa un indirizzo diverso da quello del suo cliente Stripe, collega l'email giusta alla conversazione:
Trova il pannello Stripe
Apri la conversazione e trova il pannello Stripe nella barra laterale.Collega un'altra email
Scegli Collega un'altra email, poi scegli un indirizzo dal thread o digita l'indirizzo di fatturazione usato in Stripe.Controlla il pannello
Il pannello ora mostra i pagamenti di quel cliente, nota il Collegato a indirizzo, e offre Rimuovi collegamento. Le impostazioni del connettore elencano ogni link salvato con un Rimuovi azione per indirizzo.
Il collegamento mappa ogni indirizzo non-mailbox nel thread, il mittente, A e Cc, all'email Stripe che scegli. Questi collegamenti sono memorizzati per la casella di posta, quindi le conversazioni future da uno qualsiasi di essi si risolvono allo stesso cliente Stripe. Il connettore legge comunque solo i dati Stripe.
Contesto opzionale delle bozze ReplyRabbit
La barra laterale funziona senza ReplyRabbit. ReplyRabbit è necessario solo se vuoi avere i dettagli recenti di Stripe disponibili durante la generazione delle bozze AI.
Per aderire, imposta STRIPEINTEGRATION_COMMERCE_CONTEXT_ENABLED=true nell'ambiente FreeScout, poi abilita il connettore per la casella. Per il lato ReplyRabbit, imposta REPLYRABBIT_COMMERCE_CONTEXT_ENABLED=true per ogni casella, oppure scegli On per una casella in Impostazioni casella, Prodotti, Dati negozio nelle bozze. Quella riga appare nella vista Essentials una volta che un connettore negozio è disponibile per la casella; prima di allora, passa a Tutte le impostazioni per trovarla. Solo un admin FreeScout può modificarla. La scelta della casella sovrascrive l'impostazione del server; "Usa l'impostazione predefinita" (il valore predefinito) la segue. Entrambe le impostazioni sono disattivate per impostazione predefinita. Dopo aver modificato i valori dell'ambiente, esegui php artisan config:clear dalla directory di FreeScout così FreeScout rileva i nuovi valori invece di una configurazione in cache.
Stripe deve essere l'unico provider attivo con contesto completo per quella casella di posta. Se anche Shopify fornisce il contesto commerciale completo, ReplyRabbit esclude i dati commerciali dalle bozze finché non ne resta abilitato solo uno. Le ricerche di entitlement di Magento e WooCommerce non sono in conflitto. La barra laterale di Stripe resta disponibile per l'agente di supporto.
Gestione dei dati e limiti
Il connettore invia l'email della conversazione a Stripe tramite HTTPS per trovare i record corrispondenti relativi al cliente. Memorizza la chiave con restrizioni in forma crittografata. Non memorizza nella cache numeri di carta completi, payload Stripe grezzi, indirizzi di fatturazione, metadati, segreti dei payment intent o URL delle ricevute.
Le richieste Stripe usano la versione fissata 2026-02-25.clover versione API. Quando nessun record Cliente corrisponde, il connettore ispeziona non più di 200 addebiti recenti degli ultimi 90 giorni e confronta esattamente l'email localmente. Questo fallback per pagamenti ospiti è intenzionalmente incompleto.
La ricerca limitata mantiene reattiva la barra laterale e riduce gli accessi non necessari ai dati. Una singola nota sotto i totali spiega quando questi coprono solo i pagamenti caricati dal connettore. Per un controllo completo dell'account, usa la dashboard Stripe.
Risoluzione dei problemi
| Sintomo | Cosa controllare |
|---|---|
| Stripe rifiuta la chiave | Crea una nuova chiave con restrizioni con le autorizzazioni di lettura richieste. Non usare una chiave segreta completa. |
| La barra laterale è vuota per un acquirente noto | Conferma che l'email della conversazione FreeScout corrisponda esattamente all'email Stripe dell'acquirente. I pagamenti guest vengono controllati solo nel fallback limitato a 90 giorni e 200 addebiti. |
| Manca un rimborso o una contestazione | Il connettore verifica solo un insieme limitato di record recenti per quel cliente. Controlla la dashboard Stripe per la cronologia completa dell'account. |
| Le bozze di ReplyRabbit non includono il contesto di pagamento | Conferma che entrambi i flag di ambiente del contesto commerce siano true, il connettore Stripe è disponibile per la casella di posta e nessun altro provider commerciale è attivo. |
| Alcuni dettagli di pagamento non sono disponibili | Per un acquisto standalone, conferma che la chiave di licenza di Stripe Connector sia salvata nelle impostazioni del connettore e attiva per il dominio FreeScout previsto. Per l'accesso incluso, conferma che una licenza ReplyRabbit Pro o Team attiva sia installata sullo stesso sito FreeScout. |
Prossimi passi
- Leggi Come configurare ReplyRabbit se la casella richiede ancora impostazioni del provider AI o delle bozze.
- Vedi il Connettore Shopify, Connettore WooCommerce, oppure Connettore Magento guide per altre piattaforme di commercio.
FAQ
Il connettore Stripe scrive su Stripe?
No. Il connettore utilizza una chiave API ristretta di Stripe con solo i permessi di lettura documentati. Non crea rimborsi, non annulla abbonamenti, non ritenta addebiti e non modifica i dati di Stripe.
Se non viene mostrato alcun rimborso o contestazione, significa che non ce ne sono in Stripe?
No. Il connettore verifica un insieme limitato di record recenti per quel cliente. Un pannello vuoto descrive solo quei record, non l'intera cronologia dell'account Stripe.
I dati Stripe possono essere usati nelle bozze di ReplyRabbit?
Sì, dopo aver abilitato sia ReplyRabbit sia il contesto commerciale del Connettore Stripe e se Stripe è l'unico provider a contesto completo attivo della casella di posta. Se anche Shopify fornisce il contesto commerciale completo, ReplyRabbit esclude i dati commerciali dalle bozze finché non ne resta abilitato solo uno. Le verifiche di abilitazione di Magento e WooCommerce non entrano in conflitto.
Quanto costa il connettore Stripe?
Il Connettore Stripe è incluso con un piano ReplyRabbit Pro o Team attivo. In alternativa, costa 18 EUR come licenza una tantum per una installazione FreeScout.
Posso associare un cliente che scrive da un'email diversa?
Sì. Apri la conversazione, scegli Link another email nel pannello Stripe e seleziona un indirizzo dal thread o digitane uno. I collegamenti vengono memorizzati per la casella, così le conversazioni future da qualsiasi indirizzo collegato mostrano lo stesso cliente Stripe. Il pannello mostra quindi Manually connected, e da lì puoi scollegare.