
Conector Stripe para FreeScout
Funciona com Stripe
O Conector Stripe coloca o contexto de pagamento e assinatura do cliente ao lado de uma conversa do FreeScout. Ele usa uma chave de API Stripe restrita e somente leitura, para que possa consultar informações sem alterar nada no Stripe.
Procurando a visão geral?
O que o conector mostra
Quando uma conversa do FreeScout tem um endereço de e-mail de cliente, o conector pesquisa no Stripe registros de cliente e pagamentos recentes correspondentes. Dependendo do que encontrar, a barra lateral pode mostrar:
- Identidade do cliente, com o nome vinculado ao cliente do Stripe, além do e-mail e da data de cliente desde.
- Assinaturas mostrando um ícone de link que abre a assinatura no Stripe, o período, um ponto de status colorido, o preço unitário do primeiro item com seu intervalo de cobrança, como
€49/mou€120/y, e o nome do produto (recorrendo ao apelido do preço e, em seguida, a um rótulo genérico). Colunas como Cancels, Trial end ou Discount aparecem apenas quando um plano as possui. - Pagamentos em uma tabela no estilo de pedido: um ícone de link que abre o pagamento no Stripe, a data, um ponto de status com qualquer risco do Radar e ícones de verificação de cartão, o total e uma lista reduzida dos itens comprados.
- Reembolsos e disputas exibidos como detalhes na linha de pagamento a que pertencem. A coluna Detalhes aparece apenas quando pelo menos uma linha tem algo a mostrar.
- Pagamentos com falha com um motivo de recusa disponível, exibidos na mesma coluna Details.
- Valores com símbolo de moeda quando existe, por exemplo
€61ou$12.50, caso contrário, o código da moeda; as datas são renderizadas de forma compacta, comoSep 24 '26. - Totais de Capturado, Reembolsos e Líquido para os pagamentos carregados.
- Vínculo de email: quando um cliente escreve de um endereço diferente do que está no Stripe, vincule um email do Stripe à thread e o painel mostra os pagamentos desse cliente.
- A bandeira, os últimos quatro dígitos e a validade de um método de pagamento salvo.
Quando o conector só consegue ver parte do histórico de pagamentos, uma única nota sob os totais diz que os totais cobrem apenas os pagamentos carregados. Ela não se repete em cada total.
O conector limita cada consulta e verifica apenas registros conectados a esse cliente. Ele não varre toda a conta Stripe em busca de disputas ou histórico de pagamentos. Um resultado vazio ou parcial não prova que não exista outro registro no Stripe.
Pré-requisitos
Antes de começar, certifique-se de ter:
- Uma instalação funcional do FreeScout.
- Acesso ao painel do Stripe que permite criar uma chave de API restrita.
- Uma licença ativa do ReplyRabbit Pro ou Team, ou uma licença autônoma do Stripe Connector. A licença autônoma custa 18 EUR como compra única por instalação do FreeScout.
- ReplyRabbit instalado apenas se você quiser o contexto opcional de comércio de IA para rascunhos, habilitado explicitamente.
Entre no seu painel do ReplyRabbit. Um plano ReplyRabbit Pro ou Team ativo inclui o download do conector. Se você não tem nenhum dos dois planos, compre a licença autônoma ali, depois baixe o conector e guarde sua chave de licença no painel.
Criar uma chave de API restrita do Stripe
O conector precisa de uma chave Stripe chave restrita, não uma chave secreta. Crie uma nova chave restrita no painel do Stripe. Defina Clientes, Assinaturas, Faturas, Cobranças, PaymentIntents, PaymentMethods, e Disputas para Ler, e defina Produtos para Ler para mostrar os nomes dos planos de assinatura. Sem leitura de Products, as assinaturas recorrem ao apelido do preço ou a um rótulo genérico. Deixe todos os conjuntos de permissões não relacionados como Nenhum.
Não cole uma chave secreta
Copie a chave restrita quando o Stripe a exibir. Trate-a como uma senha. O conector a criptografa ao salvar e nunca mostra o valor completo novamente.
Instale o conector
Baixar o Stripe Connector
Entre em app.replyrabbit.app. Baixe o conector através do seu plano ReplyRabbit Pro ou Team ativo, ou compre primeiro a licença autônoma do Stripe Connector.Envie-o para o FreeScout
No FreeScout, abra Módulos, use o controle de upload para selecionar o ZIP e instale-o.Ative o módulo
Ativar Conector Stripe da lista de Módulos do FreeScout.
Configurar uma caixa de correio
Abrir configurações do Conector Stripe
Abra a caixa de correio do FreeScout que deve mostrar o contexto de pagamento do Stripe e escolha Conector Stripe do menu de configurações dele.Cole a chave restrita
Ative o conector e cole a chave Stripe restrita somente leitura. Se você comprou a licença do conector autônomo, cole também a chave de licença da sua conta ReplyRabbit. Uma licença ReplyRabbit Pro ou Team instalada desbloqueia o Stripe Connector automaticamente. Salve as configurações.Testar a chave salva
Usar Testar chave salva para confirmar que o Stripe aceita a chave e sua permissão de leitura de clientes.Verifique uma conversa correspondente
Abra uma conversa cujo e-mail do cliente exista no Stripe e confirme que o painel do Stripe aparece na barra lateral.
Cada caixa de correio do FreeScout armazena sua própria chave do Stripe criptografada. Você pode conectar diferentes contas do Stripe a diferentes caixas de correio.
Combine um cliente que escreve de um e-mail diferente
O Stripe corresponde pelo endereço de e-mail da conversa. Quando um colega escreve, ou o cliente usa um endereço diferente do que está no cliente Stripe, vincule o e-mail correto à conversa:
Encontre o painel Stripe
Abra a conversa e localize o painel do Stripe na barra lateral.Vincular outro e-mail
Escolha Vincular outro e-mail, então escolha um endereço da conversa ou digite o endereço de cobrança usado no Stripe.Verifique o painel
O painel agora mostra os pagamentos desse cliente, observa o Vinculado a endereço, e oferece Remover vínculo. As configurações do conector listam cada link salvo com um Remover ação por endereço.
A vinculação mapeia todos os endereços que não são da caixa de correio na conversa, o remetente, Para e Cc, para o e-mail do Stripe que você escolher. Esses vínculos são armazenados para a caixa de correio, então conversas futuras de qualquer um deles resolvem para o mesmo cliente do Stripe. O conector ainda só lê dados do Stripe.
Contexto opcional de rascunho do ReplyRabbit
A barra lateral funciona sem o ReplyRabbit. O ReplyRabbit só é necessário se você quiser detalhes recentes do Stripe disponíveis ao gerar rascunhos de IA.
Para aderir, defina STRIPEINTEGRATION_COMMERCE_CONTEXT_ENABLED=true no ambiente do FreeScout, então ative o conector para a caixa de correio. Do lado do ReplyRabbit, defina REPLYRABBIT_COMMERCE_CONTEXT_ENABLED=true para cada caixa de correio, ou escolha Ativado para uma caixa de correio em Configurações da caixa de correio, Produtos, Dados da loja em rascunhos. Essa linha aparece na visualização Essentials assim que um conector de loja estiver disponível para a caixa de correio; antes disso, mude para Todas as configurações para encontrá-la. Apenas um admin do FreeScout pode alterá-la. A escolha da caixa de correio substitui a configuração do servidor; "Usar a configuração padrão" (o padrão) a segue. Ambas as configurações são desativadas por padrão. Após alterar valores de ambiente, execute php artisan config:clear do diretório do FreeScout para que o FreeScout capture os novos valores em vez de uma configuração em cache.
O Stripe deve ser o único provedor de contexto completo ativo para essa caixa de correio. Se o Shopify também estiver fornecendo contexto comercial completo, o ReplyRabbit deixa os dados comerciais fora dos rascunhos até que apenas um permaneça habilitado. As consultas de direitos do Magento e WooCommerce não entram em conflito. A barra lateral do Stripe permanece disponível para o agente de suporte.
Tratamento de dados e limites
O conector envia o e-mail da conversa ao Stripe via HTTPS para encontrar registros correspondentes no escopo do cliente. Ele armazena a chave restrita criptografada. Ele não armazena em cache números completos de cartão, payloads brutos do Stripe, endereços de cobrança, metadados, segredos de intenção de pagamento ou URLs de recibo.
As solicitações do Stripe usam o 2026-02-25.clover Versão da API. Quando nenhum registro de Cliente corresponde, o conector inspeciona no máximo 200 cobranças recentes dos últimos 90 dias e faz correspondência exata do e-mail localmente. Esse fallback de pagamento de convidado é intencionalmente incompleto.
A consulta limitada mantém a barra lateral responsiva e reduz o acesso desnecessário a dados. Uma única nota sob os totais explica quando eles cobrem apenas os pagamentos que o conector carregou. Para uma auditoria completa de toda a conta, use o painel do Stripe.
Solução de problemas
| Sintoma | O que verificar |
|---|---|
| O Stripe rejeita a chave | Crie uma nova chave restrita com as permissões de leitura necessárias. Não use uma chave secreta completa. |
| A barra lateral está vazia para um comprador conhecido | Confirme se o e-mail da conversa do FreeScout corresponde exatamente ao e-mail do Stripe do comprador. Pagamentos de convidados só são verificados dentro do fallback limitado de 90 dias e 200 cobranças. |
| Falta um reembolso ou disputa | O conector verifica apenas um conjunto limitado de registros recentes desse cliente. Consulte o painel do Stripe para o histórico completo da conta. |
| Os rascunhos do ReplyRabbit não incluem contexto de pagamento | Confirme se ambos os sinalizadores de ambiente de contexto de comércio estão true, o conector do Stripe está disponível para a caixa de correio e nenhum outro provedor de comércio está ativo. |
| Alguns detalhes de pagamento não estão disponíveis | Para uma compra autônoma, confirme que a chave de licença do Stripe Connector está salva nas configurações do conector e ativa para o domínio FreeScout pretendido. Para acesso incluído, confirme que uma licença ReplyRabbit Pro ou Team ativa está instalada no mesmo site FreeScout. |
Próximos passos
- Ler Como configurar o ReplyRabbit se a caixa de correio ainda precisa de configurações de provedor de IA ou de rascunho.
- Veja o Conector Shopify, Conector WooCommerce, ou Conector Magento guias para outras plataformas de comércio.
FAQ
O Stripe Connector grava no Stripe?
Não. O conector usa uma chave restrita da API do Stripe com apenas as permissões de leitura documentadas. Ele não cria reembolsos, cancela assinaturas, repete cobranças nem altera dados do Stripe.
Se nenhum reembolso ou disputa for exibido, isso significa que não existem no Stripe?
Não. O conector verifica um conjunto limitado de registros recentes daquele cliente. Um painel vazio descreve apenas esses registros, não o histórico completo da conta Stripe.
Os dados do Stripe podem ser usados nos rascunhos do ReplyRabbit?
Sim, depois que você ativar o contexto de comércio do ReplyRabbit e do Stripe Connector e o Stripe for o único provedor de contexto completo ativo da caixa de correio. Se o Shopify também estiver fornecendo contexto de comércio completo, o ReplyRabbit deixa os dados de comércio fora dos rascunhos até que apenas um permaneça ativado. As consultas de direito do Magento e do WooCommerce não entram em conflito.
Quanto custa o Conector Stripe?
O Conector Stripe está incluído em um plano ReplyRabbit Pro ou Team ativo. Caso contrário, custa 18 EUR como licença única para uma instalação do FreeScout.
Posso corresponder a um cliente que escreve de um e-mail diferente?
Sim. Abra a conversa, escolha Link another email no painel do Stripe e escolha um endereço da conversa ou digite um. Os vínculos são lembrados para a caixa de correio, então conversas futuras de qualquer endereço vinculado mostram o mesmo cliente Stripe. O painel então mostra Manually connected, e você pode desvincular por lá.