Data connectors são integrações sem código e profundamente incorporadas que podem conectar seus dados externos ao vivo ao Intercom. Esses dados ao vivo podem ser usados para alimentar Fin, Workflows e o Inbox, permitindo que seus clientes resolvam suas dúvidas automaticamente.

Uma ótima maneira de começar é pensar nas perguntas comuns que seus colegas passam muito tempo respondendo, usando informações que atualmente não estão disponíveis no Intercom.

Podem ser perguntas nas quais seus clientes simplesmente querem obter informações que você armazena em um sistema externo, como “Qual é o status do meu pedido?”, ou executar um Data connector como “Reagendar uma entrega” ou “Processar um reembolso” no seu sistema externo.

Quando você sabe quais perguntas deseja resolver, é surpreendentemente simples e rápido configurar um Data connector com pouca ou nenhuma expertise técnica.

Primeiro, navegue até Configurações > Integrações > Data connectors.

É aqui que você configurará todas as diferentes conexões que tiver com dados externos (por exemplo, Shopify, Salesforce, etc.), dependendo do seu caso de uso. Clique em + Novo.

Dê ao seu Data connector um nome único que explique exatamente qual Data connector ele executará (por exemplo, “Obter ID do pedido”). Use o campo de descrição para dizer aos colegas quando usar este Data connector e quais informações eles podem esperar que ele recupere (por exemplo, “Obter pedido para um ID dado. O ID do pedido deve ser armazenado em Conversation CDA”).

Para permitir que o Fin use este conector diretamente, navegue até a aba Fin e defina Como o Fin deve usar este conector? para Enabled (direct trigger). Se você quiser que ele seja usado apenas dentro de um Workflow, Task, Procedure, ou Macro, defina como Disabled (manual trigger).

Em seguida, preencha os detalhes da requisição. É aqui que você precisará inserir a URL HTTPS para o sistema de terceiros ao qual está se conectando (por exemplo, Shopify, Salesforce, etc.).

Você pode especificar qual Data connector você deseja que essa requisição execute selecionando o método:

Neste exemplo, pediremos que a requisição faça um GET do ID do pedido na API e insira a URL.

Você pode optar por adicionar quaisquer parâmetros adicionais a esta requisição clicando em Add key value pair e então selecionar Key value pair sob HTTP Headers:

Data connectors suportam tokens fixos e dinâmicos para autenticação. Sob os HTTP Headers, você pode selecionar o authentication token que deseja usar na requisição, que será então adicionado ao cabeçalho.

Se você estiver fazendo uma requisição POST ou PUT, terá a opção de fornecer um corpo de requisição para incluir quaisquer dados que deseja enviar na requisição:

Em seguida, você precisará testar a resposta deste Data connector para garantir que está buscando os dados corretos do sistema de terceiros ao qual está se conectando.

Clique em Test request para verificar se o Data connector foi configurado corretamente. Você deve obter um tique verde e ver os detalhes dessa requisição se a conexão for validada com a API.

Estas são todas as informações que você pode agora usar para alimentar seus Workflows e fornecer respostas rápidas aos clientes, como status do pedido.

Por padrão, o Fin pode acessar todos os dados da resposta para gerar respostas. Selecione Manually restrict access se desejar limitar os dados que o Fin pode ler. Em seguida, marque os campos de dados que você deseja dar acesso ao Fin.

Você também pode editar os itens de dados individuais clicando no ícone de edit para dar ao seu dado de resposta um nome voltado ao cliente, bem como especificar quaisquer transformações nos dados.

Por exemplo, se a resposta da API retornar um saldo de 0, em vez do Fin afirmar que o saldo não pago é 0, ele pode responder afirmando que atualmente não há saldo não pago restante.

Com blocos de código para Data connectors, estamos capacitando você a transformar e manipular diretamente as respostas da API usando Python — diretamente na configuração do seu connector.

Esta etapa é opcional. Ela informa ao Data connector onde armazenar essas informações no Intercom para que possam ser fornecidas aos clientes em seus Workflows como respostas às suas perguntas.

Cenários comuns onde talvez não seja necessário armazenar dados são tipos de requisição Data connector PUT, POST, DELETE. Para todas as requisições GET, se você quiser usar os dados em bots, precisará armazenar esses dados no Intercom.

Ao criar conectores de Dados para Fin, não é necessário mapear os dados de resposta para atributos ou objetos do Intercom. Em vez disso, Fin interpreta diretamente a resposta JSON e pode usá-la para resolver perguntas. A resposta é gerada com base na seção ‘Test response’. Cada item de linha corresponde a um ponto de dados na resposta JSON.

Saiba como o armazenamento, a autorização e a execução do Data connector são tratados.

Os dados de resposta JSON podem ser armazenados em:

Selecione o objeto do Intercom e, em seguida, mapeie-o com o objeto da API externa.

Agora selecione os atributos de dados no Intercom nos quais você deseja armazenar estas informações. Por exemplo, selecionamos “Order” como o objeto do Intercom e então selecionamos “root” como o objeto da API no sistema externo e o mapeamos com o atributo da API “currency”:

Ao mapear com Objetos Personalizados, você deve mapear o ID para o campo external_id; caso contrário, ele criará duplicatas a cada solicitação GET. Saiba mais sobre como configurar referências corretas com Objetos Personalizados

O próximo passo é selecionar quais referências de Pessoas ou Conversação se relacionam ao seu objeto personalizado que você deseja atualizar.

Depois de testar com sucesso seu Data connector, você está pronto para colocá-lo em produção.

Para gerenciar ou editar seus Data connectors em escala com segurança, você pode auditar proativamente onde cada Data Connector ou ação MCP é usado no Intercom.

A coluna Used by pode estar oculta por padrão. Para mostrá-la:

Esta coluna fornece uma lista clicável e ao vivo de referências. Clicar em qualquer item levará você diretamente àquela fonte.

Ele rastreia o uso do Data connector em:

Depois que seu Data connector estiver ativo, você pode monitorar seu desempenho diretamente em Settings > Integrations > Data connectors.

Uma coluna Health exibe o status operacional de cada conector com base nas taxas de sucesso e latência de suas execuções recentes.

Passe o cursor sobre qualquer distintivo de status de integridade para ver uma análise detalhada de seu desempenho recente:

Use o filtro de tempo na parte superior do painel para ajustar a janela de relatório. Opções disponíveis: 1h, 6h, 24h, 7d ou 14d.

Clique em qualquer conector para abrir seu painel de integridade dedicado e, em seguida, selecione a aba Logs para ver um registro com carimbo de data/hora de cada execução. Cada entrada mostra o canal em que foi executada e se teve sucesso ou falhou — clique em qualquer entrada para expandir os detalhes completos da execução.

Você pode filtrar os logs por:

Se você quiser descontinuar conectores de dados antigos que não são mais necessários, você pode movê-los para o estado de rascunho.

Vá para Settings > Integrations > Data connectors e clique no conector de dados que você deseja mover para rascunho e, em seguida, selecione Set to draft.

Embora a Intercom bloqueie a tentativa de colocar um conector em rascunho se houver dependências ativas, você agora pode gerenciá-las proativamente usando a coluna 'Used by'. Esta coluna fornece uma lista indexada e em tempo real de cada Workflow, Procedure, Task, Macro, and Custom Answer que referencia a ação. Você pode clicar diretamente em qualquer item dessa lista para ir até essa automação específica e resolver a dependência.