
Conector de Stripe para FreeScout
Funciona con Stripe
El Conector de Stripe coloca el contexto de pagos y suscripciones del cliente junto a una conversación de FreeScout. Usa una clave de API de Stripe restringida y de solo lectura, por lo que puede consultar información sin cambiar nada en Stripe.
¿Buscas la descripción general?
Qué muestra el conector
Cuando una conversación de FreeScout tiene una dirección de correo del cliente, el conector busca en Stripe el cliente correspondiente y los registros de pago recientes. Según lo que encuentre, la barra lateral puede mostrar:
- Identidad del cliente, con el nombre vinculado al cliente de Stripe, además del correo y la fecha de alta como cliente.
- Suscripciones que muestran un icono de enlace que abre la suscripción en Stripe, el período, un punto de estado de color, el precio unitario del primer artículo con su intervalo de facturación como
€49/mo€120/y, y el nombre del producto (recurriendo al apodo del precio y luego a una etiqueta genérica). Columnas como Cancelaciones, Fin de prueba o Descuento solo aparecen cuando un plan las tiene. - Pagos en una tabla estilo pedido: un icono de enlace que abre el pago en Stripe, la fecha, un punto de estado con cualquier riesgo de Radar e iconos de verificación de tarjeta, el total y una lista recortada de los artículos comprados.
- Los reembolsos y las disputas se muestran como detalles en la fila de pago a la que pertenecen. La columna Detalles aparece solo cuando al menos una fila tiene algo que mostrar.
- Pagos fallidos con un motivo de rechazo disponible, mostrados en la misma columna Detalles.
- Importes con un símbolo de moneda cuando existe, por ejemplo
€61o$12.50, de lo contrario el código de moneda; las fechas se muestran de forma compacta, comoSep 24 '26. - Totales de Capturado, Reembolsos y Neto para los pagos cargados.
- Vinculación de correo electrónico: cuando un cliente escribe desde una dirección diferente a la de Stripe, vincule un correo electrónico de Stripe al hilo y el panel muestra los pagos de ese cliente.
- La marca, los últimos cuatro dígitos y la caducidad de un método de pago guardado.
Cuando el conector solo puede ver parte del historial de pagos, una única nota bajo los totales indica que los totales cubren solo los pagos cargados. No se repite en cada total.
El conector limita cada consulta y solo verifica los registros conectados a ese cliente. No escanea toda la cuenta de Stripe en busca de disputas o historial de pagos. Un resultado vacío o parcial no prueba que no exista otro registro en Stripe.
Requisitos previos
Antes de empezar, asegúrate de tener:
- Una instalación de FreeScout en funcionamiento.
- Acceso al panel de Stripe que te permita crear una clave de API restringida.
- Una licencia activa de ReplyRabbit Pro o Team, o una licencia independiente del Conector de Stripe. La licencia independiente cuesta 18 EUR como compra única por instalación de FreeScout.
- ReplyRabbit instalado solo si quieres el contexto opcional de comercio con IA para borradores, habilitado explícitamente.
Inicia sesión en tu panel de ReplyRabbit. Un plan ReplyRabbit Pro o Team activo incluye la descarga del conector. Si no tienes ninguno de los dos planes, compra allí la licencia independiente, luego descarga el conector y guarda su clave de licencia en el panel.
Crear una clave de API de Stripe restringida
El conector necesita un Stripe clave restringida, no una clave secreta. Crea una nueva clave restringida en el panel de Stripe. Configura Clientes, Suscripciones, Facturas, Cargos, PaymentIntents, PaymentMethods, y Disputas a Leer, y configura Productos a Leer para mostrar los nombres de los planes de suscripción. Sin permiso de lectura de Productos, las suscripciones recurren al apodo del precio o a una etiqueta genérica. Deja cada conjunto de permisos no relacionado en Ninguno.
No pegue una clave secreta
Copia la clave restringida cuando Stripe la muestre. Trátala como una contraseña. El conector la cifra al guardarla y nunca vuelve a mostrar el valor completo.
Instala el conector
Descargar conector de Stripe
Inicia sesión en app.replyrabbit.app. Descarga el conector a través de tu plan ReplyRabbit Pro o Team activo, o compra primero la licencia independiente del Conector de Stripe.Súbelo a FreeScout
En FreeScout, abre Módulos, usa el control de subida para seleccionar el ZIP e instálalo.Activa el módulo
Activar Conector de Stripe desde la lista de Módulos de FreeScout.
Configurar un buzón
Abrir los ajustes del Conector de Stripe
Abre el buzón de FreeScout que debe mostrar el contexto de pago de Stripe y luego elige Conector de Stripe desde su menú de configuración.Pega la clave restringida
Activar el conector y pegar la clave restringida de solo lectura de Stripe. Si compraste la licencia independiente del conector, pega también su clave de licencia desde tu cuenta de ReplyRabbit. Una licencia de ReplyRabbit Pro o Team instalada desbloquea el conector de Stripe automáticamente. Guarda la configuración.Probar la clave guardada
Usar Probar la clave guardada para confirmar que Stripe acepta la clave y su permiso de lectura de clientes.Comprobar una conversación coincidente
Abre una conversación cuyo correo de cliente exista en Stripe y confirma que el panel de Stripe aparece en la barra lateral.
Cada buzón de FreeScout almacena su propia clave de Stripe cifrada. Puede conectar diferentes cuentas de Stripe a diferentes buzones.
Coincidir con un cliente que escribe desde un correo electrónico diferente
Stripe empareja por la dirección de correo electrónico de la conversación. Cuando escribe un colega, o el cliente usa una dirección diferente a la de su cliente de Stripe, vincula el correo electrónico correcto al hilo:
Encuentra el panel de Stripe
Abre la conversación y busca el panel de Stripe en la barra lateral.Vincular otro correo electrónico
Elegir Vincular otro correo electrónico, luego elige una dirección del hilo o escribe la dirección de facturación usada en Stripe.Comprobar el panel
El panel ahora muestra los pagos de ese cliente, señala el Vinculado a dirección, y ofrece Eliminar vínculo. La configuración del conector enumera cada enlace guardado con un Eliminar acción por dirección.
La vinculación asigna cada dirección que no sea del buzón en el hilo, el remitente, Para y Cc, al correo electrónico de Stripe que elijas. Esos vínculos se almacenan para el buzón, por lo que las futuras conversaciones de cualquiera de ellos se resuelven al mismo cliente de Stripe. El conector sigue leyendo únicamente datos de Stripe.
Contexto de borrador opcional de ReplyRabbit
La barra lateral funciona sin ReplyRabbit. ReplyRabbit solo es necesario si quieres tener los detalles recientes de Stripe disponibles al generar borradores con IA.
Para optar por ello, establece STRIPEINTEGRATION_COMMERCE_CONTEXT_ENABLED=true en el entorno de FreeScout, y luego activa el conector para el buzón. Por el lado de ReplyRabbit, configura REPLYRABBIT_COMMERCE_CONTEXT_ENABLED=true para cada buzón, o elige On para un buzón en Configuración del buzón, Productos, Datos de tienda en borradores. Esa fila aparece en la vista Essentials una vez que hay un conector de tienda disponible para el buzón; antes de eso, cambia a All settings para encontrarla. Solo un admin de FreeScout puede cambiarlo. La elección del buzón anula la configuración del servidor; "Use the default setting" (el valor predeterminado) la sigue. Ambas opciones están desactivadas por defecto. Tras cambiar los valores del entorno, ejecuta php artisan config:clear desde el directorio de FreeScout para que FreeScout recoja los nuevos valores en lugar de una configuración en caché.
Stripe debe ser el único proveedor de contexto completo activo para ese buzón. Si Shopify también proporciona contexto comercial completo, ReplyRabbit deja los datos comerciales fuera de los borradores hasta que solo quede uno habilitado. Las consultas de derechos de Magento y WooCommerce no entran en conflicto. La barra lateral de Stripe sigue disponible para el agente de soporte.
Manejo de datos y límites
El conector envía el correo de la conversación a Stripe por HTTPS para encontrar registros coincidentes del cliente. Almacena la clave restringida cifrada. No almacena en caché números de tarjeta completos, cargas útiles sin procesar de Stripe, direcciones de facturación, metadatos, secretos de intención de pago ni URL de recibos.
Las solicitudes de Stripe usan la versión fijada 2026-02-25.clover Versión de la API. Cuando ningún registro de Customer coincide, el conector inspecciona no más de 200 cargos recientes de los últimos 90 días y compara el correo exactamente de forma local. Este respaldo para pagos de invitado es intencionadamente incompleto.
La consulta limitada mantiene la barra lateral receptiva y reduce el acceso innecesario a datos. Una sola nota bajo los totales explica cuándo cubren solo los pagos que cargó el conector. Para una auditoría completa de toda la cuenta, usa el panel de Stripe.
Resolución de problemas
| Síntoma | Qué comprobar |
|---|---|
| Stripe rechaza la clave | Crea una nueva clave restringida con los permisos de lectura requeridos. No uses una clave secreta completa. |
| La barra lateral está vacía para un comprador conocido | Confirmar que el correo electrónico de la conversación de FreeScout coincide exactamente con el correo electrónico de Stripe del comprador. Los pagos de invitados solo se comprueban dentro del respaldo acotado de 90 días y 200 cargos. |
| Falta un reembolso o una disputa | El conector solo verifica un conjunto limitado de registros recientes de ese cliente. Consulta el panel de Stripe para el historial completo de la cuenta. |
| Los borradores de ReplyRabbit no incluyen contexto de pago | Confirmar que ambas marcas de entorno de contexto de comercio están true, el conector de Stripe está disponible para el buzón y no hay ningún otro proveedor de comercio activo. |
| Algunos detalles de pago no están disponibles | Para una compra independiente, confirma que la clave de licencia de Stripe Connector está guardada en la configuración del conector y activa para el dominio de FreeScout previsto. Para el acceso incluido, confirma que hay una licencia activa de ReplyRabbit Pro o Team instalada en el mismo sitio de FreeScout. |
Próximos pasos
- Leer Cómo configurar ReplyRabbit si el buzón aún necesita configuración de proveedor de IA o de borradores.
- Ver el Conector de Shopify, Conector de WooCommerce, o Conector de Magento guías para otras plataformas de comercio.
Preguntas frecuentes
¿El conector de Stripe escribe en Stripe?
No. El conector usa una clave de API restringida de Stripe con solo los permisos de lectura documentados. No crea reembolsos, cancela suscripciones, reintenta cargos ni modifica datos de Stripe.
Si no se muestra ningún reembolso o disputa, ¿significa que no existe ninguno en Stripe?
No. El conector comprueba un conjunto limitado de registros recientes de ese cliente. Un panel vacío describe solo esos registros, no el historial completo de la cuenta de Stripe.
¿Se pueden usar datos de Stripe en los borradores de ReplyRabbit?
Sí, después de que habilites tanto ReplyRabbit como el contexto comercial del conector de Stripe y Stripe sea el único proveedor de contexto completo activo del buzón. Si Shopify también está aportando contexto comercial completo, ReplyRabbit deja los datos comerciales fuera de los borradores hasta que solo quede uno habilitado. Las consultas de habilitación de Magento y WooCommerce no entran en conflicto.
¿Cuánto cuesta el conector de Stripe?
El Conector de Stripe está incluido con un plan ReplyRabbit Pro o Team activo. De lo contrario, cuesta 18 EUR como licencia única para una instalación de FreeScout.
¿Puedo hacer coincidir a un cliente que escribe desde un correo diferente?
Sí. Abre la conversación, elige Link another email en el panel de Stripe y selecciona una dirección del hilo o escribe una. Los vínculos se recuerdan para el buzón, por lo que las futuras conversaciones de cualquier dirección vinculada mostrarán el mismo cliente de Stripe. El panel muestra entonces Manually connected, y puedes desvincular desde ahí.