Clientes

A área Clientes é o centro do Scoutello CRM. Ela lista as pessoas, empresas, fornecedores, membros, parceiros, convidados, leads e outras entidades que uma organização acompanha para vendas, hospitalidade, eventos, associações, suporte ou acompanhamento operacional.

Rota: /organizations/:id/customers

Rota de detalhes do cliente: /organizations/:id/customers/:customerId

O que um Registro de Cliente Representa

Um registro de cliente pode ser um contato clássico, mas também pode representar conceitos mais operacionais:

• Uma pessoa que participa de um evento, recebe uma newsletter ou faz login em um aplicativo web privado.
• Uma empresa ou conta com pessoas e projetos relacionados.
• Um fornecedor, parceiro, guia, patrocinador, palestrante, local, membro de associação, hóspede recorrente ou parte interessada interna.
• Um registro criado manualmente, importado de um arquivo, copiado de outra organização permitida, raspado/enriquecido ou gerado por um formulário voltado para o cliente ou fluxo de eventos.

O cliente é o melhor ponto de partida para o suporte, pois muitos fluxos de CRM e voltados para o cliente eventualmente se anexam a ele.

Campos Importantes

Os registros de clientes podem incluir:

• Identidade: nome, sobrenome, cargo, departamento, título do cargo, nome da empresa, tipo, conta de usuário vinculada.
• Detalhes de contato: e-mail, telefone, segundo telefone, site, LinkedIn, Facebook, Instagram, YouTube, XING, Bluesky e outros links sociais.
• Classificação: tipo, status, origem, tags, campos personalizados, notas, descrições e ordem.
• Campos de perfil pessoal: idade, data de nascimento, gênero, pronomes, idiomas falados, imagens e configurações de visibilidade do perfil.
• Contexto da organização: organização proprietária, organização associada, cliente responsável, função, permissões, estado convidado/aceito e acesso de membro.
• Contexto de rede: relações de clientes, indicações, links de responsabilidade, participação em projetos, projetos atribuídos, eventos atribuídos, tours atribuídos, páginas de destino atribuídas, ofertas atribuídas e newsletters atribuídas.
• Contexto de comunicação: e-mails recebidos, e-mails enviados como remetente, parte local do remetente pessoal, e-mail de contato, assinatura de e-mail, assinaturas de newsletter e estado de opt-out de e-mail.
• Contexto operacional: tarefas, protocolos, documentos, participantes de eventos, faturas, envios de formulários de contato, entradas salvas, links curtos e acesso a páginas de destino.

Nem todos os campos são visíveis em todos os formulários. A visibilidade depende do tipo de cliente, permissões, configuração da organização e da guia atual.

Tipos e Status

Tipos de clientes usados pelo painel:

• Pessoa: contato individual, convidado, membro, participante, membro da equipe ou parte interessada.
• Empresa: empresa ou conta de cliente.
• Fornecedor: contato de fornecedor ou vendedor.
• Outro: fallback para registros que não se encaixam nas categorias padrão.

Status de clientes usados nas listas de CRM:

• prospect
• first_contact
• proposal_sent
• in_negotiation
• low_confidence
• won
• lost

O suporte deve tratar esses status como rótulos operacionais. Eles ajudam as equipes a filtrar e entender o estado do pipeline ou do relacionamento, mas não concedem acesso, enviam e-mails ou alteram a participação em eventos por si só.

Visualizações de Lista e Filtros

A lista de clientes suporta comportamento de tabela, comportamento de lista móvel e visualizações em estilo kanban. Os controles comuns da lista incluem:

• Pesquisa e filtragem de colunas.
• Exibição de status e tipo.
• Filtragem de intervalo de datas de última atualização.
• Mostrar registros adicionados externamente.
• Mostrar registros com permissões.
• Mostrar apenas registros atribuídos.
• Seleção em massa e edição em massa onde permitido.

Se um usuário disser que um cliente está faltando, verifique a organização ativa, as permissões, o escopo de atribuição exclusiva, o texto de pesquisa, os filtros rápidos, o filtro de data e se o registro existe em outra organização.

Criação e Importação de Clientes

Usuários com as permissões corretas podem criar clientes manualmente ou importá-los.

Pontos de entrada comuns:

• Criar: criar um novo registro de cliente.
• Importar de arquivo: carregar dados de clientes de um fluxo de importação de arquivo.
• Importar de organização: copiar registros permitidos de outra organização.
• Raspagem/importação de leads: usar um fluxo de raspagem onde habilitado.

Ao criar ou atualizar clientes do tipo pessoa, o Scoutello pode vincular uma conta de usuário existente por e-mail em fluxos suportados. As verificações de e-mail duplicado são cientes da organização, portanto, o suporte deve verificar a organização antes de assumir que um duplicado pertence ao mesmo conjunto de dados de CRM.

Guias de Detalhes do Cliente

Registros de clientes existentes podem mostrar várias guias:

• Visão geral: contexto de contato de alto nível e ações rápidas.
• Avançado: campos detalhados do formulário do cliente e controles de assinatura de newsletter.
• Relações: relações diretas com outros clientes.
• Indicações: quem indicou este cliente e quem este cliente indicou.
• Protocolos: histórico de interações do cliente.
• Documentos: arquivos vinculados ao cliente.
• Tarefas: trabalho de acompanhamento vinculado ao cliente.
• E-mails: contexto de e-mail de entrada ou saída para o cliente.
• Eventos: participação em eventos e links de eventos para registros de pessoas.
• Acesso: configurações de perfil, função, permissões e acesso a aplicativos web para registros de pessoas onde editáveis.

As guias aparecem apenas quando o usuário tem as permissões de módulo relevantes e quando o tipo de cliente suporta a guia.

Ações Rápidas

A partir de listas e páginas de detalhes de clientes, os usuários podem ser capazes de:

• Criar um protocolo.
• Criar uma tarefa.
• Compor um e-mail.
• Adicionar o cliente a uma newsletter.
• Adicionar o cliente a um evento.
• Adicionar o cliente a um projeto.
• Adicionar uma relação.
• Limpar sinalizadores adicionados externamente.
• Editar em massa ou excluir clientes selecionados.

As ações disponíveis dependem da função do usuário ativo, estado de bloqueio, tipo de cliente, associação à organização e permissões de entidade.

Como os Clientes se Conectam a Outros Módulos

• Protocolos explicam o que aconteceu com o cliente.
• Tarefas mostram o que ainda precisa acontecer.
• Documentos armazenam arquivos relevantes para o cliente.
• Projetos mostram iniciativas de longo prazo envolvendo o cliente.
• Newsletters mostram o contexto de assinatura e lista de campanhas.
• E-mail mostra conversas e contexto de remetente/destinatário.
• Eventos mostram convites, participação, ingressos, estado de check-in e contexto de cliente atribuído.
• Páginas de destino e tours podem usar registros de acesso e atribuição de clientes para experiências privadas ou direcionadas.

Notas de Permissão

O item da barra lateral do cliente aparece quando o usuário pode listar ou ler clientes. O comportamento de criação, edição, exclusão e atribuição exclusiva é controlado separadamente pelas permissões da organização.

Implicações importantes de suporte:

• Usuários com atribuição exclusiva podem ver apenas registros conectados ao seu contexto responsável ou atribuído.
• Um usuário pode ser capaz de ler clientes, mas não criá-los, editá-los, excluí-los, editá-los em massa ou importá-los.
• Campos de acesso/perfil são sensíveis porque podem afetar funções de membro, acesso a aplicativos web privados e quais informações aparecem em perfis públicos ou de membros.
• Administradores da plataforma podem ver controles exclusivos para administradores que usuários normais da organização não veem.

Cenários Comuns de Suporte

Um cliente está faltando na lista

Verifique:

1. Organização ativa na URL.
2. Pesquisa, filtros rápidos, filtros de data e filtro de atribuição exclusiva.
3. Escopo de permissão do cliente para o usuário.
4. Se o cliente pertence a outra organização.
5. Se o registro foi adicionado externamente ou ocultado por um filtro.
6. Se o usuário está visualizando um subconjunto específico de projeto, evento, newsletter ou cliente, em vez da lista completa de clientes da organização.

Um cliente duplicado não pode ser criado

Verifique se outro cliente na mesma organização já usa o endereço de e-mail. Registros do tipo pessoa podem se vincular a usuários por e-mail, portanto, a exclusividade do e-mail e o vínculo do usuário geralmente estão envolvidos.

Uma guia ou ação está faltando

Verifique a permissão da entidade para a guia ou ação. Por exemplo, a falta de protocolos geralmente aponta para permissões de lista/leitura de protocolo; a falta de ações de tarefa pode apontar para permissões de criação/edição de tarefa; a falta de documentos aponta para permissões de lista/leitura/edição de documento.

Um cliente não aparece em uma newsletter, evento ou projeto

Verifique se o cliente foi explicitamente atribuído ou assinado, se o tipo de cliente é suportado por esse fluxo e se a filtragem de atribuição exclusiva está ativa.

Conceitos relacionados: Protocolos, Documentos.