​

👥 Gestão de Contatos

​

📋 O que são Contatos?

• 📧 Email e 📱 Telefone
• 💬 Histórico de conversas completo
• 🏷️ Labels para organização
• 📝 Atributos personalizados (campos customizados)
• 📊 Informações sociais (se conectado por redes sociais)

​

➕ Criar Novo Contato

​

Via Interface

1. Na sidebar, clique em “Contatos”
2. Clique no botão ”+ Novo Contato”
3. Preencha as informações:
   • Nome: Nome completo do cliente
   • Email: Email principal
   • Telefone: Número com código do país (+55)
   • Empresa: Nome da empresa (opcional)
   • Bio: Descrição ou notas sobre o cliente
4. Clique em “Criar Contato”

​

Criação Automática

• Cliente envia primeira mensagem no chat
• Email é recebido de novo remetente
• Mensagem no WhatsApp de número novo
• Direct no Instagram de perfil novo

​

🔍 Buscar Contatos

​

Busca Rápida

• Nome: “João Silva”
• Email: “[email protected]”
• Telefone: “+5511987654321”
• Empresa: “Acme Corp”

​

Filtros Avançados

• Labels: Contatos com tag específica
• Origem: Fonte de cadastro (WhatsApp, Email, etc.)
• Status: Ativo, Inativo
• Período: Criados em período específico

​

📝 Editar Informações

​

Dados Básicos

1. Clique no contato para abrir o perfil
2. Clique em “Editar” ou no ícone de lápis
3. Altere as informações desejadas
4. Clique em “Salvar”

​

Atributos Personalizados

• Segmento: Varejo, Atacado, Corporativo
• Origem: Site, Indicação, Rede Social
• Plano: Free, Premium, Enterprise
• Última Compra: Data da última transação
• Valor Vitalício: Total gasto pelo cliente

1. No perfil do contato, vá em “Atributos”
2. Clique em ”+ Adicionar Atributo”
3. Escolha o atributo (ou crie novo)
4. Preencha o valor
5. Salve

​

🏷️ Labels (Etiquetas)

​

Adicionar Labels

1. Abra o perfil do contato
2. Na seção “Labels”, clique em ”+ Adicionar”
3. Escolha uma label existente ou crie nova
4. A label é aplicada instantaneamente

​

Exemplos de Labels

• Por Segmento: VIP, Lead Frio, Lead Quente
• Por Status: Cliente, Ex-Cliente, Prospect
• Por Interesse: Produto A, Produto B, Serviços
• Por Origem: Facebook, Google, Indicação

​

Usar Labels para Filtrar

• Enviar mensagens em massa
• Criar automações específicas
• Gerar relatórios segmentados

​

📊 Histórico do Contato

​

Visualizar Histórico

• 💬 Todas as conversas já tidas
• 📅 Linha do tempo de interações
• 📝 Notas adicionadas pela equipe
• 🔄 Mudanças de atribuição/status

​

Adicionar Notas

1. No perfil do contato, vá em “Notas”
2. Clique em ”+ Adicionar Nota”
3. Digite a informação (ex: “Prefere contato por email”)
4. Salve

• Registrar preferências do cliente
• Anotar acordos ou pendências
• Compartilhar contexto com a equipe

​

🔗 Vincular Contato a Inbox

• Email: [email protected]
• WhatsApp: +5511987654321
• Facebook: @joaosilva

1. Abra o perfil do contato
2. Vá em “Canais” ou “Inboxes”
3. Clique em ”+ Adicionar Canal”
4. Escolha o inbox (WhatsApp, Email, etc.)
5. Preencha o identificador (número, email, etc.)

​

📤 Importar Contatos

​

Via CSV

1. Na página de Contatos, clique em “Importar”
2. Baixe o modelo CSV (template)
3. Preencha o CSV com seus dados:
   • Nome, Email, Telefone, etc.
4. Faça upload do arquivo
5. Aguarde processamento

name,email,phone_number,company,custom_attributes
João Silva,[email protected],+5511987654321,Acme Corp,"{""segmento"":""varejo""}"
Maria Santos,[email protected],+5521912345678,XYZ Ltda,"{""segmento"":""atacado""}"

​

Via API

POST /api/v1/accounts/{account_id}/contacts

{
  "name": "João Silva",
  "email": "[email protected]",
  "phone_number": "+5511987654321",
  "custom_attributes": {
    "segmento": "varejo",
    "origem": "site"
  }
}

​

📤 Exportar Contatos

​

Exportar para CSV

1. Na página de Contatos, clique em “Exportar”
2. Escolha filtros (opcional):
   • Por label
   • Por período
   • Por origem
3. Clique em “Exportar CSV”
4. Aguarde email com link de download

• Informações básicas
• Atributos personalizados
• Labels
• Data de criação/atualização

​

🔀 Mesclar Contatos Duplicados

1. Selecione os contatos duplicados (use Shift+Click)
2. Clique em “Ações” → “Mesclar Contatos”
3. Escolha qual será o contato principal
4. Confirme a mesclagem

• Histórico de conversas é unificado
• Atributos são combinados
• Labels são mescladas
• Contato duplicado é removido

​

🗑️ Deletar Contato

1. Abra o perfil do contato
2. Clique em ”…” (três pontos) → “Deletar”
3. Confirme a ação

​

🤖 Automações com Contatos

​

Criar Regras de Automação

• Se contato tem label “VIP” → Atribuir ao melhor agente
• Se contato tem atributo “segmento=corporativo” → Adicionar a funil específico
• Se contato foi criado há 7 dias sem resposta → Enviar follow-up

1. Vá em “Automações”
2. Crie nova regra
3. Use condições baseadas em contato
4. Defina ações

​

📊 Relatórios de Contatos

​

Métricas Disponíveis

• Total de Contatos: Crescimento ao longo do tempo
• Novos Contatos: Por período (dia/semana/mês)
• Contatos por Origem: Qual canal traz mais clientes
• Contatos por Label: Distribuição de segmentos
• Engajamento: Contatos ativos vs inativos

​

Gerar Relatório

1. Vá em “Relatórios” → “Contatos”
2. Escolha período e filtros
3. Visualize gráficos
4. Exporte para PDF/CSV se necessário

​

💡 Dicas e Boas Práticas

​

Organização

​

Privacidade

​

Produtividade

​

🔌 Integração via API

​

Listar Contatos

GET /api/v1/accounts/{account_id}/contacts

​

Criar Contato

POST /api/v1/accounts/{account_id}/contacts

​

Atualizar Contato

PATCH /api/v1/accounts/{account_id}/contacts/{contact_id}

​

Deletar Contato

DELETE /api/v1/accounts/{account_id}/contacts/{contact_id}

​

❓ Perguntas Frequentes

​

🚀 Próximos Passos