Principal 2. 💡 Dicas e Melhores Práticas Campos Personalizados no MagicChat (Atributos) — Guia Prático

Campos Personalizados no MagicChat (Atributos) — Guia Prático

Última atualização em Jan 20, 2026

Para que servem (e por que isso muda seus relatórios)

Campos personalizados (Atributos) transformam conversas e contatos em dados estruturados para gestão. Com eles, você consegue:

  • Medir origem do lead, campanha e produto

  • Acompanhar SLA comercial (tempo até primeira resposta humana, tempo até reunião, etc.)

  • Padronizar motivos de desqualificação e reduzir perdas

  • Criar dashboards e relatórios operacionais/gerenciais

  • Disparar automações (follow-ups, alertas e pedido de avaliação)


Onde criar atributos (menu e botão “Criar atributo personalizado”)

No MagicChat, os atributos ficam em:

Configurações → Atributos Personalizados

Você verá duas abas principais:

  • Contato: dados do lead/cliente (mais estáveis)

  • Conversas: dados do atendimento/conversa (mais contextuais)

Figura 1 — Acesso ao menu “Atributos Personalizados” e botão “Criar atributo personalizado”.


Conceito rápido: Contato x Conversa (qual usar?)

Use este critério para decidir corretamente:

Atributos de Contato

Use para informações que “seguem a pessoa”:

  • telefone, origem_canal, campanha, produto, lead_id, cpf_cnpj

Atributos de Conversa

Use para informações que “seguem o atendimento”:

  • prioridade do atendimento, tags de contexto, observações pontuais, resultado do suporte, etc.

Recomendação: dados de funil e marketing normalmente ficam melhor no Contato, pois facilitam relatórios consolidados.


Como criar um atributo (passo a passo na tela)

Clique em Criar atributo personalizado e preencha os campos do formulário:

  1. Aplica-se a: selecione Contato (ou Conversas, se for o caso)

  2. Nome para exibição: nome “humano” que o time verá (ex.: “Origem/Canal”)

  3. Chave: nome técnico (padrão recomendado: snake_case, sem acento)

  4. Descrição: para que serve e quando preencher

  5. Tipo: escolha conforme o dado:

    • Texto: campanha, identificadores, observações curtas

    • Número: contadores e notas (ex.: n_followups_enviados)

    • Link: URLs (ex.: proposta, pasta do Drive, documento)

    • Data: marcos (se você precisar “Data e Hora”, alinhe com nosso time a estratégia de registro)

    • Lista: opções fixas (origem/canal, produto, status)

    • Caixa de seleção: sim/não (checkbox)

Figura 2 — Tela de criação: “Aplica-se a”, Nome, Chave, Descrição e Tipo (Texto, Número, Link, Data, Lista, Caixa de seleção).


Onde preencher/visualizar os atributos no dia a dia

Durante uma conversa, o time pode ver e atualizar os atributos no painel lateral do contato:

  • Acesse uma conversa

  • Abra o painel do contato (lado direito)

  • Vá em Atributos do contato

  • Preencha/ajuste os campos conforme o lead evolui no funil

Figura 3 — Onde o time preenche: painel da conversa → “Atributos do contato”.


Modelo pronto (exemplo real)

A seguir está um conjunto recomendado de atributos para operação comercial (jurídico), cobrindo marketing, funil e tempos de etapa.

1) Identificação e Marketing (Contato)

Crie como Contato:

  • lead_id

    • Chave: lead_id | Tipo: Texto

    • Descrição: ID único do lead no funil/CRM (quando houver)

  • Telefone

    • Chave: telefone | Tipo: Texto (ou padrão do contato, se já existir)

    • Descrição: Telefone principal do lead

  • Data/Hora do primeiro contato

    • Chave: data_hora_primeiro_contato | Tipo: Data

    • Descrição: Quando o lead entrou/mandou a primeira mensagem

  • Origem/Canal (Lista)

    • Chave: origem_canal | Tipo: Lista

    • Opções: trafego, indicacao, parceria, organico, interno

  • Campanha

    • Chave: campanha | Tipo: Texto

    • Exemplo: BPC Meta Ads 2026-01

  • Produto (Lista)

    • Chave: produto | Tipo: Lista

    • Opções iniciais: bpc, maternidade, auxilio_doenca, outros


2) Qualificação e Resultado (Contato)

Crie como Contato (recomendado para consolidar relatórios):

  • Status final (Lista)

    • Chave: status_final | Tipo: Lista

    • Opções: fechado, desqualificado, perdeu, arquivado

  • Motivo de desqualificação (Lista)

    • Chave: motivo_desqualificacao | Tipo: Lista

    • Opções padronizadas (sugestão pronta):

      • ja_contratou_outro_escritorio

      • nao_tem_laudo_medico

      • nao_tem_documentacao_minima

      • nao_preenche_criterios_renda

      • nao_preenche_criterio_deficiencia

      • parou_responder_qualificacao

      • parou_responder_pos_proposta

      • parou_responder_pos_contrato

      • desrespeitou_equipe

      • sumiu_apos_reengajamento

      • vai_resolver_sozinho

      • questionou_valor


3) Marcos do funil (Contato)

Crie como Contato:

  • data_hora_qualificado_ia (Data)

  • data_hora_primeira_resposta_humana (Data)

  • data_hora_agendamento_reuniao (Data)

  • data_hora_reuniao_realizada (Data)

  • data_hora_pitch_enviado (Data)

  • data_hora_proposta_enviada (Data)

  • data_hora_contrato_enviado (Data)

  • data_hora_assinatura (Data)


4) Engajamento e volume (Contato)

Crie como Contato:

  • n_total_mensagens_do_lead (Número)

  • n_total_mensagens_time (Número)

  • n_followups_enviados (Número)

Observação: esses campos podem ser automatizados (via Agente de IA ou n8n/API do Chat) para reduzir preenchimento manual.


Automação: pedir avaliação do atendimento (CSAT)

Sim, é possível automatizar. Recomendação:

Quando disparar

  • Ao marcar a conversa como Resolvida ou

  • Ao definir status_final = fechado (ou ao finalizar uma etapa específica)

Mensagem sugerida (simples e eficaz)

“Antes de encerrar: de 0 a 10, quanto você avalia nosso atendimento hoje? Se quiser, responda com um comentário em seguida.”

Exemplo da Configuração -> Automações (magicachat.conexaoazul.com)

Campos para armazenar a avaliação

Crie como Contato:

  • avaliacao_atendimento (Número)

  • comentario_avaliacao (Texto)

  • data_hora_avaliacao (Data)


Checklist final (para seus relatórios nascerem “certos”)

  • Atributos criados em Contato vs Conversas corretamente

  • Chaves em snake_case, sem acento, sem espaços

  • Listas com opções padronizadas (sem variações)

  • Regras internas: “se desqualificou, preencher motivo”

  • Testar com 5 leads reais e validar no relatório/dashboard

  • Configurar automação de CSAT e validar captura das respostas


Precisa de ajuda para configurar (ou quer acelerar seus relatórios e automações)?

Se você quiser, a Conexão Azul pode te apoiar em dois níveis:

1) Suporte rápido (configuração e dúvidas pontuais)

  • Ajuste de atributos (Contato/Conversas), listas e nomenclaturas

  • Validação do modelo de campos para seu funil

  • Orientação de melhores práticas para não “quebrar” relatórios

Como acionar:

  • Pelo chat lateral dentro do MagicChat (recomendado)

  • Ou pelo WhatsApp do Suporte (conforme o número do seu contrato / atendimento)

2) Assessoria completa (jornada do projeto)

Para quem quer ir além dos campos e construir uma operação de vendas/atendimento orientada a dados:

  • Mapeamento do funil e padronização de etapas, status e motivos

  • Dashboards (KPIs, SLA, conversão, performance por canal/campanha/produto)

  • Automações com n8n (follow-ups inteligentes, SLA, alertas, CSAT/NPS)

  • Integrações com CRM/Odoo, WhatsApp, Instagram e gestão do time

  • Treinamento do time e melhoria contínua

Resultado esperado: relatórios confiáveis, time mais produtivo e tomada de decisão com base em dados reais.

Quando quiser, chame no chat lateral ou no WhatsApp do suporte e diga:
“Quero revisar meu Mapa de Campos e Dashboards” — a gente te orienta no melhor próximo passo.