Solución de problemas

Guía rápida para resolver los tropiezos más comunes. Está organizada por área.

Acceso y cuenta

No puedo iniciar sesión

• Verifica correo y contraseña. Si un ADMIN acaba de crear tu cuenta, usa la contraseña temporal que te dio.
• Si sale "sesión expirada", es normal tras inactividad: vuelve a entrar.
• Si sigue fallando, pide a un ADMIN que restablezca tu contraseña o revise que tu cuenta esté Activa.

No veo una sección del menú

• El menú depende de tu rol. Secciones como Usuarios, Grupos, Configuración y Eventos son solo ADMIN. Pide a un administrador que ajuste tu rol si lo necesitas.

Encuestas

No aparece el botón "Nueva encuesta"

• Necesitas rol ADMIN o EDITOR. Un VIEWER no puede crear.

No puedo avanzar en el asistente

• Paso 1: el título debe tener al menos 3 caracteres y haber un slug.
• Paso 2: cada pregunta necesita al menos 2 opciones con texto.

Subí una imagen y falló

• Usa formato JPG, PNG o WebP. Si falla, reintenta; si persiste, prueba una imagen más ligera.

Cerré una encuesta por error

• Cerrar es irreversible desde la interfaz. Para casos excepcionales, contacta al equipo técnico.

Votación (reportes de votantes)

"Ya votaste en esta encuesta"

• Es el anti-duplicado funcionando: esa persona/dispositivo/cuenta ya emitió su voto.

Así se ve el aviso cuando alguien intenta repetir su voto desde el mismo dispositivo.

No llega el correo del magic link

• Revisa spam. El enlace caduca en 20 minutos; pide otro si expiró.
• Como operador: confirma que el SMTP esté configurado y activo (ver abajo).

El login de Facebook no abre (en embed)

• Hay que permitir ventanas emergentes en el sitio donde está incrustada.

"Votación cerrada"

• La encuesta ya terminó. Solo se pueden ver resultados.

Canales y envíos

"Configura el canal primero" / "CHANNEL_NOT_CONFIGURED"

• El canal (WhatsApp/Facebook/Correo) no está conectado. Ve a Configuración y complétalo.

El correo de prueba falla con "525 5.7.1 Unauthorized IP address"

• Tu proveedor (ej. Brevo) restringe por IP. Agrega la IP del servidor de Voxly a las IPs autorizadas del proveedor, o desactiva esa restricción.

No puedo enviar por WhatsApp

• Requiere Twilio configurado y una plantilla aprobada (Content SID HX...). Revisa la configuración de WhatsApp.

No tengo listas para enviar

• Crea contactos y una lista en Audiencia antes de enviar por WhatsApp/correo.

Inteligencia Artificial

La IA no responde

El Analista IA no contesta o muestra error de cuota

• Puede ser un límite temporal del proveedor de IA: espera un momento y reintenta.
• Si persiste, el equipo técnico debe revisar la configuración del proveedor de IA en el servidor.

El chat "no encuentra" mis datos

• El Analista usa una llave MCP. Si alguien la revocó, el chat pierde acceso. Un ADMIN puede recrearla en API · MCP. (La generación de encuestas con IA no se ve afectada por esto.)

Seguridad / anti-fraude

Sospecho intentos de inflar votos

• Usa modo Facebook o Correo (no anónimo).
• Deja Turnstile activado con llaves reales.
• En Configuración → Seguridad anti-bot, sube las protecciones (tiempo mínimo de sesión, tope por subred, bloqueo de IPs de datacenter).
• Revisa Eventos para ver votos rechazados en vivo.

Turnstile no protege

• Probablemente están las llaves de prueba de Cloudflare (siempre pasan). Cámbialas por tus llaves reales en Configuración.

¿Sigo atorado?

Si el problema es técnico (servidor, despliegue, configuración de proveedores), contacta al equipo técnico de Voxly con:

• Qué intentabas hacer.
• El mensaje de error exacto (captura de pantalla).
• La encuesta involucrada y la hora aproximada.