Conectores de dados são integrações sem código e profundamente integradas que podem conectar seus dados externos ao vivo com o 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 forma de começar é pensar em perguntas comuns que seus colegas gastam bastante tempo respondendo, usando informações atualmente não disponíveis no Intercom.

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

Quando você souber quais perguntas deseja resolver, é surpreendentemente simples e rápido configurar um conector de dados com pouca ou nenhuma experiência técnica.

Primeiro, navegue até Configurações > Integrações > Conectores de dados.

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

Dê ao seu conector de dados um nome único que explique exatamente qual conector de dados ele usará (por exemplo, “Obter ID do pedido”). Use o campo de descrição para informar aos colegas quando usar este conector de dados e quais informações eles podem esperar obter (por exemplo, “Obter pedido para um ID fornecido. O ID do pedido deve estar armazenado no 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 Habilitado (gatilho direto). Se você quiser que ele seja usado apenas dentro de um Workflow, Tarefa, Procedimento ou Macro, defina como Desabilitado (gatilho manual).

Em seguida, preencha os detalhes da solicitaçã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 conector de dados deseja que esta solicitação use selecionando o método:

Neste exemplo, vamos pedir para a solicitação GET o ID do pedido da API e inserir a URL.

Você pode optar por adicionar quaisquer parâmetros adicionais a esta solicitação clicando em Adicionar par chave-valor e então selecionar Par chave-valor em Cabeçalhos HTTP:

Conectores de dados suportam tokens fixos e dinâmicos para autenticação. Em Cabeçalhos HTTP, você pode selecionar o token de autenticação que deseja usar na solicitação, que será então adicionado ao cabeçalho.

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

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

Clique em Testar solicitação para verificar se o conector de dados foi configurado corretamente. Você deve receber um sinal verde e ver os detalhes dessa solicitaçã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 Restringir acesso manualmente se desejar limitar os dados que o Fin pode ler. Então, marque os campos de dados aos quais deseja dar acesso ao Fin.

Você também pode editar os itens de dados individuais clicando no ícone editar para dar aos seus dados de resposta um nome voltado para o cliente, além de especificar quaisquer transformações nos dados.

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

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

Esta etapa é opcional. Ela informa ao conector de dados 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 você pode não precisar armazenar dados são tipos de solicitação de conector de dados PUT, POST, DELETE. Para todas as solicitações GET, se quiser usar os dados em bots, será necessário 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, o 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 da linha corresponde a um ponto de dados na resposta JSON.

Saiba mais sobre o gerenciamento do armazenamento, autorização e execução do Data connector.

Os dados da resposta JSON podem ser armazenados em:

Selecione o objeto do Intercom e depois faça o mapeamento com o objeto da API externa.

Agora selecione os atributos de dados no Intercom onde deseja armazenar esta informação. Por exemplo, selecionamos "Order" como o objeto do Intercom e depois selecionamos "root" como o objeto da API no sistema externo e 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, serão criados duplicados a cada requisiçã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 se relacionam com seu objeto personalizado que você deseja atualizar.

Depois de testar seu Data connector com sucesso, 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 é usada no Intercom.

A coluna Used by pode estar oculta por padrão. Para exibi-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 Configurações > Integrações > Data connectors.

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

Passe o mouse sobre qualquer selo de status de saúde para ver uma análise detalhada do desempenho recente:

Use o filtro de tempo no topo 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 saúde dedicado, depois 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 falha — clique em qualquer entrada para expandir os detalhes completos da execução.

Você pode filtrar logs por:

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

Vá para Configurações > Integrações > Data connectors e clique no Data connector que deseja mover para rascunho, depois selecione Definir como rascunho.

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