Passar para o conteúdo principal

Como atributos podem potencializar seus Fin Procedures, Workflows e conectores de dados

Escrito por Ivan Branimir Skoric

O que são atributos?

Atributos são uma ótima maneira de anexar mais dados aos seus users, empresas, conversas ou para armazenar dados temporários para construir Workflows complexos.

No Intercom existem 5 tipos de atributos:

  • Atributos de pessoas

  • Atributos de empresa

  • Atributos de conversa

  • Atributos de Ticket

  • Atributos temporários [NEW]

Nota: Fin Tasks são um recurso legado. Desde 12 de março de 2026, você não pode criar novas Tasks, e todas as novas criações são feitas como Fin Procedures. Suas Tasks existentes continuam totalmente suportadas e leem e atualizam atributos da mesma forma.


Quais tipos de atributos existem?

Atributos de dados de pessoas

Eles são usados para armazenar dados sobre users e leads no Intercom. Por padrão, o Intercom vem com alguns atributos básicos como nome, telefone, e-mail, etc. Você também pode adicionar seus próprios atributos de dados personalizados dependendo das necessidades do seu negócio. Exemplos incluem:

  • Nível ou plano que o user está

  • Valor da última fatura

  • Último item comprado

Atributos de dados da empresa

Semelhante aos atributos de dados de pessoas, os atributos de empresa são usados para fornecer mais dados sobre as empresas com as quais seu negócio lida via Intercom. Alguns atributos padrão incluem nome da empresa, setor, site da empresa e ID. Você sempre pode criar mais atributos personalizados, por exemplo:

  • ID fiscal/IVA da empresa

  • Número de funcionários

  • Se uma empresa é uma subsidiária ou não

Atributos de dados de conversa/ticket

Eles são ótimos para armazenar dados sobre o ticket ou conversa que sua equipe de suporte está trabalhando, seja para dar mais contexto sobre o problema do cliente ou para fins de categorização e relatórios.

Esses dados podem ser preenchidos de três maneiras principais:

  • Manualmente por um colega na Inbox.

  • Através de Workflows, usando a etapa “Coletar dados”.

  • Automaticamente pelo Fin AI Agent, usando Fin Attributes.

Exemplos de atributos de dados de conversa/ticket incluem:

  • Categoria ou motivo da consulta do cliente

  • Produto sobre o qual o cliente está entrando em contato

  • Necessita acompanhamento (verdadeiro / falso)

ID da conversa está disponível como um atributo de conversa que pode ser acessado em:

  • Workflows (pesquise “ID da conversa”)

  • Tasks (pesquise “ID da conversa”)

  • Procedures (via Ler atributo → ID da conversa)

Isso permite que você use o ID da conversa para:

  • Rastreamento de Workflow e referência de conversa.

  • Integração de dados com sistemas externos.

  • Capacidades aprimoradas de relatórios e análises.

  • Melhor suporte ao cliente com referências de conversa.

Classifique automaticamente conversas com Fin Attributes

Fin Attributes classifica automaticamente cada conversa detectando atributos como tipo de problema, urgência ou sentimento. As conversas são classificadas instantaneamente, o que permite acionar workflows, direcionar conversas para a equipe certa e gerar relatórios precisos sem esforço manual.

Dica: Embora este artigo cubra o básico sobre o que são atributos de conversa, recomendamos fortemente a leitura completa do artigo Fin Attributes para aprender como configurar e usar a classificação com IA.

Atributos temporários [NEW]

Fin Procedures e Workflows podem usar um novo tipo de atributo chamado “atributo temporário”.

Atributos temporários são úteis quando você precisa de dados apenas para a execução atual do Procedure ou Workflow e não quer salvá-los permanentemente no Intercom para relatórios ou outros fins. Você pode criar esses atributos para armazenar informações relevantes para essa execução específica.

Por exemplo, você pode criar um atributo temporário para:

  • Capturar o ID de reserva selecionado pelo cliente

  • Data de entrega preferida do cliente

  • Pedir ao Fin para classificar a consulta do user ou coletar alguns dados


Onde os atributos podem ser usados?

Fin Procedures

Adicione atributos a uma etapa de Instrução no seu Fin Procedure digitando “@” em linha com suas instruções de texto. Escolha Ler atributo para que o Fin use dados existentes, ou Atualizar atributo para que o Fin salve um novo valor. Você pode usar qualquer atributo de pessoas, empresa, conversa ou temporário. Veja Construindo Fin Procedures.

Atributos temporários são úteis quando você precisa de dados apenas para a execução atual do Procedure e não quer salvá-los permanentemente no Intercom para relatórios ou outros fins. Para criar um:

  1. Em uma etapa de Instrução, digite “@” e selecione Atualizar atributo.

    O editor de Instruções em um Fin Procedure com o menu @ aberto e Atualizar atributo destacado em Operações de dados.
  2. Clique em Criar atributo.

    O seletor de atributos em um Fin Procedure listando atributos de pessoas e atributos de empresa, com o botão Criar atributo na parte inferior.

  3. Escolha um Formato, insira um Nome e uma Descrição, depois clique em Criar e inserir.

    A caixa de diálogo Criar atributo temporário com um menu suspenso de Formato, um campo Nome, um campo Descrição e um botão Criar e inserir.

Por exemplo, você pode instruir o Fin a classificar a pergunta de um cliente e salvar o resultado em um atributo temporário.

Atributos temporários também podem ser usados fora das etapas de Instrução, como em uma etapa de Condição para ramificar, ou em uma nota adicionada com @Add note.

Coletando dados em um Procedure ou Workflow

Para coletar dados e armazená-los para a pessoa, empresa, conversa ou temporariamente em um Fin Procedure, escreva-os em uma etapa de Instrução. Por exemplo: “Peça ao cliente o número do pedido, depois @Atualizar atributo para salvá-lo.” Você pode então adicionar uma etapa de Condição para ramificar com base no valor salvo. Em um Workflow, use a etapa Coletar dados em vez disso. Isso é útil se você quiser usar os dados coletados depois para criar lógica condicional com ramificações. As duas capturas de tela abaixo mostram a etapa Coletar dados em um Workflow.

Um Workflow com a etapa Coletar dados adicionada.

Aqui, você pode especificar qual tipo de atributo de dados deseja coletar.

As configurações da etapa Coletar dados, onde você escolhe o tipo de atributo de dados a coletar.

Conectores de dados

Conectores de dados podem recuperar ou atualizar dados em um sistema externo usando atributos de dados. Por exemplo, eles podem atualizar ou buscar registros de users do seu banco de dados.

Atributos podem ser usados tanto na URL da requisição quanto no Corpo da Requisição do conector de dados, inserindo-os usando o inseridor de atributos {..}

Um conector de dados com o inseridor de atributos {..} usado para adicionar atributos à URL da requisição e ao Corpo da Requisição.

Em um Procedure

Adicione um conector de dados a uma etapa de Instrução digitando “@” e selecionando Chamar conector de dados. Você não precisa mapear entradas ou saídas. O Fin determina quais entradas o conector precisa a partir da sua configuração, e você pode ler a resposta em etapas posteriores com @Ler atributo (por exemplo, Obter pedidos > status).

As respostas do conector estão disponíveis apenas dentro do Procedure. Elas não aparecem como atributos de conversa na Inbox. Para salvar uma resposta em um atributo de conversa, use Transferir para workflow e defina o atributo no Workflow. O Procedure não retoma após essa transferência. Para problemas comuns, veja Solução de problemas de Fin Procedures e Conectores de dados.

Em um Workflow

Você também pode querer enviar saídas do Workflow ou dados temporários coletados para uma API externa para processamento e, para isso, precisa primeiro criar um mapeamento.

No seu conector de dados, você precisará criar o(s) mesmo(s) atributo(s) (motivo do contato neste exemplo) que existem na configuração do seu Workflow:

Um conector de dados onde o atributo motivo do contato é criado para corresponder ao atributo no Workflow.

Em seguida, mapeie as entradas da ação no seu Workflow.

A ação do conector de dados em um Workflow, onde as entradas da ação são mapeadas.

Aqui, para cada um dos seus atributos, você pode inserir o atributo de dados temporários que é gerado pelo Fin ao executar uma tarefa ou coletado do user em um Workflow.

Uma entrada de ação do conector de dados mapeada para um atributo de dados temporários coletado do user em um Workflow.

Quando um ramo do Workflow verifica um atributo de empresa (como data de construção), o Intercom avalia a condição para cada empresa à qual o contato pertence. Se alguma empresa atender à condição, o ramo corresponderá e prosseguirá de acordo.

Respondeu à sua pergunta?