Integração via SFTP e Bucket

Para operações que exigem envios recorrentes e automatizados de bases, a SoluCX disponibiliza duas formas de integração por arquivo: Bucket (armazenamento em nuvem) e SFTP (protocolo seguro de transferência). Ambas são ideais para empresas que precisam enviar bases diárias, semanais ou mensais de forma programática.

Organização do Bucket

O Bucket da SoluCX segue uma estrutura padronizada baseada na frequência de disparo das pesquisas. Essa organização garante rastreabilidade, facilita a identificação dos arquivos e mantém conformidade com a LGPD.

Estrutura de Pastas

cliente/
├── disparo_diario/
│   ├── arquivo_do_dia.csv
│   └── concluido/
│       ├── janeiro-2025/
│       ├── fevereiro-2025/
│       └── marco-2025/
├── disparo_semanal/
│   ├── arquivo_da_semana.csv
│   └── concluido/
│       ├── janeiro-2025/
│       └── fevereiro-2025/
└── disparo_mensal/
    ├── arquivo_do_mes.csv
    └── concluido/
        ├── janeiro-2025/
        └── fevereiro-2025/

Como Funciona

Acesso e Segurança

• O acesso ao Bucket é restrito à sua empresa e à equipe responsável pelo tratamento e disparo na SoluCX.
• Cada cliente possui seu próprio espaço isolado, sem visibilidade sobre dados de outros clientes.
• Todo o processo é realizado em conformidade com a Lei Geral de Proteção de Dados (LGPD).

Integração via SFTP

O SFTP (Secure File Transfer Protocol) é uma alternativa segura para o envio de bases. Ele utiliza criptografia ponta a ponta para proteger seus dados durante a transferência.

Solicitando Acesso

Se você ainda não possui acesso ao SFTP da SoluCX, siga os passos abaixo:

Passo 1: Instale um software de chaves PGP

Instale o Kleopatra (ou outro software capaz de gerar chaves PGP e descriptografar arquivos). O Kleopatra está disponível gratuitamente como parte do pacote Gpg4win.

Passo 2: Gere um par de chaves de criptografia

1. Abra o Kleopatra
2. Acesse Arquivo > Novo par de chaves OpenPGP
3. Preencha as informações solicitadas e clique em OK
4. Aguarde a geração do certificado

Passo 3: Exporte sua chave pública

1. Clique no certificado gerado
2. Clique em Exportar
3. Salve o arquivo em um local conhecido no seu computador

Passo 4: Obtenha seu endereço IP

Acesse um serviço como nordvpn.com/what-is-my-ip e copie o IP exibido.

Passo 5: Envie os dados à SoluCX

Envie um e-mail para [email protected] com:

• O arquivo da chave pública gerada no Passo 3
• O seu endereço IP obtido no Passo 4

A equipe SoluCX processará a solicitação e enviará de volta um arquivo criptografado contendo suas credenciais de acesso.

Descriptografando suas Credenciais

Ao receber o arquivo criptografado da SoluCX com suas credenciais:

1. Abra o Kleopatra
2. Clique em Descriptografar
3. Selecione o arquivo recebido da equipe de suporte
4. Exporte o arquivo descriptografado para um local seguro
5. Abra o arquivo com um editor de texto (Bloco de Notas, VS Code, etc.)
6. Você encontrará o usuário e a senha de acesso ao SFTP

Conectando ao Servidor SFTP

Com suas credenciais em mãos, configure a conexão no seu cliente SFTP:

Usando o FileZilla

1. Baixe e instale o FileZilla
2. Acesse o Gerenciador de Sites (menu Arquivo > Gerenciador de Sites ou Ctrl+S)
3. Clique em Novo Site e preencha:

4. Clique em Conectar

Validando a Conexão

Após conectar com sucesso, você verá:

• Painel de log: Mensagens de "Conectando..." e "Listagem do diretório bem-sucedida"
• Painel esquerdo: Arquivos do seu computador local
• Painel direito: Estrutura de pastas no servidor SoluCX (pastas de disparo)

Para enviar uma base, basta arrastar o arquivo CSV do painel esquerdo para a pasta de disparo correspondente no painel direito (disparo_diario/, disparo_semanal/ ou disparo_mensal/).

Usando Outros Clientes SFTP

Você pode usar qualquer cliente SFTP de sua preferência. Algumas alternativas populares:

Exemplo via Linha de Comando

# Conectar ao servidor SFTP
sftp usuario@host_fornecido_pela_solucx

# Navegar até a pasta de disparo
cd disparo_diario

# Enviar o arquivo
put base_transacoes_2025-01-15.csv

# Verificar se o arquivo foi enviado
ls

# Desconectar
exit

Formato do Arquivo CSV

Independentemente do canal de envio (Bucket ou SFTP), o arquivo CSV deve seguir o padrão de campos da plataforma SoluCX. Consulte a tela de Importador de Base na plataforma para ver os campos aceitos, obrigatoriedade, formatos e exemplo de arquivo.

Boas Práticas

• Nomeie os arquivos de forma descritiva — Use padrões como base_transacoes_2025-01-15.csv para facilitar a identificação.
• Valide os dados antes do envio — Assim como na importação via plataforma, garanta que e-mails, telefones e identificadores estejam corretos.
• Respeite a frequência contratada — Envie os arquivos de acordo com a frequência configurada (diária, semanal ou mensal).
• Monitore os disparos — Acompanhe o status dos disparos diretamente na plataforma SoluCX para garantir que as pesquisas foram enviadas corretamente.

Dúvidas Frequentes

Posso usar a mesma estrutura de Bucket para diferentes jornadas? Sim. O campo jornada no CSV direciona cada transação para a pesquisa correta, independentemente da pasta de disparo utilizada.

Preciso excluir o arquivo após o processamento? Não. Após o tratamento e disparo, os arquivos são automaticamente movidos para a pasta concluido/ correspondente ao mês.

Posso enviar mais de um arquivo por dia? Sim. Você pode enviar múltiplos arquivos na mesma pasta de disparo conforme a necessidade da sua operação.

Posso automatizar o envio via script? Sim! A integração via SFTP é totalmente compatível com automações via scripts (cron jobs, pipelines, etc.). Use a conexão por linha de comando para integrar ao seu fluxo existente.