Guía de configuración
Conecta tus transacciones en minutos
Esta guía te lleva paso a paso desde tu archivo (o tu hoja de Google) hasta recibir tu primera alerta de fraude en Telegram. Elige tu camino y sigue las instrucciones.
Contenido
¿Cuál opción me conviene?Opción A: Subir CSV Manual ⚡ (5 min)Opción B: Google Sheets 🔄 (auto-sync)Referencia: tabla de columnasErrores comunes y soluciones¿Sigues atorado? Pide ayuda¿Cuál opción me conviene?
Tienes 2 caminos para conectar tus datos. Elige el que mejor se acomode a tu equipo:
| Característica | 📄 CSV Manual ⚡ | 📊 Google Sheets 🔄 |
|---|---|---|
| Esfuerzo inicial | 5 minutos | 10 minutos |
| Cuándo se analiza | Tú decides cuándo subir | Automático (escribes "sincroniza") |
| Mejor para | Empezar rápido, exportar desde tu POS | Uso continuo, equipo que ya usa Sheets |
| Compartir con socios | Mandas el archivo | Fácil (links) |
| Costo | Gratis | Gratis |
💡 Sugerencia: empieza con CSV Manual para tu primera prueba (5 minutos y recibes tu primera alerta). Cuando confirmes que funciona, gradúate a Google Sheets para automatizar.
📄 Opción A: Subir CSV Manual ⚡
A.1 — Mi CSV ya tiene los nombres correctos
Si tu archivo ya tiene fecha, id_usuario, monto_mxn:
- Arrastra el
.csval chat de Telegram - El bot procesa al instante y te dice si hay alertas
A.2 — Mi CSV tiene otros nombres: arregla encabezados
Paso 1 — Qué nombres tienen que llevar tus columnas
Mínimo (3 columnas) — ya funciona:
| Tu columna podría llamarse | Renómbrala a |
|---|---|
Fecha, Fecha de Operación, Date | fecha |
Cliente, ID Cliente, Usuario | id_usuario |
Cantidad, Monto, Amount | monto_mxn |
Recomendado (4 más) — detección 30% mejor:
| Tu columna | Renómbrala a |
|---|---|
Tipo, Tipo Operación | es_remesa |
Días Inactivo | dias_ultima_tx |
Tx Recientes, Last 7 Days | conteo_7d |
Antigüedad | antiguedad_dias |
Élite (7 más) — máxima detección:
| Tu columna | Renómbrala a |
|---|---|
País Origen | pais_origen |
País Destino | pais_destino |
ID Equipo, Device | id_dispositivo |
Cuenta Receptor | cuenta_destino |
Modalidad, Channel | canal |
Forma de Pago | metodo_pago |
KYC, Status | verificacion |
⚠️ Columnas que no estén en estas tablas — déjalas, las ignoramos. No las borres.
Paso 2 — Convierte valores con Buscar y Reemplazar
Si tu columna Tipo tiene "Remesa"/"Cambio" en lugar de TRUE/FALSE, también convierte los valores:
| Buscar | Reemplazar con |
|---|---|
Remesa | TRUE |
Cambio | FALSE |
Verificado | verificado |
Pendiente | pendiente |
No Verificado | no_verificado |
Presencial | presencial |
Online | online |
Efectivo | efectivo |
Paso 3 — Elige tu herramienta
🖥️ Excel (Windows) — Más común
- Doble clic en el archivo CSV — se abre en Excel
- Clic en A1 → escribe el nombre nuevo → Tab → repite
- Inicio → Buscar y seleccionar → Reemplazar (
Ctrl+H) para convertir valores - Archivo → Guardar como → elige
CSV (delimitado por comas) (*.csv) - Arrastra el archivo al chat de Telegram
☁️ Google Sheets
- sheets.google.com → Archivo → Importar → Subir
- Renombra encabezados (A1, B1, etc.)
- Editar → Buscar y reemplazar (
Ctrl+H) - Archivo → Descargar → Valores separados por comas (.csv)
- Arrastra el CSV descargado al chat
🐧 LibreOffice Calc
- Doble clic — se abre en LibreOffice Calc
- Renombra encabezados (A1, B1, etc.)
- Editar → Buscar y reemplazar (
Ctrl+H)
⚠️ PASO CRÍTICO en LibreOffice: Archivo → Guardar como → elige
Texto CSV (.csv) (NO .ods). Cuando pregunte "¿Usar formato CSV?", clic en ¡Usar formato CSV!📊 Opción B: Sincronización con Google Sheets 🔄
💡 Esta opción es ideal después de que ya hiciste una prueba con CSV manual. Te ahorra subir el archivo cada vez — el bot lo trae automáticamente cuando escribes "sincroniza".
B.1 — Camino más fácil: usa nuestra plantilla
- Abre sheets.new en tu navegador
- El bot te manda
confiashield_template.csv— bájalo - En tu hoja: Archivo → Importar → Subir → elige el CSV
- "Reemplazar hoja actual" → Importar datos
- Ya tienes la plantilla con los nombres correctos. Empieza a llenarla.
Salta a la sección B.3 para compartir tu hoja.
B.2 — Tengo mi propia hoja: arreglar columnas
Aplica las mismas tablas de la sección A.2 — mismo trabajo, solo que en Google Sheets en lugar de Excel. Usa Editar → Buscar y reemplazar (Ctrl+H) para los valores.
B.3 — Comparte tu hoja con ConfiaShield
- En tu hoja, clic en Compartir (arriba derecha)
- Copia este correo (no es un link, es un correo):
confiashield-sheets-reader@confiashield.iam.gserviceaccount.com
- Pégalo en el campo de "Agregar personas y grupos"
- Elige rol: Lector (NO Editor)
- Desmarca "Notificar a la gente"
- Clic en Enviar / Compartir
🔒 Privacidad: solo leemos los datos para detectar fraude. No los almacenamos a largo plazo, no los compartimos.
B.4 — Conecta la hoja al bot
- Copia la URL completa de tu hoja
- Pégala aquí en el chat de Telegram con el bot
- El bot confirma "✅ Hoja conectada"
- Cuando quieras analizar: escribe
sincroniza
✅ ¡Listo! Ya estás usando ConfiaShield con Google Sheets.
📋 Referencia: tabla de columnas
Tier 1 — Obligatorias (3)
| Columna | Tipo | Ejemplo |
|---|---|---|
fecha | Fecha/hora | 2026-05-31 14:30:00 |
id_usuario | Texto | cliente_001 |
monto_mxn | Número | 2500 |
Tier 2 — Recomendadas (4)
| Columna | Valores aceptados |
|---|---|
es_remesa | TRUE o FALSE |
dias_ultima_tx | Número (días desde la tx anterior) |
conteo_7d | Número (tx del cliente en últimos 7 días) |
antiguedad_dias | Número (días desde apertura de cuenta) |
Tier 3 — Opcionales para élite (7)
| Columna | Valores aceptados |
|---|---|
pais_origen | Código de 2 letras: US, MX, CU |
pais_destino | MX, US, etc. |
id_dispositivo | Cualquier texto |
cuenta_destino | Cualquier texto |
canal | presencial · online · telefono |
metodo_pago | efectivo · tarjeta · transferencia |
verificacion | verificado · pendiente · no_verificado |
🐛 Errores comunes y soluciones
❌ "Error: 'utf-8' codec can't decode byte..."
Guardaste como .ods o .xlsx en lugar de .csv. Vuelve a guardar eligiendo Texto CSV explícitamente.
❌ "Esperaba columna `fecha` pero no la encontré"
Verifica que la fila 1 tenga los nombres exactos en minúsculas. Revisa que no haya espacios.
❌ "Solo se detectó 1 alerta de 100 transacciones"
Probablemente solo agregaste el Tier 1. Agrega las 4 columnas Tier 2 para mejor detección.
❌ "Cobertura de datos: 30%"
Te falta cobertura. Cuantas más columnas Tier 2 y Tier 3 agregues, mejor detectamos.
❌ "El bot no responde después de mandar la URL de Sheets"
Verifica que compartiste la hoja con permisos de Lector (no Editor).
❌ "Mi POS exporta con punto y coma `;`"
Abre en Excel/Sheets/LibreOffice → guarda como CSV con delimitador de coma.
🆘 ¿Sigues atorado?
- Pregúntale al bot — escribe tu pregunta en Telegram. Si es simple, te responde; si no, escalo a un humano.
- Manda tu CSV "como está" — a veces detectamos las columnas automáticamente y si no, personalizamos la guía para tu formato.
- Soporte humano por correo: soporte@confiashield.com — respuesta en máximo 24 horas. Adjunta tu CSV o capturas si te ayuda a explicar el problema — por correo es más fácil que por Telegram.
Tienes 30 días gratis. Empieza ya.
Abrir el bot en Telegram