​

Atributos personalizados

​

Acessando atributos personalizados

1. No menu da barra lateral esquerda, clique em Configurações.
2. Na lista de opções de configurações, selecione Atributos personalizados.

​

Categorias de atributos

• Conversas: atributos aplicados às conversas
• Contatos: Atributos aplicados aos contatos
• Pipeline: atributos aplicados a pipelines, estágios ou itens

​

Pesquisando atributos personalizados

​

Como pesquisar

1. Na parte superior da tela, localize o campo “Pesquisar atributos personalizados…” com o ícone de pesquisa
2. Digite o nome, descrição ou chave do atributo desejado
3. A tabela de atributos será atualizada automaticamente conforme você digita, mostrando apenas os atributos que correspondem à pesquisa

​

Visualizando atributos personalizados na tabela

​

Colunas da tabela

• Nome: Nome de exibição do atributo personalizado
• Exibe o nome definido durante a criação (por exemplo, “Prioridade do lead”, “Posição”, “Motivo do contato”)
• A coluna é classificável (indicada pelas setas para cima/para baixo)
• Descrição: Descrição completa do atributo
• Exibe a descrição definida durante a criação
• Ajuda a entender o propósito do atributo
• Tipo: Tipo de dados do atributo
• Exibido em uma etiqueta azul (por exemplo, “Texto”, “Número”, “Data”)
• Indica o formato de dados aceito pelo atributo
• Chave: Chave técnica do atributo
• Exibido em uma tag cinza (por exemplo, “lead_priority”, “position”, “contact_reason”)
• Utilizado para identificar o atributo no API
• Valores: Valores predefinidos (se aplicável)
• Exibe valores predefinidos para atributos de tipo de lista ou seleção
• Mostra ”-” quando não aplicável
• Regex: Indica se o atributo possui validação por expressão regular
• Exibido em uma tag verde com “Sim” quando a regex está configurada
• Exibido como ”-” quando não há validação de regex
• Criado em: Data de criação do atributo
• Exibe a data no formato DD/MM/AAAA (por exemplo, “23/01/2026”)
• A coluna é classificável (indicada pelas setas para cima/para baixo)
• Modelo: Modelo ao qual o atributo se aplica (somente para Pipeline)
• Exibe “Item”, “Estágio” ou “Pipeline” para atributos de pipeline
• Não exibido para atributos de Conversas ou Contatos
• Ações: Menu de ação para gerenciar o atributo
• Ícone de três pontos horizontais (...) que abre um menu suspenso com opções

​

Recursos da tabela

• Classificação: Nome e Criado nas colunas podem ser classificados clicando no cabeçalho
• Pesquisa Integrada: A barra de pesquisa acima da tabela filtra os resultados em tempo real
• Filtro de categoria: Use guias (Conversas, Contatos, Pipeline) para filtrar atributos por categoria
• Contador: O número total de atributos na categoria atual é exibido abaixo do título

​

Atributos para conversas

​

Criando um atributo de conversa

1. Na tela Atributos Personalizados, clique na aba “Conversas” para filtrar apenas os atributos da conversa
2. Clique no botão verde ”+ Novo atributo personalizado” no canto superior direito da tela
3. Um modal será exibido com o título “Novo Atributo Personalizado”

​

Preenchendo o Formulário

• Selecione “Conversas” no menu suspenso
• O texto de ajuda exibirá: “Atributos aplicados às conversas”

• Digite um nome amigável que será exibido aos usuários
• Exemplo: “Motivo do contato”

• A chave técnica será gerada automaticamente a partir do Nome de Exibição
• Use apenas letras minúsculas, números e sublinhados
• Exemplo: contact_reason

• Explique o propósito do atributo
• Exemplo: “Identifique o principal motivo pelo qual o cliente entrou em contato com você.”

• Selecione o tipo de dados (Texto, Número, Data, Booleano, Lista)
• Para o exemplo “Motivo do contato”, selecione “Texto”

• Ative o botão se quiser validar o formato do texto
• Exemplo de padrão Regex: ^.{5,}$ (mínimo 5 caracteres)
• Exemplo de sugestão Regex: “Descreva o motivo do contato (mínimo 5 caracteres).”

​

Finalizando a Criação

1. Revise as informações inseridas
2. Verifique se a validação regex está configurada corretamente (se aplicável)
3. Clique no botão verde “Criar” para criar o atributo
4. O atributo será criado e aparecerá na tabela de atributos de conversas

​

Editando um atributo de conversa

1. Na tabela de atributos, certifique-se de que a aba “Conversas” esteja selecionada
2. Localize o atributo que deseja editar
3. Na coluna Ações, clique no ícone de três pontos (...)
4. No menu suspenso, clique em Editar (ícone de lápis)
5. Um modal será aberto com o título “Editar Atributo Personalizado” e campos já preenchidos
6. Modifique os campos desejados:

• Nome de exibição
• Descrição
• Tipo (tenha cuidado ao alterar, pois pode afetar os dados existentes)
• Validação Regex (ativar/desativar ou modificar padrão e sugestão)

7. Clique no botão verde “Atualizar” para salvar as alterações

​

Excluindo um atributo de conversa

1. Na tabela de atributos, localize o atributo que deseja excluir
2. Na coluna Ações, clique no ícone de três pontos (...)
3. No menu suspenso, clique em Excluir (ícone de lixeira em vermelho)
4. Confirme a exclusão na caixa de diálogo que aparece

​

Atributos para contatos

​

Criando um atributo de contato

1. Na tela Atributos Personalizados, clique na aba “Contatos” para filtrar apenas atributos de contato
2. Clique no botão verde ”+ Novo atributo personalizado” no canto superior direito da tela
3. Um modal será exibido com o título “Novo Atributo Personalizado”

​

Preenchendo o Formulário

• Selecione “Contatos” no menu suspenso
• O texto de ajuda exibirá: “Atributos aplicados aos contatos”

• Digite um nome amigável que será exibido aos usuários
• Exemplo: “Posição”

• A chave técnica será gerada automaticamente a partir do Nome de Exibição
• Use apenas letras minúsculas, números e sublinhados
• Exemplo: position

• Explique o propósito do atributo
• Exemplo: “Indica o cargo ou função do contato na empresa.”

• Selecione o tipo de dados (Texto, Número, Data, Booleano, Lista)
• Para o exemplo “Posição”, selecione “Texto”

• Ative o botão se quiser validar o formato do texto
• Exemplo de padrão Regex: ^.{2,}$ (mínimo 2 caracteres)
• Exemplo de sugestão Regex: “Forneça o cargo do contato (mínimo 2 caracteres).”

​

Finalizando a Criação

1. Revise as informações inseridas
2. Verifique se a validação regex está configurada corretamente (se aplicável)
3. Clique no botão verde “Criar” para criar o atributo
4. O atributo será criado e aparecerá na tabela de atributos de Contatos

​

Editando um atributo de contato

1. Na tabela de atributos, certifique-se de que a aba “Contatos” esteja selecionada
2. Localize o atributo que deseja editar
3. Na coluna Ações, clique no ícone de três pontos (...)
4. No menu suspenso, clique em Editar (ícone de lápis)
5. Um modal será aberto com o título “Editar Atributo Personalizado” e campos já preenchidos
6. Modifique os campos desejados
7. Clique no botão verde “Atualizar” para salvar as alterações

​

Excluindo um atributo de contato

1. Na tabela de atributos, localize o atributo que deseja excluir
2. Na coluna Ações, clique no ícone de três pontos (...)
3. No menu suspenso, clique em Excluir (ícone de lixeira em vermelho)
4. Confirme a exclusão na caixa de diálogo que aparece

​

Atributos para pipeline

​

Criando um atributo de pipeline

1. Na tela Atributos Personalizados, clique na aba “Pipeline” para filtrar apenas os atributos do pipeline
2. Clique no botão verde ”+ Novo atributo personalizado” no canto superior direito da tela
3. Um modal será exibido com o título “Novo Atributo Personalizado”

​

Preenchendo o Formulário

• Selecione “Pipeline” no menu suspenso
• O texto de ajuda exibirá: “Atributos aplicados a pipelines, etapas ou itens”
• Importante: Quando “Pipeline” for selecionado, um campo adicional “Pipeline Type” será exibido

• Pipeline: Atributos aplicados ao pipeline como um todo
• Estágio: Atributos aplicados aos estágios do pipeline
• Item: atributos aplicados a itens de pipeline (negócios/leads)
• Exemplo: para “Prioridade de lead”, selecione “Item”
• O texto de ajuda exibirá: “Atributos aplicados aos itens (negócios/leads) do pipeline”

• Digite um nome amigável que será exibido aos usuários
• Exemplo: “Prioridade de lead”

• A chave técnica será gerada automaticamente a partir do Nome de Exibição
• Use apenas letras minúsculas, números e sublinhados
• Exemplo: lead_priority

• Explique o propósito do atributo
• Exemplo: “Defina a prioridade da oportunidade no pipeline de vendas.”

• Selecione o tipo de dados (Texto, Número, Data, Booleano, Lista)
• Para o exemplo “Prioridade do lead”, selecione “Texto”

• Ative o botão se quiser validar o formato do texto
• Exemplo de padrão Regex: ^(Low|Medium|High)$ (aceita apenas “Baixo”, “Médio” ou “Alto”)
• Exemplo de sugestão Regex: “Usar apenas: Baixo, Médio ou Alto”

​

Finalizando a Criação

1. Revise as informações inseridas, especialmente o tipo de pipeline
2. Verifique se a validação regex está configurada corretamente (se aplicável)
3. Clique no botão verde “Criar” para criar o atributo
4. O atributo será criado e aparecerá na tabela de atributos do Pipeline

​

Editando um atributo de pipeline

1. Na tabela de atributos, certifique-se de que a aba “Pipeline” esteja selecionada
2. Localize o atributo que deseja editar
3. Na coluna Ações, clique no ícone de três pontos (...)
4. No menu suspenso, clique em Editar (ícone de lápis)
5. Um modal será aberto com o título “Editar Atributo Personalizado” e campos já preenchidos
6. Modifique os campos desejados:

• Tipo de pipeline (se necessário)
• Nome de exibição
• Descrição
• Tipo (tenha cuidado ao alterar, pois pode afetar os dados existentes)
• Validação Regex (ativar/desativar ou modificar padrão e sugestão)

7. Clique no botão verde “Atualizar” para salvar as alterações

​

Excluindo um atributo de pipeline

1. Na tabela de atributos, localize o atributo que deseja excluir
2. Na coluna Ações, clique no ícone de três pontos (...)
3. No menu suspenso, clique em Excluir (ícone de lixeira em vermelho)
4. Confirme a exclusão na caixa de diálogo que aparece

​

Campos de formulário em detalhes

​

Aplicar a - Obrigatório

• Campo: Aplicar a (marcado com asterisco * indicando campo obrigatório)
• Tipo: Menu suspenso (menu de suspensão)
• Descrição: Define onde o atributo será aplicado
• Opções disponíveis:
• Conversas: atributos aplicados às conversas
• Contatos: Atributos aplicados aos contatos
• Pipeline: atributos aplicados a pipelines, estágios ou itens
• Texto de Ajuda: Exibe uma descrição explicando o contexto selecionado
• Local: Primeiro campo do formulário

​

Tipo de Pipeline - Obrigatório (somente para Pipeline)

• Campo: Tipo de pipeline (marcado com asterisco * indicando campo obrigatório)
• Tipo: Menu suspenso (menu de suspensão)
• Descrição: Define se o atributo se aplica ao pipeline, estágio ou item
• Opções disponíveis:
• Pipeline: Atributos aplicados ao pipeline como um todo
• Estágio: Atributos aplicados aos estágios do pipeline
• Item: atributos aplicados a itens de pipeline (negócios/leads)
• Texto de ajuda: “Selecione se este atributo se aplica ao pipeline, estágio ou item.”
• Local: Segundo campo do formulário, exibido apenas quando “Pipeline” é selecionado em “Aplicar a”

​

Nome de exibição - obrigatório

• Campo: Nome de exibição (marcado com asterisco * indicando campo obrigatório)
• Tipo: Campo de texto simples
• Descrição: Nome amigável que será exibido aos usuários
• Exemplos: “Prioridade do lead”, “Posição”, “Motivo do contato”
• Recomendação: Utilize nomes descritivos e claros que facilitem a identificação dos atributos
• Local: Terceiro campo do formulário (ou segundo, se não for Pipeline)

​

Chave de Atributo - Obrigatório

• Campo: Chave de Atributo (marcado com asterisco * indicando campo obrigatório)
• Tipo: Campo de texto simples
• Descrição: Chave técnica utilizada para identificar o atributo no API
• Texto de Ajuda: “A chave será usada para identificar este atributo no API. Use apenas letras minúsculas, números e sublinhados.”
• Regras:
• Use apenas letras minúsculas, números e sublinhados *Não utilize espaços ou caracteres especiais
• Geralmente gerado automaticamente a partir do Nome de Exibição
• Exemplos: lead_priority, position, contact_reason
• Local: Quarto campo do formulário (ou terceiro, se não for Pipeline)

​

Descrição - Obrigatório

• Campo: Descrição (marcado com asterisco * indicando campo obrigatório)
• Tipo: Área de texto (área de texto)
• Descrição: Explicação detalhada da finalidade do atributo
• Exemplos:
• “Definir a prioridade da oportunidade no pipeline de vendas.”
• “Indica o cargo ou função do contato dentro da empresa.”
• “Identifique o principal motivo pelo qual o cliente entrou em contato com você.”
• Recomendação: Seja claro e objetivo sobre o que o atributo representa
• Local: Quinto campo do formulário (ou quarto, se não for Pipeline)

​

Tipo - Obrigatório

• Campo: Tipo (marcado com asterisco * indicando campo obrigatório)
• Tipo: Menu suspenso (menu de suspensão)
• Descrição: Define o tipo de dados que o atributo aceitará
• Opções disponíveis:
• Texto: Campo de texto simples
• Descrição: “Campo de texto simples”
• Permite qualquer texto livre
• Número: Campo numérico
• Data: Campo de data
• Booleano: Campo verdadeiro/falso
• Lista: Lista de valores predefinidos
• Texto de Ajuda: Exibe uma descrição do tipo selecionado
• Local: Sexto campo do formulário (ou quinto, se não for Pipeline)

​

Validação Regex - Opcional

• Seção: “Validação Regex”
• Descrição: “Adicione um padrão regex para validar os valores deste atributo”
• Toggle Switch: Switch no canto superior direito da seção
• Desativado: A validação Regex não será aplicada
• Ativado: A validação Regex será aplicada (indicada pela cor verde/turquesa)

​

Padrão Regex

• Campo: Padrão Regex
• Tipo: Campo de texto simples
• Descrição: Expressão regular que define o padrão de validação
• Exemplos:
• ^(Low|Medium|High)$ – Aceita apenas “Baixo”, “Médio” ou “Alto”
• ^.{2,}$ – Aceita qualquer texto com pelo menos 2 caracteres
• ^.{5,}$ – Aceita qualquer texto com no mínimo 5 caracteres
• Recomendação: Teste o padrão regex antes de salvar para garantir que funcione conforme o esperado

​

Sugestão Regex

• Campo: Sugestão Regex
• Tipo: Área de texto (área de texto)
• Descrição: Mensagem de ajuda exibida aos usuários quando eles preenchem o campo
• Texto de Ajuda: “Esta dica será exibida aos usuários quando eles preencherem o campo”
• Exemplos:
• “Use apenas: Baixo, Médio ou Alto”
• “Forneça o cargo do contato (mínimo 2 caracteres).”
• “Descreva o motivo do contato conosco (mínimo 5 caracteres).”
• Recomendação: Seja claro e específico sobre o formato esperado

​

Tipos de atributos disponíveis

​

Texto

• Descrição: Campo de texto simples
• Uso: Permite inserir qualquer texto livre
• Exemplos de uso:
• Cargo do contato
• Motivo do contato
• Notas gerais
• Validação: Pode ser combinado com regex para restringir formato ou tamanho

​

Número

• Descrição: Campo numérico
• Uso: Permite inserir valores numéricos
• Exemplos de uso:
• Valor estimado de uma oportunidade
• Número de funcionários da empresa
• Pontuação de satisfação

​

Data

• Descrição: Campo de data
• Uso: Permite selecionar ou inserir uma data
• Exemplos de uso:
• Aniversário do contato *Data prevista de fechamento da oportunidade
• Data do último contato

​

Booleano

• Descrição: Campo verdadeiro/falso
• Uso: Permite marcar como verdadeiro ou falso
• Exemplos de uso:
• Cliente VIP (sim/não)
• Aceita marketing (sim/não) *Oportunidade qualificada (sim/não)

​

Lista

• Descrição: Lista de valores predefinidos
• Uso: Permite selecionar um valor de uma lista predefinida
• Exemplos de uso:
• Prioridade (Baixa, Média, Alta)
• Status (Ativo, Inativo, Pendente)
• Fonte de leads (site, referência, campanha)

​

Validação de expressão regular (Regex)

​

Quando usar Regex

• Valores predefinidos: Quando você deseja restringir a entrada a valores específicos (por exemplo, “Baixo”, “Médio”, “Alto”)
• Formato Específico: Quando você precisar de um formato específico (por exemplo, código do produto, número de telefone)
• Tamanho Mínimo/Máximo: Quando você precisa garantir um tamanho de texto mínimo ou máximo
• Padrões Complexos: Quando você precisa validar padrões mais complexos (por exemplo, e-mails, URLs, códigos)

​

Exemplos de padrões Regex

​

Valores predefinidos

^(Low|Medium|High)$

• Aceita apenas “Baixo”, “Médio” ou “Alto”
• Regex Cue: “Use apenas: Baixo, Médio ou Alto”

​

Tamanho Mínimo

^.{2,}$

• Aceita qualquer texto com pelo menos 2 caracteres
• Regex Cue: “Forneça pelo menos 2 caracteres.”

^.{5,}$

• Aceita qualquer texto com pelo menos 5 caracteres
• Regex Cue: “Descreva o motivo do contato (mínimo 5 caracteres).”

​

Formato de e-mail

^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$

• Valida o formato básico de e-mail
• Regex Cue: “Forneça um endereço de e-mail válido.”

​

Dicas para Regex

• Teste primeiro: Sempre teste seu padrão regex antes de salvar para garantir que funcione conforme o esperado
• Seja específico: use Regex Cue para explicar claramente o formato esperado aos usuários
• Documentação: considere documentar padrões regex complexos para facilitar manutenção futura
• Desempenho: Padrões regex muito complexos podem afetar o desempenho, use com moderação

​

Considerações Finais

• Nomenclatura consistente: use nomes de exibição e chaves consistentes para facilitar a organização e a pesquisa
• Descrições claras: Escreva descrições claras e objetivas que expliquem a finalidade de cada atributo
• Validação apropriada: Use a validação regex quando necessário para garantir a qualidade dos dados, mas não seja excessivamente restritivo
• Categorização: Organize atributos em categorias apropriadas (Conversas, Contatos, Pipeline) para facilitar o gerenciamento
• Revisão regular: Revise periodicamente os atributos existentes para garantir que permaneçam relevantes e atualizados
• Documentação: documente atributos personalizados complexos ou aqueles com padrões regex específicos para facilitar o uso da equipe
• Integração API: Lembre-se de que a Chave de Atributo é usada no API - mantenha a consistência e evite alterações desnecessárias
• Impacto nos dados: considere o impacto nos dados existentes antes de alterar o tipo ou excluir um atributo
• Uso Estratégico: Use atributos personalizados para coletar informações que agreguem valor ao seu processo de negócios