Importador de Base (CSV)

A funcionalidade de Importador de Base permite que você envie arquivos CSV diretamente pela plataforma SoluCX para disparar pesquisas de satisfação em lote. Todo o processo é self-service — você tem autonomia total para configurar, validar e enviar suas bases sem depender de intermediários.

Como Funciona

O fluxo de importação segue quatro etapas simples:

  1. Upload — Envie o arquivo CSV pela plataforma
  2. Validação — O sistema verifica automaticamente a estrutura e os dados do arquivo
  3. Ajustes — Revise e corrija eventuais inconsistências apontadas pela validação
  4. Disparo — Confirme o envio e as pesquisas serão disparadas automaticamente

Preparando o Arquivo CSV

O arquivo deve estar no formato CSV (valores separados por ponto e vírgula ;) com codificação UTF-8. Cada linha representa uma transação (interação do cliente com a sua empresa) que poderá gerar uma pesquisa.

De forma geral, o CSV precisa conter informações sobre:

  • Transação — Identificador único e data da experiência
  • Unidade — Identificação da unidade (loja, clínica, agência, filial) onde a experiência ocorreu
  • Colaborador — Identificação do profissional vinculado ao atendimento (quando aplicável)
  • Cliente — Nome, identificador e canal de contato (e-mail, telefone) do cliente
  • Jornada — Slug da jornada configurada na plataforma, que direciona ao modelo de pesquisa correto
  • Colunas extras — Campos personalizados (ex: param_numeroPedido, param_canalAtendimento) que ficam disponíveis no extrato e podem aparecer nos templates de e-mail

Passo a Passo: Importando uma Base

1. Acesse o Importador de Base

Na plataforma SoluCX, navegue até a seção de Importador de Base no menu lateral.

2. Envie o Arquivo

Arraste o arquivo CSV ou clique para selecionar o arquivo do seu computador. O sistema aceita arquivos no formato .csv.

3. Aguarde a Validação

Após o upload, o sistema verificará automaticamente:

  • Se a estrutura do arquivo está correta
  • Se os campos obrigatórios estão preenchidos
  • Se os formatos dos dados estão válidos (e-mail, telefone, datas)
  • Se há registros duplicados

4. Revise e Ajuste (Limpeza da Base)

Se a validação apontar inconsistências, o sistema exibirá os alertas por registro. Para cada alerta, você pode escolher uma das três ações de limpeza:

  • Ignorar Linha — Mantém a linha exatamente como está, ignorando o alerta. A linha será disparada normalmente.
  • Remover Linha — Remove a linha inteira da base. Essa linha não será disparada.
  • Remover Informação — Mantém a linha na base, mas remove apenas o campo que gerou o alerta. A linha será disparada sem essa informação.

5. Confirme o Disparo

Após a validação bem-sucedida, confirme o envio. As pesquisas serão programadas de acordo com as regras da jornada configurada (imediatamente, após X dias, etc.).


Boas Práticas

  • Consulte a plataforma antes de montar o arquivo — A tela de Importador de Base é a referência mais atualizada para campos, formatos e obrigatoriedade.
  • Verifique os dados antes do envio — Garanta que e-mails e telefones estejam no formato correto para evitar erros de validação.
  • Use identificadores únicos — Identificadores de transação evitam que a mesma experiência gere pesquisas duplicadas.
  • Mantenha a consistência — Use os mesmos identificadores de unidade e colaborador em todas as bases para garantir relatórios consistentes.
  • Aproveite os campos personalizados — Quanto mais dados você enviar nas colunas extras, mais rica será sua análise na plataforma.
  • Codificação UTF-8 — Salve o arquivo com codificação UTF-8 para evitar problemas com caracteres especiais e acentos.

Dúvidas Frequentes

Posso enviar bases com frequência diária? Sim! Você pode importar bases quantas vezes precisar. Para envios recorrentes e automatizados, considere as opções de integração via SFTP ou Bucket.

O que acontece se um registro tiver erro? O sistema identifica os registros com problemas e oferece três opções de limpeza: Ignorar Linha (manter e disparar como está), Remover Linha (não disparar) ou Remover Informação (disparar sem o campo com problema). Veja a seção "Revise e Ajuste" acima para detalhes.