Arquivo CSV – Citrus.cx https://hml-docs.citrus.cx Base de Conhecimento Thu, 23 Oct 2025 13:28:14 +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 Arquivo CSV – Citrus.cx https://hml-docs.citrus.cx 32 32 Versão 2.109.6 https://hml-docs.citrus.cx/docs/releases-notes/release-notes/versoes-2-109-1-a-2-109-0/versao-109-6/ https://hml-docs.citrus.cx/docs/releases-notes/release-notes/versoes-2-109-1-a-2-109-0/versao-109-6/#respond Fri, 01 Nov 2024 14:32:00 +0000 https://docs.citrus.cx/docs/releases-notes/release-notes/versoes-2-109-1-a-2-109-0/versao-109-6/
NOVIDADE

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.

]]> https://hml-docs.citrus.cx/docs/releases-notes/release-notes/versoes-2-109-1-a-2-109-0/versao-109-6/feed/ 0 Versão 2.102.1 https://hml-docs.citrus.cx/docs/releases-notes/release-notes/versoes-2-102-0-a-2-102-2/versao-2-102-1/ https://hml-docs.citrus.cx/docs/releases-notes/release-notes/versoes-2-102-0-a-2-102-2/versao-2-102-1/#respond Thu, 25 Jul 2024 12:13:54 +0000 https://docs.citrus.cx/docs/releases-notes/release-notes/versao-2-102-1/
NOVIDADE

Agendamentos: Geração de arquivo .csv com inconsistências

A plataforma passa a gerar o arquivo .csv padronizado contendo os registros que foram rejeitados durante a higienização dos dados de Campanhas via SMS e Email, e os disponibiliza ao usuário na tela Agendamentos (Administração > Atendimentos > Agendamentos > selecione o “Nome” da Campanha > (ícone) Log de execução > (botão) “Download“). 

Ao clicar no ícone Log de execução na parte superior esquerda da tela, é exibida a tabela com as colunas: 

– Inconsistências: com a flag SIM em vermelho para indicar existência de erros na execução da Campanha. 

– Detalhes: com o quantitativo de erros e o botão “Download” ao lado para geração do arquivo .csv. 

Esse novo recurso visa possibilitar ao usuário corrigir as inconsistências identificadas no arquivo de entrada via Webservice configurado no bloco Dados do mailing. 

O arquivo .csv gerado possui as seguintes regras de layout: 

– As colunas 01_LINE_NUMBER (número de erros) e 02_ERROR (descrição dos erros). 

– As colunas originais do arquivo de entrada de dados para execução da Campanha. 

]]> https://hml-docs.citrus.cx/docs/releases-notes/release-notes/versoes-2-102-0-a-2-102-2/versao-2-102-1/feed/ 0 Tabela de Versionamento https://hml-docs.citrus.cx/docs/guia-do-administrador/configuracoes-de-atendimentos-gestao-de-atendimentos-10358/agendamentos-de-campanhas/tabela-de-versionamento/ https://hml-docs.citrus.cx/docs/guia-do-administrador/configuracoes-de-atendimentos-gestao-de-atendimentos-10358/agendamentos-de-campanhas/tabela-de-versionamento/#respond Mon, 27 May 2024 13:00:00 +0000 https://docs.citrus.cx/docs/guia-do-administrador/configuracoes-de-atendimentos-gestao-de-atendimentos-10358/agendamento-de-campanhas/tabela-de-versionamento/
Versão Última Atualização
2.102.0
22/07/2024
2.98.0
27/05/2024

Por esta tabela é possível acompanhar todas as atualizações reportadas em Tutoriais e Manuais.

  • Nas telas de documentações que exibem a informação “Confira a Tabela de Versionamento”, pressione sobre a mensagem para ser encaminhado para esta tela com todas as versões contempladas. A seguir, basta abrir a versão indicada para acompanhar as atualizações correspondentes.
]]> https://hml-docs.citrus.cx/docs/guia-do-administrador/configuracoes-de-atendimentos-gestao-de-atendimentos-10358/agendamentos-de-campanhas/tabela-de-versionamento/feed/ 0 Logs/Relatório Envio de pesquisa satisfação https://hml-docs.citrus.cx/docs/guia-do-administrador/configuracoes-de-atendimentos-gestao-de-atendimentos-10358/agendamentos-de-campanhas/logs-envio-de-pesquisa-satisfacao/ https://hml-docs.citrus.cx/docs/guia-do-administrador/configuracoes-de-atendimentos-gestao-de-atendimentos-10358/agendamentos-de-campanhas/logs-envio-de-pesquisa-satisfacao/#respond Mon, 27 May 2024 12:59:00 +0000 https://docs.citrus.cx/docs/guia-do-administrador/configuracoes-de-atendimentos-gestao-de-atendimentos-10358/agendamento-de-campanhas/logs-envio-de-pesquisa-satisfacao/
  1. Consulte os Logs da "Campanha de SMS" na tela Agendamentos (Administração > Atendimentos > Agendamentos > (selecione na listagem o "Nome") > Agendamentos).


  2. No topo esquerdo da tela clique no ícone Log de execução.


  3. Visualize a tabela com as informações nas seguintes colunas:


    - Início do período de envio

    - Fim do período de envio

    - Falha

    - Detalhes


    * Em caso da coluna Falha apresentar "Sim", clique no botão Lupa da coluna Detalhes para visualizar o popup com as informações técnicas da falha ocorrida na execução da campanha.


  4. Clique no botão Atualizar para renovar os dados exibidos em tela.


  5. Se desejar, clique no botão Filtrar e selecione os seguintes campos:


    - Início do período de envio: Data do início da execução da campanha.

    - Fim do período de envio: Data do fim da execução da campanha.

    - Falha: Opções "Sim" ou "Não".


  6. Clique nos botões Consultar ou Limpar.


  7. No topo esquerdo da tela clique no ícone Log de envio da pesquisa.


  8. Visulize a tabela Resumo do mailing com as informações de "Descrição" e "Qtde", e o dashboard ao lado.


  9. Role a tela para baixo, visualize a tabela com as informações nas seguintes colunas:


    - Data da importação

    - Data de envio

    - Mailing conta

    - Status do mailing


  10. No topo direito da tela, clique no botão Atualizar para renovar os dados exibidos em tela.


  11. Se desejar, clique no botão Exportar para CSV. É gerado um arquivo CSV e o download na máquina do usuário.


  12. Se desejar, clique no botão Filtrar e selecione os seguintes campos:


    - Quantidade de dias: Opções "10", "20", "30", "60" ou "90".

    - Status do mailing: Opções "Pendente", "Em processamento", "Processado", "Sem consentimento" ou "Erro".

    - Email: O endereço de email do cliente no mailing.

    - Início do período de envio: Data do início da execução da campanha.

    - Fim do período de envio: Data do fim da execução da campanha.


  13. Clique nos botões Consultar ou Limpar.


  14. No topo esquerdo da tela clique no ícone Relatório das respostas da pesquisa.


  15. Visualize a tabela com as informações nas seguintes colunas:


    - Destinatário

    - Resposta

    - Data de envio


  16. Clique no botão Atualizar para renovar os dados exibidos em tela.


  17. Se desejar, clique no botão Filtrar e selecione os seguintes campos:


    - Início do período de envio: Data do início da execução da campanha.

    - Fim do período de envio: Data do fim da execução da campanha.


  18. Clique nos botões Consultar ou Limpar.


  19. No topo esquerdo da tela clique no ícone Gráficos das respostas da pesquisa.


  20. Visualize o dashboard com o quantitativo de respostas.


  21. Se desejar, clique no botão Formato CSV. É gerado um arquivo CSV e o download realizado na máquina do usuário.


  22. Clique no botão Atualizar para renovar os dados exibidos em tela.


  23. Se desejar, clique no botão Filtrar e selecione os seguintes campos:


    - Início do período de envio: Data do início da execução da campanha.

    - Fim do período de envio: Data do fim da execução da campanha.


  24. Clique nos botões Consultar ou Limpar.


  25. Caso deseje editar as configurações da campanha, clique no ícone Dados gerais no topo esquerdo da tela, e após clique no botão Salvar à direita da tela.


  26. Se não desejar realizar o passo 28, clique no botão Cancelar no topo direito da tela.



]]> https://hml-docs.citrus.cx/docs/guia-do-administrador/configuracoes-de-atendimentos-gestao-de-atendimentos-10358/agendamentos-de-campanhas/logs-envio-de-pesquisa-satisfacao/feed/ 0 Logs/Relatório Envio de email https://hml-docs.citrus.cx/docs/guia-do-administrador/configuracoes-de-atendimentos-gestao-de-atendimentos-10358/agendamentos-de-campanhas/logs-envio-de-email/ https://hml-docs.citrus.cx/docs/guia-do-administrador/configuracoes-de-atendimentos-gestao-de-atendimentos-10358/agendamentos-de-campanhas/logs-envio-de-email/#respond Mon, 27 May 2024 12:59:00 +0000 https://docs.citrus.cx/docs/guia-do-administrador/configuracoes-de-atendimentos-gestao-de-atendimentos-10358/agendamento-de-campanhas/logs-envio-de-email/
  1. Consulte os Logs do "Envio de email" na tela Agendamentos (Administração > Atendimentos > Agendamentos > (selecione na listagem o "Nome") > Agendamentos).


  2. No topo esquerdo da tela clique no ícone Log de execução.


  3. Visualize a tabela com as informações nas seguintes colunas:


    - Início do período de envio

    - Fim do período de envio

    - Falha

    - Detalhes

    * Em caso da coluna Falha apresentar "Sim", clique no botão Lupa da coluna Detalhes para visualizar o popup com as informações técnicas da falha ocorrida na execução da campanha.


  4. Clique no botão Atualizar para renovar os dados exibidos em tela.


  5. Se desejar, clique no botão Filtrar e selecione os seguintes campos:


    - Início do período de envio: Data do início da execução da campanha.

    - Fim do período de envio: Data do fim da execução da campanha.

    - Falha: Opções "Sim" ou "Não".


  6. Clique nos botões Consultar ou Limpar.


  7. No topo esquerdo da tela clique no ícone Log de envio de email.


  8. Visulize a tabela Resumo do mailing com as informações de "Descrição" e "Qtde", e o dashboard ao lado.


  9. Role a tela para baixo, visualize a tabela com as informações nas seguintes colunas:


    - Data da importação

    - Data de envio

    - Mailing conta

    - Remetente

    - Status do mailing

    - Status do broker

    - Links


  10. Na coluna Links, se na campanha foi habilitada a flag "Abertura automática de atendimento", clique no botão Atendimento associado para ser redirecionado à tela Atendimentos do protocolo referente.


  11. No topo direito da tela, clique no botão Atualizar para renovar os dados exibidos em tela.


  12. Se desejar, clique no botão Exportar para CSV. É gerado um arquivo CSV e o download realizado na máquina do usuário.


  13. Se desejar, clique no botão Filtrar e selecione os seguintes campos:


    - Quantidade de dias: Opções "10", "20", "30", "60" ou "90".

    - Status do mailing: Opções "Pendente", "Em processamento", "Processado", "Sem consentimento" ou "Erro".

    - Email: O endereço de email do cliente no mailing.

    - Início do período de envio: Data do início da execução da campanha.

    - Fim do período de envio: Data do fim da execução da campanha.


  14. Clique nos botões Consultar ou Limpar.


  15. Caso deseje editar as configurações da campanha, clique no ícone Dados gerais no topo esquerdo da tela, e após clique no botão Salvar à direita da tela.


  16. Se não desejar realizar o passo 15, clique no botão Cancelar no topo direito da tela.



]]> https://hml-docs.citrus.cx/docs/guia-do-administrador/configuracoes-de-atendimentos-gestao-de-atendimentos-10358/agendamentos-de-campanhas/logs-envio-de-email/feed/ 0 Logs/Relatório Campanha de WhatsApp https://hml-docs.citrus.cx/docs/guia-do-administrador/configuracoes-de-atendimentos-gestao-de-atendimentos-10358/agendamentos-de-campanhas/logs-campanha-de-whatsapp/ https://hml-docs.citrus.cx/docs/guia-do-administrador/configuracoes-de-atendimentos-gestao-de-atendimentos-10358/agendamentos-de-campanhas/logs-campanha-de-whatsapp/#respond Mon, 27 May 2024 12:59:00 +0000 https://docs.citrus.cx/docs/guia-do-administrador/configuracoes-de-atendimentos-gestao-de-atendimentos-10358/agendamento-de-campanhas/logs-campanha-de-whatsapp/
  1. Consulte os Logs da "Campanha de WhatsApp" na tela Agendamentos (Administração > Atendimentos > Agendamentos > (selecione na listagem o "Nome") > Agendamentos).


  2. No topo esquerdo da tela clique no ícone Log de execução.


  3. Visualize a tabela com as informações nas seguintes colunas:


    - Início do período de envio

    - Fim do período de envio

    - Falha

    - Detalhes


    * Em caso da coluna Falha apresentar "Sim", clique no botão Lupa da coluna Detalhes para visualizar o popup com as informações técnicas da falha ocorrida na execução da campanha.


  4. Clique no botão Atualizar para renovar os dados exibidos em tela.


  5. Se desejar, clique no botão Filtrar e selecione os seguintes campos:


    - Início do período de envio: Data do início da execução da campanha.

    - Fim do período de envio: Data do fim da execução da campanha.

    - Falha: Opções "Sim" ou "Não".


  6. Clique nos botões Consultar ou Limpar.


  7. Caso deseje editar as configurações da campanha, clique no ícone Dados gerais no topo esquerdo da tela, e após clique no botão Salvar à direita da tela.


  8. Se não desejar realizar o passo 7, clique no botão Cancelar no topo direito da tela.



]]> https://hml-docs.citrus.cx/docs/guia-do-administrador/configuracoes-de-atendimentos-gestao-de-atendimentos-10358/agendamentos-de-campanhas/logs-campanha-de-whatsapp/feed/ 0 Logs/Relatório Campanha de SMS https://hml-docs.citrus.cx/docs/guia-do-administrador/configuracoes-de-atendimentos-gestao-de-atendimentos-10358/agendamentos-de-campanhas/logs-campanha-de-sms/ https://hml-docs.citrus.cx/docs/guia-do-administrador/configuracoes-de-atendimentos-gestao-de-atendimentos-10358/agendamentos-de-campanhas/logs-campanha-de-sms/#respond Mon, 27 May 2024 12:58:00 +0000 https://docs.citrus.cx/docs/guia-do-administrador/configuracoes-de-atendimentos-gestao-de-atendimentos-10358/agendamento-de-campanhas/logs-campanha-de-sms/
  1. Consulte os Logs da "Campanha de SMS" na tela Agendamentos (Administração > Atendimentos > Agendamentos > (selecione na listagem o "Nome") > Agendamentos).


  2. No topo esquerdo da tela clique no ícone Log de execução.


  3. Visualize a tabela com as informações nas seguintes colunas:


    - Início do período de envio

    - Fim do período de envio

    - Falha

    - Detalhes


    * Em caso da coluna Falha apresentar "Sim", clique no botão Lupa da coluna Detalhes para visualizar o popup com as informações técnicas da falha ocorrida na execução da campanha.


  4. Clique no botão Atualizar para renovar os dados exibidos em tela.


  5. Se desejar, clique no botão Filtrar e selecione os seguintes campos:


    - Início do período de envio: Data do início da execução da campanha.

    - Fim do período de envio: Data do fim da execução da campanha.

    - Falha: Opções "Sim" ou "Não".


  6. Clique nos botões Consultar ou Limpar.


  7. No topo esquerdo da tela clique no ícone Log de envio de SMS.


  8. Visulize a tabela Resumo do mailing com as informações de "Descrição" e "Qtde", e o dashboard ao lado.


  9. Role a tela para baixo, visualize a tabela Resumo de envio com as informações de "Descrição" e "Qtde", e o dashboard ao lado.


  10. Role a tela para baixo, visualize a tabela com as informações nas seguintes colunas:


    - Data da importação

    - Data de envio

    - Mailing conta

    - Código

    - Status do mailing

    - Status do broker

    - Links


  11. Na coluna Links clique no botão Conteúdo do SMS. É exibido o popup com a mensagem que foi enviada na execução da campanha.


  12. Ainda na coluna Links, se na campanha foi habilitada a flag "Abertura automática de atendimento", clique no botão Atendimento associado para ser redirecionado à tela Atendimentos do protocolo referente.


  13. No topo direito da tela, clique no botão Atualizar para renovar os dados exibidos em tela.


  14. Se desejar, clique no botão Exportar para CSV. É gerado um arquivo CSV e o download realizado na máquina do usuário.


  15. Se desejar, clique no botão Filtrar e selecione os seguintes campos:


    - Quantidade de dias: Opções "10", "20", "30", "60" ou "90".

    - Status do mailing: Opções "Pendente", "Em processamento", "Processado", "Sem consentimento" ou "Erro".

    - Status do broker: Opções "Enviado", "Recebido", "Respondido", "Erro", "Pendente" ou "Processando".

    - Telefone: O número celular do cliente no mailing.

    - Início do período de envio: Data do início da execução da campanha.

    - Fim do período de envio: Data do fim da execução da campanha.


  16. Clique nos botões Consultar ou Limpar.


  17. Caso deseje editar as configurações da campanha, clique no ícone Dados gerais no topo esquerdo da tela, e após clique no botão Salvar à direita da tela.


  18. Se não desejar realizar o passo 17, clique no botão Cancelar no topo direito da tela.



]]> https://hml-docs.citrus.cx/docs/guia-do-administrador/configuracoes-de-atendimentos-gestao-de-atendimentos-10358/agendamentos-de-campanhas/logs-campanha-de-sms/feed/ 0 Envio de pesquisa satisfação https://hml-docs.citrus.cx/docs/guia-do-administrador/configuracoes-de-atendimentos-gestao-de-atendimentos-10358/agendamentos-de-campanhas/envio-de-pesquisa-satisfacao/ https://hml-docs.citrus.cx/docs/guia-do-administrador/configuracoes-de-atendimentos-gestao-de-atendimentos-10358/agendamentos-de-campanhas/envio-de-pesquisa-satisfacao/#respond Mon, 27 May 2024 12:58:00 +0000 https://docs.citrus.cx/docs/guia-do-administrador/configuracoes-de-atendimentos-gestao-de-atendimentos-10358/agendamento-de-campanhas/envio-de-pesquisa-satisfacao/ Atendimentos > Agendamentos > (botão) +Novo). Preencha os seguintes campos obrigatórios: – Nome: Um nome que define este agendamento de campanha. – Periodicidade: O período que a execução da campanha acontece. – Início do período de envio: Data e hora que a execução da campanha inicia. – Tipo: Selecione […]]]>
  1. Acesse a tela Agendamentos (Administração > Atendimentos > Agendamentos > (botão) +Novo).


  2. Preencha os seguintes campos obrigatórios:


    - Nome: Um nome que define este agendamento de campanha.

    - Periodicidade: O período que a execução da campanha acontece.

    - Início do período de envio: Data e hora que a execução da campanha inicia.

    - Tipo: Selecione "Envio de pesquisa satisfação".


  3. A flag "Desconsiderar consentimento" (se habilitada, o envio da campanha acontece independente do consentimento configurado no cadastro do cliente), e o campo "Descrição", são opcionais.


  4. Clique no botão Salvar e continuar.


  5. No bloco Envio de pesquisa satisfação selecione os seguintes campos obrigatórios:


    - Formulário de pesquisa: Formulário já configurado de pesquisa satisfação.

    - Canal para realização da pesquisa: Opções "Email", "SMS" ou "WhatsApp".


  6. Após o passo 5, a depender da opção selecionada no campo Canal para realização da pesquisa, é exibido o bloco Dados do email, Dados do SMS ou Dados do WhatsApp, para preenchimento dos seguintes campos obrigatórios:


    * Bloco Dados do email

       - Template para o email: Selecione um template já configurado.

       - Email do remetente: Endereço de email a ser enviado como remetente.

       - Assunto do email: Assunto do email a ser enviado.

       - Nome do remetente: Nome que será enviado como remetente do email.


    * Bloco Dados do SMS

       - Descrição: Mensagem com no máximo 160 caracteres. Se desejar, utilize as Tags do quadro ao lado para substituir na mensagem os dados referentes a "Código" e/ou "Nome" do cliente.


    * Bloco Dados do WhatsApp

       - Template de notificação (HSM): Selecione um template já configurado. Ao selecioná-lo aparece no campo "Exemplo" ao lado a mensagem HSM (High Structured Message - Mensagem Altamente Estruturada).


  7. No campo abaixo do campo "Nome do remetente", é possível testar o envio da mensagem via email. Adicione o endereço de email e clique no botão Testar envio.


  8. No bloco Dados do mailing selecione o campo obrigatório Tipo de mailing: "Webservice" ou "Arquivo CSV".


    * Se "Webservice", selecione os seguintes campos obrigatórios:

       - Horário de execução: Opção já configurada com o horário do usuário.

       - WebService: Preencha com URL endpoint da API integrada a plataforma, ou utilize o botão Montar URL.


    * Ao clicar nesse botão é aberto o popup Montagem do URL para que o Administrador possa fazer a montagem e testar URL.

    É necessário preencher os campos obrigatórios: URL Base, Chave e Valor. Após o preenchimento clicar no botão Adicionar. Antes de clicar em Montar URL do popup é possível utilizar o botão Testar URL. Esse teste retorna o download de um arquivo .json com o resultado.

    É possível adicionar em URL base quantos parâmetros forem necessários, e alterar ou excluir os parâmetros já adicionados ao clicar no botão "Lixeira".


    DICA

    Se o URL necessitar de autenticação ou headers para fazer a requisição, é necessário realizar esse cadastro na tela Integração com cliente (Administração > Configurações Gerais > Integração com cliente > (botão) +Novo) e após salvar, selecioná-la no campo Integração com o cliente abaixo do campo WebService. Somente assim é possível fazer o teste com sucesso.

    Os seguintes campos são opcionais:

    - Integração com o cliente: Opção já configurada com a API do usuário.

    - Região: Opção já configurada que classifica a localidade do cliente.

    - Tipo de cliente: Opção já configurada que classifica o cliente.


    A flag "Executar Webservice mesmo com pendência" pode ser habilitada caso deseje que a campanha seja executada mesmo havendo pendência do disparo anterior.


    Os campos opcionais: "Código", "Nome", "Telefone", "Telefone 2", "Celular", "Data de nascimento", e "Email" podem ser preenchidos com os atributos que definem estes campos nos elementos que retornam do Webservice.


    * Se "Arquivo CSV", selecione os seguintes campos obrigatórios:

       - Horário de execução: Opção já configurada com o horário do usuário.

       - Selecione o arquivo para importação: Utilize o botão Escolher arquivo para fazer o upload do Arquivo CSV preenchido com a lista de contatos dos clientes.


    DICA

    Clique no botão Download do layout no final do bloco Dados do mailing para preencher a lista de contatos do Tipo de mailing "Arquivo CSV" e realizar o upload do arquivo com o mesmo layout aceito pela plataforma. Outros tipos de planilhas eletrônicas não são válidos pela plataforma nesta configuração.


    É possível adicionar mais colunas ao "Arquivo CSV". Adicione um Grupo de Campos Extras na Ocorrência, selecione esta Ocorrência pela opção de Abertura automática de atendimento, e adicione os Campos Extras na configuração da Campanha.


  9. Volte ao topo da tela e marque a flag "Habilitado", abaixo do campo Tipo "Envio de pesquisa satisfação", para o Agendamento ser executado de acordo com o período configurado para os disparos.


  10. Clique no botão Salvar no canto superior direito da tela.



]]> https://hml-docs.citrus.cx/docs/guia-do-administrador/configuracoes-de-atendimentos-gestao-de-atendimentos-10358/agendamentos-de-campanhas/envio-de-pesquisa-satisfacao/feed/ 0 Envio de email https://hml-docs.citrus.cx/docs/guia-do-administrador/configuracoes-de-atendimentos-gestao-de-atendimentos-10358/agendamentos-de-campanhas/envio-de-email/ https://hml-docs.citrus.cx/docs/guia-do-administrador/configuracoes-de-atendimentos-gestao-de-atendimentos-10358/agendamentos-de-campanhas/envio-de-email/#respond Mon, 27 May 2024 12:58:00 +0000 https://docs.citrus.cx/docs/guia-do-administrador/configuracoes-de-atendimentos-gestao-de-atendimentos-10358/agendamento-de-campanhas/envio-de-email/ Atendimentos > Agendamentos > (botão) +Novo). Preencha os seguintes campos obrigatórios: – Nome: Um nome que define este agendamento de campanha. – Periodicidade: O período que a execução da campanha acontece. – Início do período de envio: Data e hora que a execução da campanha inicia. – Tipo: Selecione […]]]>
  1. Acesse a tela Agendamentos (Administração > Atendimentos > Agendamentos > (botão) +Novo).


  2. Preencha os seguintes campos obrigatórios:


    - Nome: Um nome que define este agendamento de campanha.

    - Periodicidade: O período que a execução da campanha acontece.

    - Início do período de envio: Data e hora que a execução da campanha inicia.

    - Tipo: Selecione "Envio de email".


  3. A flag "Desconsiderar consentimento" (se habilitada, o envio da campanha acontece independente do consentimento configurado no cadastro do cliente), e o campo "Descrição", são opcionais.


  4. Clique no botão Salvar e continuar.


  5. No bloco Envio de email preencha os seguintes campos obrigatórios:


    - Template para o email: Selecione um template já configurado.

    - Email do remetente: Endereço de email a ser enviado como remetente.

    - Assunto do email: Assunto do email a ser enviado.

    - Nome do remetente: Nome que será enviado como remetente do email.


    * O campo "Modificar Endereço de Resposta" é de preenchimento opcional. Se desejar, preenchá-o para que a resposta seja direcionada para outro endereço de email.


  6. No campo abaixo do campo "Nome do remetente", é possível testar o envio da mensagem via email. Adicione o endereço de email e clique no botão Testar envio.


  7. No bloco Dados do mailing selecione o campo obrigatório Tipo de mailing: "Webservice" ou "Arquivo CSV".


    * Se "Webservice", selecione os seguintes campos obrigatórios:

       - Horário de execução: Opção já configurada com o horário do usuário.

       - WebService: Preencha com URL endpoint da API integrada a plataforma, ou utilize o botão Montar URL.


    * Ao clicar nesse botão é aberto o popup Montagem do URL para que o Administrador possa fazer a montagem e testar URL.

    É necessário preencher os campos obrigatórios: URL Base, Chave e Valor. Após o preenchimento clicar no botão Adicionar. Antes de clicar em Montar URL do popup é possível utilizar o botão Testar URL. Esse teste retorna o download de um arquivo .json com o resultado.

    É possível adicionar em URL base quantos parâmetros forem necessários, e alterar ou excluir os parâmetros já adicionados ao clicar no botão "Lixeira".


    DICA

    Se o URL necessitar de autenticação ou headers para fazer a requisição, é necessário realizar esse cadastro na tela Integração com cliente (Administração > Configurações Gerais > Integração com cliente > (botão) +Novo) e após salvar, selecioná-la no campo Integração com o cliente abaixo do campo WebService. Somente assim é possível fazer o teste com sucesso.

    Os seguintes campos são opcionais:

    - Integração com o cliente: Opção já configurada com a API do usuário.

    - Região: Opção já configurada que classifica a localidade do cliente.

    - Tipo de cliente: Opção já configurada que classifica o cliente.


    As flags "Executar Webservice mesmo com pendência" e " Cadastra cliente na execução do Webservice", podem ser habilitadas caso deseje que a campanha seja executada mesmo havendo pendência do disparo anterior, e caso deseje cadastrar clientes da lista de contato na base da plataforma.

    Os campos opcionais: "Código", "Nome", "Telefone", "Telefone 2", "Celular", "Data de nascimento", "Email" e "Url da pesquisa", podem ser preenchidos com os atributos que definem estes campos nos elementos que retornam do Webservice.


    * Se "Arquivo CSV", selecione os seguintes campos obrigatórios:

       - Horário de execução: Opção já configurada com o horário do usuário.

       - Selecione o arquivo para importação: Utilize o botão Escolher arquivo para fazer o upload do Arquivo CSV preenchido com a lista de contatos dos clientes.


    E os campos opcionais:

    - Região: Opção já configurada que classifica a localidade do cliente.

    - Tipo de cliente: Opção já configurada que classifica o cliente.


    * A flag "Executar CSV mesmo com pendência" pode ser habilitada caso deseje que a campanha seja executada mesmo havendo pendência do disparo anterior.


    DICA

    Clique no botão Download do layout no final do bloco Dados do mailing para preencher a lista de contatos do Tipo de mailing "Arquivo CSV" e realizar o upload do arquivo com o mesmo layout aceito pela plataforma. Outros tipos de planilhas eletrônicas não são válidos pela plataforma nesta configuração.


    É possível adicionar mais colunas ao "Arquivo CSV". Adicione um Grupo de Campos Extras na Ocorrência, selecione esta Ocorrência pela opção de Abertura automática de atendimento, e adicione os Campos Extras na configuração da Campanha.


  8. No bloco Dados do atendimento, escolha a ação da plataforma na execução da campanha entre uma das 02 (duas) flags abaixo:


    - Sem ação: Não são criados atendimentos.

    - Abertura automática de atendimento no envio do e-mail: São criados atendimentos após a execução da campanha.


  9. Após o passo 8, se escolheu a opção Abertura automática de atendimento no envio do e-mail, selecione os seguintes campos obrigatórios:


    - Setor: Nome já configurado para o setor responsável pelos atendimentos.

    - Responsável: Nome do Atendente responsável pelos atendimentos.

    - Tipo de ocorrência: Serviço geral já configurado para os atendimentos.

    - Ocorrência: Serviço específico já configurado para os atendimentos.

    - Solução caso o agendamento seja enviado com sucesso: Opção já configurada que classifica o envio de email com sucesso.

    - Solução caso o envio do agendamento falhe: Opção já configurada que classifica o envio de email com falha.

    - Canal de atendimento: Opção "Email".


    * O campo Status do atendimento é opcional. Escolha uma das opções padrão da plataforma.


  10. Volte ao topo da tela e marque a flag "Habilitado", abaixo do campo Tipo "Envio de email", para o Agendamento ser executado de acordo com o período configurado para os disparos.


  11. Clique no botão Salvar, no canto superior direito da tela.



]]> https://hml-docs.citrus.cx/docs/guia-do-administrador/configuracoes-de-atendimentos-gestao-de-atendimentos-10358/agendamentos-de-campanhas/envio-de-email/feed/ 0 Campanha de SMS https://hml-docs.citrus.cx/docs/guia-do-administrador/configuracoes-de-atendimentos-gestao-de-atendimentos-10358/agendamentos-de-campanhas/campanha-de-sms/ https://hml-docs.citrus.cx/docs/guia-do-administrador/configuracoes-de-atendimentos-gestao-de-atendimentos-10358/agendamentos-de-campanhas/campanha-de-sms/#respond Mon, 27 May 2024 12:57:00 +0000 https://docs.citrus.cx/docs/guia-do-administrador/configuracoes-de-atendimentos-gestao-de-atendimentos-10358/agendamento-de-campanhas/campanha-de-sms/ Atendimentos > Agendamentos > (botão) +Novo). Preencha os seguintes campos obrigatórios: – Nome: Um nome que define este agendamento de campanha. – Periodicidade: O período que a execução da campanha acontece. – Início do período de envio: Data e hora que a execução da campanha inicia. – Tipo: Selecione […]]]>
  1. Acesse a tela Agendamentos (Administração > Atendimentos > Agendamentos > (botão) +Novo).


  2. Preencha os seguintes campos obrigatórios:


    - Nome: Um nome que define este agendamento de campanha.

    - Periodicidade: O período que a execução da campanha acontece.

    - Início do período de envio: Data e hora que a execução da campanha inicia.

    - Tipo: Selecione "Campanha de SMS".


  3. A flag "Desconsiderar consentimento" (se habilitada, o envio da campanha acontece independente do consentimento configurado no cadastro do cliente), e o campo "Descrição", são opcionais.


  4. Clique no botão Salvar e continuar.


  5. No bloco Campanha de SMS preencha o campo obrigatório "Descrição" com no máximo 160 caracteres. Se desejar, utilize as Tags do quadro ao lado para substituir na mensagem os dados referentes a "Código" e/ou "Nome" do cliente.


  6. No campo abaixo do campo "Descrição", é possível testar o envio da mensagem por SMS. Adicione o número de celular e clique no botão Testar envio.


  7. No bloco Dados do mailing selecione o campo obrigatório Tipo de mailing: "Webservice" ou "Arquivo CSV".


    * Se "Webservice", selecione os seguintes campos obrigatórios:

       - Horário de execução: Opção já configurada com o horário do usuário.

       - WebService: Preencha com URL endpoint da API integrada a plataforma, ou utilize o botão Montar URL.


    * Ao clicar nesse botão é aberto o popup Montagem do URL para que o Administrador possa fazer a montagem e testar URL.

    É necessário preencher os campos obrigatórios: URL Base, Chave e Valor. Após o preenchimento clicar no botão Adicionar. Antes de clicar em Montar URL do popup é possível utilizar o botão Testar URL. Esse teste retorna o download de um arquivo .json com o resultado.

    É possível adicionar em URL base quantos parâmetros forem necessários, e alterar ou excluir os parâmetros já adicionados ao clicar no botão "Lixeira".


    DICA

    Se o URL necessitar de autenticação ou headers para fazer a requisição, é necessário realizar esse cadastro na tela Integração com cliente (Administração > Configurações Gerais > Integração com cliente > (botão) +Novo) e após salvar, selecioná-la no campo Integração com o cliente abaixo do campo WebService. Somente assim é possível fazer o teste com sucesso.

    Os seguintes campos são opcionais:

    - Integração com o cliente: Opção já configurada com a API do usuário.

    - Região: Opção já configurada que classifica a localidade do cliente.

    - Tipo de cliente: Opção já configurada que classifica o cliente.

    As flags "Executar Webservice mesmo com pendência" e " Cadastra cliente na execução do Webservice", podem ser habilitadas caso deseje que a campanha seja executada mesmo havendo pendência do disparo anterior, e caso deseje cadastrar clientes da lista de contato na base da plataforma.

    Os campos opcionais: "Código", "Nome", "Telefone", "Telefone 2", "Celular", "Data de nascimento" e "Mensagem personalizada", podem ser preenchidos com os atributos que definem estes campos nos elementos que retornam do Webservice.

    * Se "Arquivo CSV", selecione os seguintes campos obrigatórios:

       - Horário de execução: Opção já configurada com o horário do usuário.

       - Selecione o arquivo para importação: Utilize o botão Escolher arquivo para fazer o upload do Arquivo CSV preenchido com a lista de contatos dos clientes.

    E os campos opcionais:

    - Região: Opção já configurada que classifica a localidade do cliente.

    - Tipo de cliente: Opção já configurada que classifica o cliente.

    A flag "Executar CSV mesmo com pendência" pode ser habilitada caso deseje que a campanha seja executada mesmo havendo pendência do disparo anterior.


    DICA

    Clique no botão Download do layout no final do bloco Dados do mailing para preencher a lista de contatos do Tipo de mailing "Arquivo CSV" e realizar o upload do arquivo com o mesmo layout aceito pela plataforma. Outros tipos de planilhas eletrônicas não são válidos pela plataforma nesta configuração.


    É possível adicionar mais colunas ao "Arquivo CSV". Adicione um Grupo de Campos Extras na Ocorrência, selecione esta Ocorrência pela opção de Abertura automática de atendimento, e adicione os Campos Extras na configuração da Campanha.


  8. No bloco Dados do atendimento, escolha a ação da plataforma na execução da campanha entre uma das 03 (três) flags abaixo:


    - Sem ação: Não são criados atendimentos.

    - Abertura automática de atendimento na resposta do SMS: São criados atendimentos se o cliente responder à mensagem de SMS da campanha.

    - Abertura automática de atendimento no envio do SMS: São criados atendimentos após a execução da campanha.


  9. Após o passo 8, se escolheu a opção Abertura automática de atendimento na resposta do SMS, selecione os seguintes campos obrigatórios:


    - Setor: Nome já configurado para o setor responsável pelos atendimentos.

    - Responsável: Nome do Atendente responsável pelos atendimentos.

    - Tipo de ocorrência: Serviço geral já configurado para os atendimentos.

    - Ocorrência: Serviço específico já configurado para os atendimentos.

    - Canal de atendimento: Opção "SMS".


    * Os campos Solução e Status do atendimento são opcionais. Selecione uma opção já configurada para Solução caso escolha preencher o Status do atendimento com a opção padrão da plataforma: "Finalizado".


  10. Após o passo 8, se escolheu a opção Abertura automática de atendimento no envio do SMS, selecione os seguintes campos obrigatórios:


    - Setor: Nome já configurado para o setor responsável pelos atendimentos.

    - Responsável: Nome do Atendente responsável pelos atendimentos.

    - Tipo de ocorrência: Serviço geral já configurado para os atendimentos.

    - Ocorrência: Serviço específico já configurado para os atendimentos.

    - Solução caso o agendamento seja enviado com sucesso: Opção já configurada que classifica o envio de SMS com sucesso.

    - Solução caso o envio do agendamento falhe: Opção já configurada que classifica o envio de SMS com falha.

    - Canal de atendimento: Opção "SMS".


    * O campo Status do atendimento é opcional. Escolha uma das opções padrão da plataforma.


  11. Volte ao topo da tela e marque a flag "Habilitado", abaixo do campo Tipo "Campanha de SMS", para o Agendamento ser executado de acordo com o período configurado para os disparos.


  12. Clique no botão Salvar no canto superior direito da tela.



]]> https://hml-docs.citrus.cx/docs/guia-do-administrador/configuracoes-de-atendimentos-gestao-de-atendimentos-10358/agendamentos-de-campanhas/campanha-de-sms/feed/ 0