Importar Clientes – Citrus.cx https://hml-docs.citrus.cx Base de Conhecimento Fri, 08 Aug 2025 13:58:25 +0000 pt-BR hourly 1 https://wordpress.org/?v=6.9.4 https://hml-docs.citrus.cx/wp-content/uploads/2023/08/cropped-doc-citrus_LOGO-FAVICON-1-32x32.png Importar Clientes – Citrus.cx https://hml-docs.citrus.cx 32 32 Versão 2.112.0 https://hml-docs.citrus.cx/docs/releases-notes/release-notes/versoes-2-112-1-e-2-112-0/versao-2-112-0/ https://hml-docs.citrus.cx/docs/releases-notes/release-notes/versoes-2-112-1-e-2-112-0/versao-2-112-0/#respond Fri, 15 Nov 2024 15:02:00 +0000 https://docs.citrus.cx/docs/releases-notes/release-notes/versoes-2-112-1-e-2-112-0/versao-2-112-0/
NOVIDADES

Administração: Configuração da Tela de atendimento passa a permitir desabilitar o uso da tecla “Enter” para enviar mensagens

A opção “Desabilitar o Enter para envio de mensagem” foi adicionada às configurações da Tela de atendimento (Administração > Atendimentos > Tela de atendimento > (seção) Ações). 

Quando a caixa de seleção para habilitar o recurso estiver marcada, na tela de Atendimentos (Atendente > Atendimentos), ao responder mensagens de cards dos Canais de Atendimento WebChat e WhatsApp, o Atendente precisará clicar no botão para enviar mensagem (o envio não usando “Enter” do teclado não vai funcionar. 

Configuração na Tela de Atendimento.

Note no exemplo de atendimento pelo WebChat que, com a configuração habilitada, mensagens só são encaminhadas ao pressionar o botão de envio. 

Administração: Consulta por código de cliente reconhecerá apenas números

Melhoria foi aplicada para que clientes de campanhas por SMS, E-mail e WhatsApp, agendadas com o “Tipo de mailling” Arquivo CSV (Administração > Atendimentos > Agendamentos > +Novo/Editar > (seção) Dados do Mailling > (Tipo de mailling) Arquivo CSV ), sejam importados com a informação da coluna “Código” sem máscara de CNPJ ou CPF. 

O ajuste também será validado no campo “Código” do cadastro de clientes pelo menu Administração > Configurações Gerais > Cliente > Clientes. 

Com isso, no momento da consulta por clientes listados em arquivo CSV para Agendamentos, serão mantidos apenas os números registrados na coluna “Código” e removidos quaisquer outros caracteres que possam estar na coluna. 

A mudança na consulta deve evitar que, o não reconhecimento de caracteres especiais na coluna (CSV) ou no campo (cadastro de Cliente) “Código”, gerem duplicidade de clientes com um mesmo código. E, consequentemente, faça com que um mesmo cliente seja registrado mais de uma vez para uma única campanha. 

Telas de Clientes e de Agendamentos. 

Além disso, foi resolvido o problema que resultava na apresentação do alerta: “Os dados retornados pela API estão em um formato incompatível com a plataforma”, na aba Log de execução da tela de Agendamentos com “Tipo de mailling” Arquivo CSV ou Webservice.  

O cenário ocorre quando o sistema verifica se foi criada uma pasta e salvos os arquivos nela. Caso a pasta não exista, o sistema cria a pasta e salva o(s) arquivo(s) para execução posterior.

Clique na imagem para ver em tela cheia.

CORREÇÃO

Administração: Caracteres especiais serão removidos do código de cliente no processo de importação

O processo de importação de clientes em lote para campanhas agendadas por SMS, E-mail e WhatsApp pelo menu (Administração > Atendimentos > Agendamentos > +Novo/Editar) recebeu melhoria para eliminar caracteres especiais, como ponto, do “Código” de cliente.  

O novo comportamento será aplicado tanto a Agendamentos criados com “Tipo de mailling” Arquivo CSV como com o tipo Webservice. Vai funcionar também para o campo “Código” do cadastro de clientes (menu Administração > Configurações Gerais > Cliente > Clientes). 

A validação vai considerar apenas números do código e pode ocorrer de duas formas: 

  1. Na criação de um cliente: Vai analisar o código e importar somente números, desconsiderando qualquer caractere especial.
  2. Ao importar novamente um cliente já criado: Durante a importação a consulta identificará que o cliente já existe e não vai criar outro cadastro para ele (não ocorrerá duplicidade de clientes com um mesmo código). Será mantido o cliente criado originalmente e, em Agendamentos, os caracteres especiais que possam estar no código cadastrado serão desconsiderados. 

A atualização do processo de importação e criação de clientes deve impedir a geração de duplicidade de clientes em Agendamentos de campanhas, evitando que um mesmo cliente seja cadastrado mais de uma vez para uma única campanha. 

Com a melhoria, espera-se garantir uma boa experiência para clientes de campanhas, evitando o inconveniente de contatos repetidos e indesejados.

Telas de Clientes e de Agendamentos. 

]]> https://hml-docs.citrus.cx/docs/releases-notes/release-notes/versoes-2-112-1-e-2-112-0/versao-2-112-0/feed/ 0 Versão 2.107.0 https://hml-docs.citrus.cx/docs/releases-notes/release-notes/versao-2-107-0/ https://hml-docs.citrus.cx/docs/releases-notes/release-notes/versao-2-107-0/#respond Mon, 02 Sep 2024 19:25:00 +0000 https://docs.citrus.cx/docs/releases-notes/release-notes/versao-2-107-0/
NOVIDADE

Atendimentos: Canais de Atendimento associados ao Grupo de Atendente

A tela Grupo de Atendente (Administração > Atendimentos > Grupo de Atendente > (botão) +Novo) recebeu o bloco Canais de Atendimento com o campo para seleção dos canais disponíveis na plataforma. 

Dessa forma, o Atendente visualiza na listagem da tela Atendimentos apenas os Protocolos dos canais para os quais esse permissionamento reflete na configuração. 

Se o Administrador não selecionar algum Canal de Atendimento para os Atendentes nessa configuração Grupo de Atendente, então esses Atendentes podem ver todos os Atendimentos da listagem. 

* Confira como configurar Grupo de Atendente. 

CORREÇÕES

Atendimentos: Melhoria na oferta de cards

A plataforma redirecionava os Atendentes que já tinham realizado o primeiro atendimento ao fluxo de atendimento, antes que todos os Atendentes disponíveis fizessem um atendimento. 

Esse comportamento causava uma distribuição desigual e sobrecarga para alguns Atendentes, porque novos cards não eram ofertados aos Atendentes que ainda não tinham realizado atendimento. 

 

Após a melhoria, as regras para a oferta de cards são as seguintes: 

– Os cards tocam para todos os Atendentes logados que ainda não realizaram algum atendimento. 

– O card é ofertado ao Atendente que acaba de logar na fila, mesmo que outros Atendentes já tenham realizado atendimento. 

– Se todos os Atendentes logados já realizaram algum atendimento, o próximo card é ofertado ao Atendente que passou o tempo de descanso e finalizou atendimento a mais tempo.  

– O card é ofertado ao Atendente que não atingiu a quantidade de atendimentos simultâneos configurada pelo Administrador, considerando também as regras anteriores. 

– Os cards não aceitos são ofertados novamente conforme as regras anteriores. 

Atendimentos: Código enviado ao cliente no Chat

Foi verificado que a plataforma enviava ao cliente o código de ação citrus-finish-session como uma mensagem durante o atendimento via Chat. Essa mensagem causava a falta de compreensão nos clientes. 

Para correção foi removido da plataforma o caractere \n que era enviado pelo bot junto a esse código de finalização da sessão. A partir de agora o cliente recebe corretamente as mensagens do fluxo de atendimento. 

Atendimentos: Visualização de Comentários adicionados

Os novos Comentários deixaram de ser visíveis ao acessar um Atendimento, mesmo após a plataforma exibir a mensagem “Comentário adicionado com sucesso“. Porém, na tela de listagem dos Atendimentos, ao clicar no botão (+) “Informações detalhadas” esses Comentários eram visíveis normalmente. 

Esse cenário ocorreu devido a adição de um Comentário com conteúdo HTML de formato inválido, com 2 aspas duplas (” “) na propriedade <style>. Dessa forma a sequência de caracteres do conteúdo se perdia por não compreender o que era abertura e fechamento. 

Foi ajustada a regra da plataforma para substituição de 1 aspa dupla (“) quando adicionado conteúdo HTML nos Comentários. Assim os Comentários são carregados corretamente. 

Atendimentos: Duplicação de Atendimentos via email

Acontecia a criação de outro Atendimento quando o cliente respondia o email do comentário de um Atendimento em andamento. 

Foi implementada outra forma de identificar o Protocolo ao processar os emails via IMAP. Com a configuração na tela Layout padrão de email de notificação (Administração > Configurações Gerais > Layout padrão de emails de notificação), agora pode ser ativado em quais templates de email um reply-to é adicionado com o número do Protocolo. 

Com essa melhoria a resposta do cliente ao comentário de um Atendimento é salva corretamente nesse Atendimento. 

Base de conhecimento: Regra para visualização dos Artigos

Os Artigos aprovados não eram visualizados pelos usuários. Foi realizado o ajuste na tela Artigo (Base de conhecimento > Artigo) com a retirada da flag “Visível para o cliente” e adicionada a regra ao campo Status. 

Agora quando o campo Status estiver com as seguintes opções selecionadas: “Rascunho” ou “Em validação”, o Artigo não fica visível para usuários. O Artigo somente é visível para usuários se o campo Status estiver selecionado com a opção “Aprovado”, e o Setor do usuário estiver adicionado na seção Setores. 

Para clientes com permissão de acesso a plataforma somente é necessário que o Artigo esteja com o Status “Aprovado”. Dessa forma, a validação de Artigos visíveis em tela acontece por regra padrão da plataforma. 

Atendimentos: Email e senha visíveis na conversa com Chatbot

Identificado que ao iniciar uma conversa com o Chatbot, o cliente após preencher email e senha para autenticação na tela inicial do Webchat, esse email e senha estavam visíveis na conversa. 

Com o ajuste na regra da plataforma para não salvar a primeira mensagem recebida pelo Bot quando o canal Webchat possui o Fluxo alternativo configurado, esse cenário não acontece mais, pois a primeira mensagem que vai para o Bot é o login e senha do cliente que solicita atendimento. 

Configurações Gerais: Dados duplicados ao "Importar clientes"

Durante a ação do botão Importar clientes na tela Clientes (Administração > Configurações Gerais > Clientes), a plataforma salvava, em todos os registros de clientes existentes na base, os dados de Campos Extras do último arquivo CSV importado. Esse cenário causava a duplicação dos dados e informações incorretas de clientes. 

Com a correção na regra de processamento do arquivo CSV, foi eliminado o comportamento de loop, e ajuste na velocidade da ação pela quantidade de linhas e colunas de registro. Assim, a importação de clientes é realizada corretamente e em menor tempo. 

]]> https://hml-docs.citrus.cx/docs/releases-notes/release-notes/versao-2-107-0/feed/ 0 Clientes https://hml-docs.citrus.cx/docs/get-started/administracao/clientes-10805/ https://hml-docs.citrus.cx/docs/get-started/administracao/clientes-10805/#respond Mon, 13 Nov 2023 16:31:55 +0000 https://docs.citrus.cx/docs/get-started/plataforma-citrus-cx-10735/clientes/

No Citrus.cx, Clientes podem ser cadastrados de várias formas na plataforma:

  • Manualmente no sistema (você está aqui);
  • Importando planilhas (você está aqui);
  • Através da tela de Agendamento, caso possua integração com o WebDoctor;
  • Através da tela de Novo Atendimento pelo módulo LemonDesk; 
  • Ou cadastrando uma Conta no módulo LimeSales.

 

Para visualizar os seus Clientes, no menu lateral esquerdo, encontre a opção Administração. Através desta aba, é possível configurar e personalizar todos os detalhes da sua empresa na plataforma.

A tela de administração é segmentada em blocos que agrupam configurações semelhantes. Além disso, no topo da listagem, o campo de busca poderá ser utilizado para localizar a configuração desejada. No bloco Configurações Gerais, localize a opção Cliente.

Seremos redirecionados para outra página, onde será exibida a listagem de Clientes já cadastrados abaixo. Caso deseje realizar a edição de algum item da listagem, basta clicar sobre ele e modificar os campos necessários.

 

No menu superior direito, encontramos quatro opções:

  • +Novo: botão utilizado para criar um novo Cliente.
  • Excluir: botão utilizado para excluir um Cliente já existente. Basta selecioná-lo da listagem e, em seguida, clicar em Excluir para removê-lo.
  • Importar Clientes: botão utilizado para realizar a importação de Clientes através de planilhas.
  • Filtro: botão utilizado para encontrar um Cliente específico na listagem. Ao clicar, será liberado o campo para digitar a palavra-chave desejada e o botão Pesquisar para encontrá-la.

Cadastro manual

Para criar um novo Cliente, basta clicar em +Novo e preencher os campos obrigatórios.

Seremos redirecionados para outra página contendo alguns campos a serem preenchidos para o cadastro de um novo Cliente:

  • Nome: utilizado para atribuir um nome para o Cliente (campo obrigatório).
  • Email: endereço eletrônico do Cliente.
  • Data de Nascimento: Data de Nascimento do Cliente.
  • Código: numeração de identificação único do Cliente (campo obrigatório). Ele será gerado automaticamente, mas poderá ser substituído por um código individual, como o número do CPF ou CNPJ, por exemplo.
  • Telefone: número do telefone fixo. 
  • Telefone 2: número do telefone fixo alternativo. 
  • Celular: número do telefone móvel.
  • Região: Localização do Cliente previamente cadastrada (campo obrigatório).
  • Campos Adicionais por Atendimento: campo utilizado para informar se deseja que sejam exibidos novos campos para este Cliente específico no momento de abertura de atendimentos.
  • WhatsApp: número do WhatsApp do Cliente.
  • Parceria: campo utilizado para indicar os percentuais de desconto que este cliente possui no módulo LimeSales.
  • Campos Extras do Tipo de Cliente: determina campos extras específicos para o Tipo de Cliente informado. 
  • Campos Extras do Cliente: determina campos extras específicos para o Cliente cadastrado. 
  • Deseja receber nosso contato através das mídias: habilitando estes campos, será autorizado o envio de comunicados para os clientes por meios dos canais de contatos disponíveis (E-mail, SMS, Telefone e WhatsApp).
  • Figura Pública: habilite este parâmetro para classificar o Cliente como um pessoa pública. Exemplo: Influencers, Apresentadores etc.

Finalizado o preenchimento, clique em Salvar e continuar.

Cadastro via planilha

Na tela inicial das Contas, clique no botão Importar clientes localizado no menu superior direito da tela.

Será exibido um pop-up, onde selecionamos a opção Download do layout.

Será feito o download de um modelo de planilha no formato .csv, onde poderá ser feito o preenchimento das informações das Contas, assim como o Nome, Telefone, E-mail etc, de forma que cada linha corresponda a um Cliente. Finalizado o preenchimento, salve o arquivo e realize o upload através do botão Escolher arquivo. Caso necessário, também é possível informar o Tipo de cliente que será vinculado às Contas a serem importadas.

Finalizada a configuração, clique em Salvar para realizar a importação da planilha. As contas importadas serão exibidas na listagem em seguida.

Abas complementares

Após cadastrar o Cliente, serão disponibilizadas novas abas de preenchimento opcional para complementar as informações do Cliente. As informações que acabamos de preencher estarão localizadas na aba Dados Principais e podemos navegar entre as demais clicando na opção desejada.

 

Na aba Redes Sociais, podemos informar as Redes Sociais que o Cliente possui. Para acrescentar uma nova Rede Social, selecione da listagem o Tipo de Mídia Social (campo obrigatório) que deseja adicionar e a Conta (campo obrigatório) vinculada a este Cliente. Em seguida, clique no botão +Adicionar. Ela será exibida abaixo. Repita o procedimento para adicionar novas Redes Sociais.

 

Na aba Contratos, podemos acrescentar Contratos existentes vinculados a este Cliente. Os Contratos são utilizados para controlar as especificações que o Cliente ativou para prestação de serviços. Para isso, clique no botão + Novo Contrato e preencha os campos solicitados:

  • Nome: utilizado para atribuir um nome ao Contrato (campo obrigatório).
  • Número: sequência numérica única de identificação do Contrato (campo obrigatório).
  • Pacote de SLA: campo utilizado para associar um Pacote de SLA ao Contrato, permitindo que seja controlado o SLA do Cliente de acordo com o serviço contratado. Assim, ao associar o Contrato a um Pacote de SLA, a plataforma calculará o SLA com base nas configurações do Pacote de SLA que foi vinculado para este Contrato.
  • Vigência: campo utilizado para informar o Início e o Fim da validade do Contrato. Este período é utilizado para facilitar o controle de quais Contratos ainda estão ativos, evitando que sejam abertos chamados para Contratos que já expiraram.

*Também é importante indicar se o Contrato a ser cadastrado está Ativo através da respectiva flag.

 

Em seguida, clique no botão Salvar e o Contrato será exibido abaixo. Repita o procedimento para adicionar novos Contratos.

 

Na aba Sites, podemos acrescentar os Endereços vinculados a este Cliente. Este recurso pode ser utilizado para registrar as localidades dos clientes e enviar mercadorias ou visitas técnicas, por exemplo. Para isso, clique no botão + Novo Site e preencha os campos solicitados. Em seguida, clique no botão Salvar e o Site será exibido abaixo. Repita o procedimento para adicionar novos Sites.

 

Na aba Usuários, podemos acrescentar os Usuários vinculados a este Cliente. Este recurso pode ser utilizado para permitir que o Cliente tenha acesso à plataforma para acompanhar solicitações e protocolos, por exemplo. Para isso, clique no botão + Novo Usuário e preencha os campos solicitados. Em seguida, clique no botão Salvar e o Site será exibido abaixo. Repita o procedimento para adicionar novos Usuários.

 

Na aba Observações, podemos informar detalhes específicos importantes a respeito deste Cliente.

 

Na aba Inventário, serão exibidos todos os Produtos e Serviços contratados por este Cliente, onde podemos consultar todas as licenças e equipamentos adquiridos por ele ou realizar o cadastro de novos itens. Para isso, preencha os campos solicitados e clique no botão Salvar abaixo. O item será exibido na listagem em seguida. Repita o procedimento para adicionar novos itens ao Inventário.

 

Na aba Observadores, podemos adicionar Usuários para realizar o acompanhamento de todos os Atendimentos abertos para este Cliente. Esses Usuários receberão Alertas via e-mail contendo um detalhamento de todas as ações executadas nos Atendimentos.

 

Na aba Anexos, podemos acrescentar Arquivos a serem anexados à plataforma vinculados a este Cliente para serem visualizados internamente pelos usuários da sua empresa. Este recurso pode ser utilizado para acrescentar fotos de documentos pessoais, PDFs de Contratos, entre outros. Para isso, clique no botão Selecione o Arquivo e será aberta uma janela para selecionar o arquivo localizado no diretório da sua máquina local. Em seguida, clique no botão + Adicionar e o Anexo será exibido ao lado. Repita o procedimento para adicionar novos Anexos.

 

Na aba Vendedores, caso este Cliente esteja associado a uma ou mais Carteiras de Clientes através do módulo de vendas LimeSales, serão exibidos os Vendedores responsáveis este Cliente. 

 

Por fim, na aba Arquivos, temos acesso a uma funcionalidade específica que permite a visualização de Arquivos de acordo com o Usuário registrado na plataforma. Esta aba poderá ser utilizada, por exemplo, para Clientes que possuem vários Usuários vinculados e precisam associar Arquivos. 

Restringir acesso de Arquivos

Vamos a um exemplo prático: a sua empresa fornece serviços para um Cliente do tipo Pessoa Jurídica chamado Banco Legal.

O Cliente Banco Legal abriu uma solicitação de atendimento e gostaria que os funcionários Ana (gerente do Banco Legal) e João (supervisor do Banco Legal) acompanhassem o protocolo na plataforma da sua empresa.

Para isso, seriam criados Usuários específicos para Ana e João na aba Usuários no cadastro do Cliente Banco Legal, indicando que esses Usuários poderão acessar a plataforma da sua empresa e estão vinculados ao Cliente Banco Legal.

Entretanto, imagine que Ana, como gerente, possa ter acesso a Diretórios de Arquivos que João, como supervisor, não poderia ter. Para isso, na aba Arquivos, podemos informar o Nome do diretório a ser criado e clicar em Salvar.

O Diretório será exibido ao lado e, ao clicar sobre ele com o botão direito do mouse, serão exibidas opções de permissão para Usuários específicos. Por aqui, podemos selecionar

]]> https://hml-docs.citrus.cx/docs/get-started/administracao/clientes-10805/feed/ 0