Integración vía SFTP y Bucket

Para operaciones que requieren envíos recurrentes y automatizados de bases, SoluCX ofrece dos formas de integración por archivo: Bucket (almacenamiento en la nube) y SFTP (protocolo seguro de transferencia). Ambas son ideales para empresas que necesitan enviar bases diarias, semanales o mensuales de forma programática.

Organización del Bucket

El Bucket de SoluCX sigue una estructura estandarizada basada en la frecuencia de disparo de las encuestas. Esta organización garantiza trazabilidad, facilita la identificación de archivos y mantiene conformidad con la LGPD.

Estructura de Carpetas

cliente/
├── disparo_diario/
│   ├── archivo_del_dia.csv
│   └── concluido/
│       ├── enero-2025/
│       ├── febrero-2025/
│       └── marzo-2025/
├── disparo_semanal/
│   ├── archivo_de_la_semana.csv
│   └── concluido/
│       ├── enero-2025/
│       └── febrero-2025/
└── disparo_mensal/
    ├── archivo_del_mes.csv
    └── concluido/
        ├── enero-2025/
        └── febrero-2025/

Cómo Funciona

Acceso y Seguridad

• El acceso al Bucket está restringido a su empresa y al equipo responsable del tratamiento y disparo en SoluCX.
• Cada cliente posee su propio espacio aislado, sin visibilidad sobre datos de otros clientes.
• Todo el proceso se realiza en conformidad con la LGPD (Ley General de Protección de Datos de Brasil) y las mejores prácticas de protección de datos.

Integración vía SFTP

El SFTP (Secure File Transfer Protocol) es una alternativa segura para el envío de bases. Utiliza cifrado de extremo a extremo para proteger sus datos durante la transferencia.

Solicitando Acceso

Si aún no tiene acceso al SFTP de SoluCX, siga los pasos a continuación:

Paso 1: Instale un software de claves PGP

Instale Kleopatra (u otro software capaz de generar claves PGP y descifrar archivos). Kleopatra está disponible gratuitamente como parte del paquete Gpg4win.

Paso 2: Genere un par de claves de cifrado

1. Abra Kleopatra
2. Acceda a Archivo > Nuevo par de claves OpenPGP
3. Complete la información solicitada y haga clic en OK
4. Espere la generación del certificado

Paso 3: Exporte su clave pública

1. Haga clic en el certificado generado
2. Haga clic en Exportar
3. Guarde el archivo en una ubicación conocida en su computadora

Paso 4: Obtenga su dirección IP

Acceda a un servicio como nordvpn.com/what-is-my-ip y copie la IP mostrada.

Paso 5: Envíe los datos a SoluCX

Envíe un correo electrónico a [email protected] con:

• El archivo de clave pública generado en el Paso 3
• Su dirección IP obtenida en el Paso 4

El equipo de SoluCX procesará la solicitud y le enviará un archivo cifrado con sus credenciales de acceso.

Descifrando sus Credenciales

Al recibir el archivo cifrado de SoluCX con sus credenciales:

1. Abra Kleopatra
2. Haga clic en Descifrar
3. Seleccione el archivo recibido del equipo de soporte
4. Exporte el archivo descifrado a una ubicación segura
5. Abra el archivo con un editor de texto (Bloc de notas, VS Code, etc.)
6. Encontrará el usuario y la contraseña de acceso al SFTP

Conectando al Servidor SFTP

Con sus credenciales listas, configure la conexión en su cliente SFTP:

Usando FileZilla

1. Descargue e instale FileZilla
2. Acceda al Gestor de Sitios (menú Archivo > Gestor de Sitios o Ctrl+S)
3. Haga clic en Nuevo Sitio y complete:

4. Haga clic en Conectar

Validando la Conexión

Después de conectar exitosamente, verá:

• Panel de log: Mensajes como "Conectando..." y "Listado del directorio exitoso"
• Panel izquierdo: Archivos de su computadora local
• Panel derecho: Estructura de carpetas en el servidor SoluCX (carpetas de disparo)

Para enviar una base, simplemente arrastre el archivo CSV del panel izquierdo a la carpeta de disparo correspondiente en el panel derecho (disparo_diario/, disparo_semanal/ o disparo_mensal/).

Usando Otros Clientes SFTP

Puede usar cualquier cliente SFTP de su preferencia. Algunas alternativas populares:

Ejemplo vía Línea de Comando

# Conectar al servidor SFTP
sftp usuario@host_proporcionado_por_solucx

# Navegar a la carpeta de disparo
cd disparo_diario

# Enviar el archivo
put base_transacciones_2025-01-15.csv

# Verificar si el archivo fue enviado
ls

# Desconectar
exit

Formato del Archivo CSV

Independientemente del canal de envío (Bucket o SFTP), el archivo CSV debe seguir el estándar de campos de la plataforma SoluCX. Consulte la pantalla de Importador de Base en la plataforma para ver los campos aceptados, obligatoriedad, formatos y ejemplo de archivo.

Buenas Prácticas

• Nombre los archivos de forma descriptiva — Use patrones como base_transacciones_2025-01-15.csv para facilitar la identificación.
• Valide los datos antes del envío — Al igual que con la importación vía plataforma, asegúrese de que los correos electrónicos, teléfonos e identificadores sean correctos.
• Respete la frecuencia contratada — Envíe los archivos de acuerdo con la frecuencia configurada (diaria, semanal o mensual).
• Monitoree los disparos — Siga el estado de los disparos directamente en la plataforma SoluCX para garantizar que las encuestas se enviaron correctamente.

Preguntas Frecuentes

¿Puedo usar la misma estructura de Bucket para diferentes recorridos? Sí. El campo jornada en el CSV dirige cada transacción a la encuesta correcta, independientemente de la carpeta de disparo utilizada.

¿Necesito eliminar el archivo después del procesamiento? No. Después del tratamiento y disparo, los archivos se mueven automáticamente a la subcarpeta mensual correspondiente dentro de concluido/.

¿Puedo enviar más de un archivo por día? Sí. Puede enviar múltiples archivos en la misma carpeta de disparo según la necesidad de su operación.

¿Puedo automatizar el envío vía script? ¡Sí! La integración vía SFTP es totalmente compatible con automatizaciones vía scripts (cron jobs, pipelines, etc.). Use la conexión por línea de comando para integrar a su flujo existente.