Integração com o Stripe

A integração com o Stripe no Deskwoot traz o histórico de pagamentos de cada cliente, as assinaturas ativas e os detalhes de cobrança para a barra lateral da conversa, para que os agentes vejam o contexto financeiro sem trocar de aba ou pedir que o cliente leia os dados do cartão. Em vez de alternar entre abas ou pedir que os clientes confirmem dados de pagamento, os agentes podem ver o histórico de pagamentos, as assinaturas ativas e as informações de cobrança ao lado de cada conversa. Isso leva a resoluções mais rápidas e a uma experiência mais agradável para o cliente.

Conectando o Stripe

1. Acesse Configurações > Integrações e abra o Stripe.
2. Clique em Instalar no Stripe Marketplace. Você chega à página do Deskwoot no Stripe.
3. Clique em Install e confirme as permissões de que o Deskwoot precisa: clientes (ler), assinaturas (ler e gravar), cobranças e reembolsos (ler e gravar), produtos (ler) e faturas (ler).
4. Logo após a instalação, o Stripe mostra uma chave de API restrita (começa com rk_live_, ou rk_test_ no modo de teste). Copie, cole no campo Chave de API restrita do Deskwoot e clique em Conectar.

Em seguida, o Deskwoot importa seus clientes do Stripe como contatos, e de novo uma vez por dia. As permissões de gravação só são usadas quando um agente (ou o Fynn, se você permitir) reembolsa um pagamento ou cancela uma assinatura. O Deskwoot não cria cobranças.

Histórico de pagamentos

Depois de conectado, a aba Detalhes da conversa mostra os pagamentos recentes do cliente (até 10), incluindo:

• Descrição, valor e moeda
• Data do pagamento
• Status (aprovado, falhou ou reembolsado)

Os pagamentos são associados pelo endereço de e-mail do cliente, então o e-mail do contato no Deskwoot precisa coincidir com o e-mail cadastrado no Stripe para que os dados apareçam. Quando vários clientes do Stripe têm o mesmo e-mail, o Deskwoot mostra o mais recente.

Agentes que podem emitir reembolsos (administradores e, no Enterprise, membros cuja função personalizada permite) veem o botão Reembolsar ao lado de um pagamento aprovado. Ele reembolsa o pagamento inteiro depois de uma confirmação, e o reembolso fica registrado no log de auditoria do Deskwoot.

Assinaturas e faturas

Para clientes com assinaturas no Stripe, a aba Detalhes exibe o nome do plano, o preço e o intervalo de cobrança, o status atual e a data de renovação, de término ou do fim do teste. As últimas 5 faturas do cliente aparecem com status, valor e um link para a página da fatura no Stripe, junto com o saldo do cliente (crédito para as próximas faturas ou valor devido). Agentes que podem cancelar veem Cancelar ao lado de uma assinatura ativa: ela termina no fim do período de cobrança atual, então o cliente mantém o que já pagou.

Visibilidade de reembolsos

Reembolsos ficam sinalizados no histórico de pagamentos: um pagamento reembolsado por completo mostra o status Reembolsado, o que ajuda a responder a dúvidas de cobrança sem precisar entrar no Stripe. Contestações (chargebacks) não aparecem no Deskwoot; elas ficam no seu painel do Stripe.

Solução de problemas

• Nenhum dado de pagamento aparecendo: Verifique se o endereço de e-mail do cliente no Deskwoot coincide exatamente com o e-mail associado à conta dele no Stripe. Mesmo pequenas diferenças (como maiúsculas e minúsculas) podem impedir a correspondência.
• Chave recusada: Cole a chave restrita que o Stripe mostrou após a instalação (começa com rk_live_ ou rk_test_), não a chave publicável (pk_). Se a aba Detalhes disser que o Stripe recusou a chave conectada, ela pode ter sido revogada, expirado ou estar sem alguma permissão; confira a conexão do Stripe em Configurações > Integrações.
• Dados desatualizados: As informações de pagamento são lidas ao vivo no Stripe sempre que uma conversa é aberta. Se os dados parecerem antigos, recarregue a conversa.

Boas práticas

• Garanta que sua equipe use endereços de e-mail de cliente consistentes entre o Deskwoot e o Stripe para uma correspondência de dados confiável.
• Use a barra lateral de pagamentos para verificar transações antes de responder a dúvidas de cobrança. Isso reduz idas e vindas e gera confiança no cliente.
• Reembolsos totais e cancelamentos no fim do período de cobrança funcionam pela aba Detalhes. Reembolsos parciais e mudanças de plano continuam no seu painel do Stripe.

Perguntas frequentes