Passar para o conteúdo principal

Use Data connector templates

Modelos de Data connector disponíveis para Fin AI Agent usando apps de terceiros.

Escrito por Beth-Ann Sher

Os modelos de Data connector para Fin usam apps de terceiros que você instalou no seu workspace para configurar automaticamente o Data connector, deixando-o pronto para testar e ativar instantaneamente.

Para usar esses modelos, vá para Settings > Integrations > Data connectors e clique em New em seguida selecione um dos modelos disponíveis para um app que você instalou.


Shopify Storefront Data connectors

Ao configurar esses Data connectors, o Fin pode resolver completamente solicitações de clientes que desejam obter informações da sua Shopify Storefront. Isso usa sua integração existente Shopify integration, portanto não há conexões adicionais que você precise fazer com outra ferramenta.

Basta ativar esses Data connectors usando as condições predefinidas ou definir suas próprias condições para dizer ao Fin quais requisitos devem ser atendidos antes de obter informações do Shopify.

Casos de uso comuns

Use esses Data connectors para:

  • Search Shop Catalog: Pesquisar produtos da loja online hospedada no Shopify.

  • Get Cart: Obter o carrinho incluindo itens, opções de envio, informações de desconto e URL de checkout para um determinado id de carrinho.

  • Update Cart: Realizar atualizações em um carrinho, incluindo adicionar/remover/atualizar itens, informações do comprador, detalhes de envio, códigos de desconto, gift cards e notas em uma única chamada consolidada.

  • Search Shop Policies And Faqs: Usado para obter fatos sobre as políticas da loja, produtos ou serviços.

  • Get Product Details: Procurar um produto por ID e, opcionalmente, especificar opções de variante para selecionar uma variante específica.

Note: Data connectors não suportam parâmetros de objeto aninhado ou array, o que impede pesquisas dinâmicas de produtos usando a ferramenta Shopify search_catalog via MCP connectors. Para habilitar busca de produtos e recomendações, sincronize os dados do seu catálogo Shopify na knowledge base da Fin e use a integração nativa do Shopify em vez disso.

Uma configuração típica para um Data connector do Shopify pode ser assim…

  • Data connector name: Get order info

  • When to use: Use para obter detalhes sobre os pedidos do cliente e ajudar a solucionar quaisquer problemas relacionados a pedidos. Este Data connector fornecerá todos os detalhes do pedido para o cliente, como status do pedido, itens comprados, endereço de envio, informações de rastreamento ou outros detalhes relevantes do pedido.

    • Exemplos de consultas de clientes incluem:

      • Qual é o status do meu pedido?

      • Meu pedido foi enviado?

      • Você pode me enviar meu link de rastreamento?

      • Para onde meu pedido será enviado?

    Este Data connector não executa funções de gerenciamento de pedidos como devoluções, reembolsos ou atualização de um pedido.

  • Who it’s available for: Users and “shopify_orders_count” is “greater than 0”.

Note: Você deve instalar o Shopify app no seu workspace para usar esses modelos de Data connector para Shopify.


Statuspage Data connectors

Get unresolved incidents

Ao configurar este Data connector, o Fin pode resolver completamente solicitações de clientes que desejam saber sobre incidentes ou verificar o desempenho do sistema. Isso usa sua integração existente Statuspage integration, portanto não há conexões adicionais que você precise fazer com outra ferramenta.

Basta ativar este Data connector usando as condições predefinidas ou definir suas próprias condições para dizer ao Fin quais requisitos devem ser atendidos antes de obter incidentes não resolvidos do Statuspage.

Casos de uso comuns

Use este Data connector quando clientes quiserem saber:

  • Quando um incidente começou.

  • O status atual do problema.

  • Quais produtos ou serviços são afetados por um incidente.

  • Se o problema foi totalmente resolvido.

  • Se o desempenho do sistema voltou ao normal.

Como este modelo é configurado

Uma configuração típica para este Data connector pode ser assim…

  • Data connector name: Get unresolved incidents

  • When to use: Use este Data connector para procurar incidentes não resolvidos.

    • Exemplos de consultas de clientes incluem:

      • Quando um incidente começou?

      • Qual é o status atual do problema?

      • Quais produtos ou serviços são afetados por um incidente?

      • O problema foi totalmente resolvido?

      • O desempenho do sistema voltou ao normal?

  • Who it’s available for: Leads, Users, and Visitors

Note: Você deve instalar o Statuspage app no seu workspace para usar este modelo de Data connector.


Stripe Data connectors

Get subscription info

Ao configurar este Data connector, o Fin pode resolver completamente solicitações de clientes que precisam de informações sobre sua assinatura através do Stripe. Isso usa sua integração existente Stripe integration, portanto não há conexões adicionais que você precise fazer com outra ferramenta.

Basta ativar este Data connector usando as condições predefinidas ou definir suas próprias condições para dizer ao Fin quais requisitos devem ser atendidos antes de obter detalhes de assinatura do Stripe.Se você tiver grandes respostas de API (mais de 2000 caracteres), ou tiver datas em timestamp Unix como 1757082297, recomendamos fortemente usar o bloco de código. Há uma funcionalidade que recomendará automaticamente o código se detectar timestamps unix ou payloads grandes.

Casos de uso comuns

Use este Data connector quando clientes quiserem saber:

  • Qual é o status da minha assinatura.

  • Quando serei cobrado.

  • A qual plano estou inscrito.

  • Com que frequência sou cobrado.

  • Quando minha assinatura será renovada.

Como este modelo é configurado

Uma configuração típica para este Data connector pode ser assim…

  • Data connector name: Get subscription info

  • When to use: Use para obter detalhes sobre as assinaturas do cliente e ajudar a solucionar quaisquer problemas relacionados a assinaturas. Este Data connector fornecerá todas as informações de assinatura para o cliente, como status da assinatura, frequência de cobrança, próxima data de cobrança ou detalhes do plano.

    • Exemplos de consultas de clientes incluem:

      • Qual é o status da minha assinatura?

      • Quando serei cobrado novamente?

      • Você pode me dizer a qual plano estou inscrito?

      • Com que frequência estou sendo cobrado pela minha assinatura?

      • Quando minha assinatura é renovada?

    Este Data connector não realiza funções de gerenciamento de assinaturas como pausar, cancelar ou atualizar.

  • Who it’s available for: Users and “Plan” is “Paid”.

Note: Você deve instalar o Stripe app no seu workspace para usar este modelo de Data connector.

Get charges

Ao configurar este Data connector, o Fin pode resolver completamente solicitações de clientes que queiram saber sobre seus pagamentos recentes através do Stripe. Isso usa sua integração existente Stripe integration, portanto não há conexões adicionais que você precise fazer com outra ferramenta.

Basta ativar este Data connector usando as condições predefinidas ou definir suas próprias condições para dizer ao Fin quais requisitos devem ser atendidos antes de obter informações de pagamento do Stripe.

Casos de uso comuns

Use este Data connector quando clientes quiserem saber:

  • Por que meu último pagamento falhou

  • Quando receberei um reembolso.

  • Um detalhamento do que me foi cobrado.

  • Qual cartão usei por último para efetuar um pagamento.

Como este modelo é configurado

Uma configuração típica para este Data connector pode ser assim…

  • Data connector name: Get charges

  • When to use: Use para obter informações de pagamento de uma conta de cliente e ajudar a solucionar quaisquer problemas relacionados a cobranças ou pagamentos. Este Data connector fornecerá informações sobre status de pagamentos e reembolsos, moeda utilizada, detalhes do cartão usado ou valores cobrados.

    • Exemplos de consultas de clientes incluem:

      • Por que meu pagamento falhou?

      • Quando receberei meu reembolso?

      • Pelo que fui cobrado?

      • Qual cartão eu usei?

    Este Data connector não realiza Data connectors como coletar um pagamento ou emitir um reembolso.

  • Who it’s available for: Users and “Plan” is “Paid”.

Note: Você deve instalar o Stripe app no seu workspace para usar este modelo de Data connector.

Stripe limitations and custom setups

Note: A automação de email nativa do Stripe pode enviar faturas e recibos automaticamente, mas esse é um comportamento do lado do Stripe — não controlado pelo Fin ou por esta integração. Se você quiser que o Fin envie faturas ou recibos mediante solicitação, isso requer um data connector personalizado com capacidade de escrita/ação; os modelos padrão do Stripe acima cobrem apenas consultas de leitura de assinaturas e pagamentos.

Note: Se você configurar um conector de cancelamento, restrinja-o a solicitações de cancelamento voluntárias e simples. Use um Fin Procedure para verificações de elegibilidade, confirmações ou qualquer lógica de ramificação — e defina critérios de transferência no Escalation Guidance do Fin. Em termos de tempo, observe que os data connectors padrão têm um tempo limite de 15 segundos; data connectors usados dentro de Procedures em workspaces elegíveis têm um tempo limite de 30 segundos.

Respondeu à sua pergunta?