Atualizado em Aug 4, 2026

Criando um Tipo Personalizado

O que você vai aprender

• Como abrir o construtor de Tipos Personalizados
• O que cada campo do formulário de definição faz
• Como adicionar campos, escolher tipos e definir regras de validação

Criar um Tipo Personalizado é um processo em duas etapas: primeiro você define o modelo (que campos os registros vão ter) e depois você e o seu time podem adicionar registros usando esse modelo.

Passo 1 — Abrir a página de Tipos Personalizados

1. No menu lateral do AutoTalk, clique em Tipos Personalizados. Você vai ver a lista de tipos que sua empresa já definiu (vazia em uma conta nova).
2. Clique no botão + no canto superior direito (a dica de ferramenta mostra "Add new custom_types").

Passo 2 — Preencher os campos de topo

Campo	Descrição
Slug	Identificador único do tipo, como leads ou helpdesk_tickets. Deve começar com letra minúscula, seguida de letras minúsculas, dígitos e underscores; de 3 a 41 caracteres. Slugs que coincidem com coleções nativas do AutoTalk (contacts, messages, support_tickets, …) são reservados e serão rejeitados. Não é possível alterar o slug depois, então escolha com cuidado. O slug entra em cada URL e chamada de API para esse tipo.
Nome	Rótulo legível exibido nos menus e títulos de página (ex.: "Leads"). Pode ser alterado a qualquer momento.
Descrição	Resumo em uma frase mostrado nas listas. Opcional.
Propósito	Parágrafo mais longo explicando para que serve o tipo. Muito útil quando agentes de IA precisam decidir se leem ou escrevem no seu tipo — trate como um handoff para um colega. Opcional, mas recomendado.

Passo 3 — Adicionar campos

A seção Campos é onde você descreve a forma de cada registro. Clique em "+ Adicionar campo" para criar uma nova linha.

Cada campo tem:

• Nome — a chave usada no registro (ex.: email, status, priority). Use camelCase ou snake_case consistentemente.
• Tipo — o tipo de dado que o campo guarda:
  • Texto — strings curtas ou longas
  • Número — inteiros ou decimais, com min/max opcional
  • Booleano — caixa true/false
  • Data — dia do calendário (sem hora)
  • Data e hora — dia do calendário com hora/minuto
  • Seleção (enum) — lista suspensa; liste os valores permitidos, um por linha
  • Lista — uma lista de itens repetidos
  • Referência — link para outro registro (um Contato, um Funcionário ou outro Tipo Personalizado)
  • Location — um ponto geográfico
  • JSON — objeto JSON livre para casos avançados
  • Imagem — uma imagem enviada
  • Arquivo — um arquivo enviado (imagem, vídeo, áudio ou documento)
• Obrigatório — se o usuário precisa preencher antes de salvar
• Descrição — texto de ajuda exibido no formulário

Opções específicas por tipo

• Texto — defina um tamanho máximo para limitar strings grandes (ex.: maxLength: 256).
• Número — defina limites min e max.
• Seleção — liste os valores permitidos, um por linha, no campo Valores permitidos. Por exemplo:

  new
  contacted
  qualified
  won
  lost

• Referência — informe o tipo de destino. Use um nome nativo como contacts ou employees, ou outro Tipo Personalizado com o prefixo ct: — ex.: ct:leads.
• Imagem / Arquivo — opcionalmente restrinja o upload com Arquivos aceitos (MIME) (ex.: image/*) e Tamanho máximo (bytes). Para campos Arquivo, escolha o Tipo de arquivo (imagem, vídeo, áudio ou documento). Uma Lista cujos itens são Imagem ou Arquivo é renderizada como uma galeria de upload.

Reordenar e remover

Cada linha tem as setas ↑ e ↓ para mudar a posição (isso controla a ordem em que os campos aparecem no formulário), além dos botões Editar e Excluir.

Passo 4 — Abas e seções (opcional)

Para tipos com muitos campos, agrupe em Abas e Seções para manter o formulário legível.

• Uma aba é um agrupamento de topo (ex.: "Geral", "Financeiro", "Notas").
• Uma seção é um grupo retrátil dentro de uma aba (ex.: dentro de "Geral" você pode ter uma seção "Contato" e outra "Pontuação").

Adicione nas áreas de Abas / Seções. Para atribuir um campo a uma aba ou seção, edite o JSON cel desse campo e defina cel: { tab: "general", section: "scoring" } — não há um seletor visual para isso no editor de campos.

Passo 5 — Caminhos indexados (opcional, para performance)

Se o seu time for filtrar pelo mesmo campo com frequência (ex.: buscar leads sempre por email ou status), adicione o nome desse campo em Caminhos indexados. Até 5 por tipo. Isso acelera as buscas quando a coleção passa de milhares de registros.

Passo 6 — Dicas para MCP (opcional)

Se você planeja deixar agentes de IA ou clientes MCP externos lerem/escreverem nesse tipo, adicione uma ou duas dicas curtas em Dicas para MCP. Elas aparecem para o LLM junto com a definição do tipo. Exemplo: "Sempre preencha status ao criar um lead."

Passo 7 — Salvar

Clique em Salvar. O tipo aparece no menu em Tipos Personalizados e seu time já pode começar a adicionar registros.

dica

Comece com uma lista mínima de campos. Você consegue adicionar mais depois editando a definição, e os registros existentes continuam intactos. Remover ou renomear campos é mais complicado — planeje o essencial agora.

O que acontece depois de salvar

• O AutoTalk cria a página de listagem em Tipos Personalizados → nome do tipo.
• O tipo fica exposto na API em /v1/dynadata/type/ct:<slug>/{list,create,update,...} (POST) para qualquer integração que você ou um agente construam.
• O servidor MCP descobre automaticamente o novo tipo para que agentes de IA leiam e escrevam registros.

Próximos passos

• Gerenciando registros — adicionar, editar, filtrar e excluir registros
• Usando com MCP — entregando o tipo para um agente de IA