Campos Personalizados no MagicChat (Atributos) — Guia Prático
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.
