Passar para o conteúdo principal

Use modelos de conector de dados

Modelos de conector de dados disponíveis para Fin AI Agent usando aplicativos de terceiros.

Escrito por Beth-Ann Sher

Modelos de conector de dados permitem que você instale um conector de dados pré-construído e pronto para uso a partir de um catálogo de modelos agrupados por aplicativo. Os modelos são configurados automaticamente para você usando suas integrações instaladas, então estão prontos para testar e ativar instantaneamente — e conforme a Intercom os melhora ao longo do tempo, você é notificado e pode revisar quaisquer alterações antes de aplicá-las.

Para usar esses modelos, vá para Configurações > Integrações > Conectores de dados, clique em Novo e escolha Começar a partir de um modelo. Você verá modelos agrupados por aplicativo — selecione o modelo que deseja instalar.


Como os modelos funcionam

Instalando a partir do catálogo

O catálogo de modelos mostra todos os modelos pré-construídos disponíveis agrupados por aplicativo (por exemplo, Stripe, Shopify e Statuspage). Navegar e instalar está integrado ao novo fluxo de conector — selecione Começar a partir de um modelo ao criar um conector, escolha seu aplicativo e selecione o modelo desejado.

Instalar um modelo cria uma cópia independente no seu espaço de trabalho. Você pode personalizá-lo livremente sem afetar o modelo original ou outros espaços de trabalho.

Atualizações seguras com revisão opcional

Quando a Intercom publica uma versão aprimorada de um modelo que você já instalou, seu conector não é alterado automaticamente. Em vez disso, você é notificado que uma versão mais recente está disponível. Você pode revisar exatamente o que mudou antes de decidir se aplica a atualização — e quaisquer personalizações feitas no seu conector são preservadas.

Cada conector instalado registra de qual versão do modelo ele veio, então está sempre claro se seu conector está atualizado ou se há uma versão mais recente disponível.


Modelos de conector de dados para Shopify Storefront

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

Basta ativar esses conectores de dados usando as condições predefinidas ou definir suas próprias condições para informar ao Fin quais requisitos devem ser atendidos antes de obter informações da Shopify.

Nota:

  • Você deve instalar o aplicativo Shopify no seu espaço de trabalho para usar esses modelos de conector de dados para Shopify.

  • Conectores de dados não suportam parâmetros de objeto aninhado ou array, o que impede buscas dinâmicas de produtos usando a ferramenta Shopify search_catalog via conectores MCP. Para habilitar busca e recomendações de produtos, sincronize os dados do seu catálogo Shopify na knowledge base do Fin e use a integração nativa do Shopify.

Casos de uso comuns

Use esses conectores de dados para:

Buscar no Catálogo

Use para buscar no catálogo da loja com as próprias palavras do cliente. Retorna os produtos correspondentes com sua faixa de preço, disponibilidade, imagem e link da loja.

Obter Carrinho

Use para ler o conteúdo do carrinho Shopify de um cliente. Retorna cada item no carrinho com sua quantidade, o produto e variante a que se refere, totais por item e do carrinho, e o link para o checkout.

Atualizar Carrinho

Use para alterar a quantidade de um item já no carrinho Shopify do cliente. Retorna o carrinho atualizado com todos os itens, os novos totais e o link para o checkout. Exemplos de perguntas dos clientes incluem:

  • Você pode mudar meu pedido para 3 desses?

  • Eu quero apenas uma das camisas azuis, não duas

  • Tire os chinelos do meu carrinho

  • Atualize a quantidade do meu carrinho

Esta ação requer o cart_id, o line_id do item a ser alterado e a nova quantidade. O line_id é o ID da linha do carrinho retornado pela ação Obter carrinho Shopify, não o ID do produto ou variante, então leia o carrinho primeiro para resolver qual linha o cliente quer dizer. Definir a quantidade para 0 remove a linha completamente, então esta ação cobre tanto a alteração de quantidade quanto a remoção de um item. Ela substitui essas partes da ferramenta update_cart obsoleta no endpoint MCP da Shopify Storefront; adicionar um novo item é uma mutação separada da Storefront.

Obter Detalhes do Produto

Use para consultar um produto no catálogo da loja — sua descrição, faixa de preço, disponibilidade, imagem e todas as variantes compráveis com o preço, SKU, opções e estoque de cada variante. Use isso quando o cliente perguntar sobre um produto em vez de seu carrinho ou pedido.


Modelos de conector de dados para Shopify

Obter informações do pedido

Use para obter detalhes sobre os pedidos do cliente e ajudar a solucionar quaisquer problemas relacionados a pedidos. Esta ação fornecerá todos os detalhes dos pedidos do cliente, como status do pedido, itens comprados, endereço de entrega, informações de rastreamento ou outros detalhes relevantes do pedido.


Modelos de conector de dados para Statuspage

Ao configurar este conector de dados, o Fin pode resolver completamente as solicitações dos clientes que relatam ou perguntam sobre um incidente registrado por você no Statuspage. Isso usa sua integração Statuspage existente, então não há conexões adicionais que você precise fazer com outra ferramenta.

Basta ativar o conector de dados usando as condições predefinidas ou definir suas próprias condições para informar ao Fin quais requisitos devem ser atendidos antes de obter informações do Statuspage.

Incidentes não resolvidos

Use quando um cliente está enfrentando um problema para verificar se há alguma interrupção do sistema, falha no serviço ou incidentes não resolvidos que possam explicar a interrupção que o cliente está enfrentando. Esta ação fornecerá todos os incidentes ativos, seu status e a atualização mais recente.

Nota: Você deve instalar o aplicativo Statuspage no seu espaço de trabalho para usar este modelo de conector de dados.


Modelos de conector de dados para Stripe

Ao configurar esses conectores de dados, o Fin pode resolver completamente as solicitações dos clientes que precisam de informações armazenadas no Stripe. Isso usa sua integração Stripe existente, então não há conexões adicionais que você precise fazer com outra ferramenta.

Basta ativar esses conectores de dados usando as condições predefinidas ou definir suas próprias condições para informar ao Fin quais requisitos devem ser atendidos antes de obter informações do Stripe.

Nota: Você deve instalar o aplicativo Stripe no seu espaço de trabalho para usar esses modelos de conector de dados.

Casos de uso comuns

Use esses conectores de dados para:

Obter cliente Stripe por ID

Recupera um único cliente Stripe pelo seu ID de cliente Stripe (cus_...). Exibe os detalhes armazenados do cliente — id, email, nome, saldo, moeda, inadimplência e data de criação. Somente leitura.

Listar clientes Stripe

Retorna uma lista dos seus clientes Stripe, opcionalmente filtrada por correspondência exata de email. Exibe os detalhes armazenados de cada cliente — id, email, nome, saldo, moeda, inadimplência e data de criação. Somente leitura.

Listar faturas Stripe para um cliente

Lista as faturas de um cliente Stripe (mais recentes primeiro, até 10) — id da fatura, status, valor devido, valor pago, moeda, período de cobrança e URL da fatura hospedada. Passe o id Stripe do cliente (cus_...). Somente leitura.

Buscar cobranças Stripe para um cliente

Busca as cobranças de um cliente Stripe (até 10) — id da cobrança (ch_...), valor, moeda, status, flags de pago e reembolso, descrição e data de criação. Passe o id Stripe do cliente (cus_...). Usado comumente para encontrar o charge_id necessário antes de emitir um reembolso. Somente leitura.

Buscar clientes Stripe por email

Busca seus clientes Stripe pelo endereço de email exato e retorna os clientes correspondentes — id, email, nome, saldo, moeda, inadimplência e data de criação. Este é o ponto de partida mais comum para uma consulta Stripe quando você só tem o email do cliente. Somente leitura. Fin usa este conector para puxar os registros Stripe de alguém pelo email. Se o campo de email não estiver protegido contra atualizações não verificadas, um cliente pode alterá-lo no Messenger e puxar os registros de outra pessoa. Verifique a aba de segurança no rascunho do seu conector de dados e certifique-se de que o email é um campo protegido.

Obter informações de assinatura

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

Exemplos de perguntas dos 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 sou cobrado pela minha assinatura?

  • Quando minha assinatura será renovada?

Limitações e configurações personalizadas do Stripe

Nota: A automação nativa de email do Stripe pode enviar faturas e recibos automaticamente, mas isso é 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 sob demanda, isso requer um conector de dados personalizado com capacidade de escrita/ação; os modelos padrão do Stripe acima cobrem apenas consultas de assinatura e pagamento somente leitura.

Nota: Se você configurar um conector de cancelamento, restrinja-o a solicitações de cancelamento voluntárias e simples. Use um Procedimento Fin para verificações de elegibilidade, confirmações ou qualquer lógica de ramificação — e defina critérios de transferência na Orientação de Escalonamento do Fin. Quanto ao tempo, note que conectores de dados padrão têm um tempo limite de 15 segundos; conectores de dados usados dentro de Procedimentos em espaços de trabalho elegíveis têm um tempo limite de 30 segundos.

Respondeu à sua pergunta?