> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agencyhandy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Gerenciamento de Clientes: Perfis, Importação e Configuração

> Crie e importe perfis de clientes no AgencyHandy, acompanhe pedidos e faturas, gerencie o acesso ao portal e organize clientes por categorias.

A seção de Clientes do CRM do AgencyHandy é seu hub centralizado para cada organização ou indivíduo que avançou além do estágio de prospect. Aqui você pode criar perfis de clientes manualmente ou em massa, manter os dados de contato atualizados, acompanhar pedidos e faturas recentes, segmentar clientes em categorias personalizadas e monitorar o acesso ao portal — tudo a partir de uma única visualização em lista.

<Note>
  Você precisa de uma função de **Super Admin** ou **Admin** para criar, editar, importar ou configurar perfis de clientes. Gerentes podem visualizar detalhes e logs de atividades de clientes.
</Note>

## Criando um Perfil de Cliente

Ao integrar um novo cliente, o AgencyHandy cria uma conta no portal para ele e envia um convite de login seguro.

<Steps>
  <Step title="Acesse Clientes">
    Faça login na sua conta do AgencyHandy, clique em **CRM** na barra lateral esquerda e selecione a aba **Clientes**.
  </Step>

  <Step title="Abra o formulário de criação">
    Clique em **+ Criar Cliente** no canto superior direito. Um formulário é aberto.
  </Step>

  <Step title="Insira as informações do cliente">
    Preencha os detalhes do cliente:

    * **Nome / Sobrenome** *(obrigatório)*
    * **E-mail** *(obrigatório — usado para enviar o convite ao portal)*
    * **Nome da Empresa**
    * **Número de Telefone**
    * **País, Estado, Cidade, CEP**
    * **Categoria** — atribua uma categoria de configuração existente, se aplicável
  </Step>

  <Step title="Salve o perfil">
    Clique em **Criar**. O perfil é adicionado à sua lista de clientes imediatamente.
  </Step>
</Steps>

<Note>
  Após criar o perfil, o cliente recebe um e-mail contendo uma URL de login segura. Ao clicar nessa URL, a conta no portal é ativada e o cliente pode fazer login pela primeira vez.
</Note>

## Importando Clientes a partir de CSV

Se você está migrando de outra plataforma ou tem uma planilha de clientes existentes, pode importá-los todos de uma vez.

<Steps>
  <Step title="Clique em Importar">
    Na lista de Clientes, clique no botão **Importar** no canto superior direito.
  </Step>

  <Step title="Faça upload do seu arquivo CSV">
    Arraste e solte o arquivo na área de upload ou clique para navegar e selecioná-lo. O AgencyHandy aceita arquivos CSV com os seguintes campos:

    * Nome do Cliente *(obrigatório)*
    * E-mail *(obrigatório)*
    * Nome da Empresa
    * País
    * Estado
    * Cidade
    * CEP
  </Step>

  <Step title="Mapeie suas colunas">
    O AgencyHandy detecta automaticamente os nomes de colunas que correspondem aos nomes dos seus campos. Para colunas sem correspondência, use os menus suspensos para mapeá-las manualmente para os campos corretos do sistema.
  </Step>

  <Step title="Visualize e confirme">
    Revise a tabela de prévia para identificar quaisquer problemas de formatação antes que os dados sejam salvos.
  </Step>

  <Step title="Finalize a importação">
    Clique em **Salvar**. Uma mensagem de confirmação aparece assim que todos os registros são importados com sucesso.
  </Step>
</Steps>

<Tip>
  Se os cabeçalhos das colunas da sua planilha corresponderem exatamente aos nomes dos campos do AgencyHandy (por exemplo, "email", "nome da empresa"), o mapeador é preenchido automaticamente — sem necessidade de correspondência manual.
</Tip>

## Exportando Clientes

Faça backup do seu banco de dados de clientes ou compartilhe-o com partes interessadas exportando para CSV ou Excel.

<Steps>
  <Step title="Clique em Exportar">
    Na lista de Clientes, clique no botão **Exportar** no canto superior direito.
  </Step>

  <Step title="Personalize sua exportação">
    Escolha quais colunas incluir — selecione **Todas as Colunas** para uma exportação completa ou escolha campos específicos como nome, dados de contato, empresa ou endereço.
  </Step>

  <Step title="Escolha um formato">
    Selecione **CSV** ou **XLSX** dependendo do uso pretendido.
  </Step>

  <Step title="Baixe o arquivo">
    Clique em **Exportar**. O arquivo é gerado e baixado para o seu dispositivo. Armazene-o com segurança para proteger os dados dos clientes.
  </Step>
</Steps>

## Editando um Perfil de Cliente

<Steps>
  <Step title="Selecione o cliente">
    Na lista de Clientes, clique na caixa de seleção ao lado do cliente que deseja atualizar ou clique diretamente no nome dele para abrir o perfil.
  </Step>

  <Step title="Entre no modo de edição">
    Clique no botão **Editar** no canto superior direito do perfil do cliente. Um formulário de edição é exibido.
  </Step>

  <Step title="Atualize as informações">
    Modifique os campos que desejar — nome, e-mail, telefone, endereço, empresa ou categoria.
  </Step>

  <Step title="Salve suas alterações">
    Clique em **Atualizar**. Uma mensagem de confirmação confirma que o perfil foi salvo com sucesso.
  </Step>
</Steps>

## Pesquisando, Ordenando e Filtrando

A lista de Clientes oferece várias ferramentas para encontrar o cliente certo rapidamente:

<CardGroup cols={2}>
  <Card title="Pesquisar por Nome" icon="magnifying-glass">
    Digite o nome de um cliente na barra de pesquisa para filtrar instantaneamente a lista.
  </Card>

  <Card title="Filtrar por Empresa" icon="building">
    Restrinja a lista a clientes associados a uma empresa específica.
  </Card>

  <Card title="Filtrar por E-mail" icon="envelope">
    Localize um cliente quando você conhece o endereço de e-mail dele, mas não o nome.
  </Card>

  <Card title="Filtrar por Status" icon="circle-check">
    Exiba apenas clientes ativos, inativos ou convidados.
  </Card>

  <Card title="Ordenar Alfabeticamente" icon="arrow-down-a-z">
    Ordene a lista completa de clientes de A–Z ou Z–A por nome para referência rápida.
  </Card>

  <Card title="Filtrar por Categoria" icon="tag">
    Exiba apenas clientes atribuídos a uma categoria de configuração específica.
  </Card>
</CardGroup>

## Acompanhando a Atividade do Cliente

Dentro de cada perfil de cliente, você encontrará abas que oferecem uma visão ao vivo do engajamento desse cliente com sua agência:

<Accordion title="Pedidos Recentes">
  Visualize um histórico de todos os pedidos realizados pelo cliente, incluindo nome do serviço, pacote, status e data. Isso fornece um panorama rápido do histórico de compras sem sair do CRM.
</Accordion>

<Accordion title="Tickets Recentes">
  Veja todos os tickets de suporte ou serviço enviados pelo cliente. Use esta visualização para priorizar respostas e garantir que nenhuma solicitação passe despercebida.
</Accordion>

<Accordion title="Faturas Recentes">
  Acesse um log de todas as faturas geradas para o cliente, incluindo o status de pagamento. Isso ajuda você a monitorar saldos pendentes e o histórico de faturas em um único lugar.
</Accordion>

## Configuração de Clientes (Categorias)

A Configuração de Clientes permite criar categorias com código de cores para segmentar sua lista de clientes — por exemplo, *Alta Prioridade*, *Retainer* ou *Em Espera*. As categorias aparecem como opções de filtro na lista de clientes para que você possa acessar instantaneamente o grupo certo.

<Steps>
  <Step title="Abra a Configuração">
    Na seção de Clientes, clique no botão **Configuração**.
  </Step>

  <Step title="Crie uma nova categoria">
    Clique em **+ Criar Categoria**.
  </Step>

  <Step title="Insira os detalhes da categoria">
    * **Nome da Categoria** — um rótulo único e descritivo (por exemplo, *Clientes Enterprise*)
    * **Descrição Curta** — uma breve nota explicando o propósito da categoria
    * **Cor** — escolha uma cor distinta para reconhecimento visual rápido
  </Step>

  <Step title="Salve a categoria">
    Clique em **Criar**. A categoria agora está disponível para atribuição ao editar perfis de clientes.
  </Step>

  <Step title="Atribua clientes à categoria">
    Abra qualquer perfil de cliente, clique em **Editar**, selecione o campo **Categoria** e escolha a categoria relevante. Clique em **Atualizar** para salvar.
  </Step>
</Steps>

<Tip>
  Use convenções de cores consistentes em todas as categorias — por exemplo, vermelho para clientes de alta urgência e verde para contas totalmente integradas — para tornar a lista facilmente escaneável com um olhar.
</Tip>

## Log de Atividades do Cliente

O Log de Atividades registra cada evento de login e logout da conta do portal de um cliente, fornecendo um rastro de auditoria claro do engajamento.

**Para visualizar o log:**

1. Acesse **Clientes** e abra o perfil de um cliente específico.
2. Clique na aba **Log de Atividades** na barra de navegação superior do perfil.
3. Revise a lista cronológica de eventos de autenticação.

**O que o log mostra:**

* Data e hora exatas de cada **login**
* Data e hora exatas de cada **logout**
* Um histórico completo de todos os eventos de autenticação

O log é atualizado em tempo real e não pode ser editado ou excluído. Os clientes não têm acesso ao próprio log de atividades — ele é apenas para visibilidade administrativa e de conformidade.

<Note>
  Neste estágio, o log de atividades captura apenas eventos de autenticação (login e logout). Ações realizadas dentro do portal — como visualizar pedidos — ainda não são registradas aqui.
</Note>

## Enviando E-mail para um Cliente

Você pode enviar um e-mail para qualquer cliente diretamente do perfil dele sem sair do AgencyHandy. Abra o perfil do cliente e use a opção **E-mail** para redigir sua mensagem. O campo **Para** é preenchido automaticamente com o endereço de e-mail do cliente.

## Personificação de Cliente

Admins podem personificar uma conta de cliente para ver exatamente o que o cliente vê no portal — útil para solucionar problemas de acesso ou auxiliar um cliente em um processo durante uma chamada de suporte. Procure a opção **Personificar** dentro do perfil do cliente.

<Warning>
  Use a personificação apenas para fins de suporte. Quaisquer ações realizadas durante a personificação de um cliente são executadas em nome dele e serão refletidas na conta do cliente.
</Warning>

## Contas Empresariais (B2B)

Se você trabalha com empresas em vez de indivíduos, pode definir um **Nome de Empresa** em qualquer perfil de cliente para agrupar contatos da mesma organização. A lista de Clientes pode ser filtrada por empresa, facilitando a visualização de todos os contatos de uma determinada conta juntos.