Cuando algo no funciona, esta es la primera página que conviene revisar. Los síntomas están organizados según dónde los notarías: empieza por la sección que coincida con lo que estás viendo.
Primero, que no cunda el pánico. La mayoría de los problemas son de configuración, no errores. La plataforma está diseñada para que no puedas romper nada importante: pausa el despliegue, corrige el problema y reanúdalo. Incluso un problema grave rara vez cuesta más que unas pocas llamadas de prueba desperdiciadas.
Si no encuentras tu problema aquí: escribe a [email protected] indicando el ID del despliegue, el ID de la llamada (si aplica) y una descripción de lo que esperabas frente a lo que ocurrió. Incluye capturas de pantalla si es algo visual.
Llamadas de prueba
"Mi llamada de prueba nunca llegó."
| Causa probable | Qué revisar |
|---|
| Formato de número de teléfono incorrecto | Incluye el código de país. EE. UU.: +15551234567. India: +919876543210. La plataforma muestra una vista previa "formato probado: …" antes de lanzar la llamada. |
| Crédito de prueba agotado | Configuración → Plan y facturación → Uso. Las cuentas nuevas reciben $25 de crédito. |
| Número en la lista global de supresión | Configuración → Cumplimiento → Lista de No Llamar → busca tu número. |
| Rechazo del operador | Algunos operadores (sobre todo internacionales) bloquean llamadas desde números nuevos. Prueba con otro número de origen. |
| Bloqueador de spam en tu teléfono | Los filtros de spam de Apple/Google a veces bloquean sin avisar. Prueba desde otro número de origen. |
| Causa probable | Qué revisar |
|---|
| Mensaje de bienvenida configurado como definido pero el campo está vacío | Editar Finn → Mensaje de bienvenida → asegúrate de que el campo tenga texto o cámbialo a dinámico |
| Voz mal asignada | Editar Finn → Voz → vuelve a seleccionarla. Algunas voces requieren coincidencia de región. |
| Servicio LLM mal configurado (avanzado) | Editar Finn → Configuración del servicio de IA → restablecer valores predeterminados |
| Problema de permisos de micrófono del lado de Finn | Actualiza la página y vuelve a intentarlo. Si persiste, contacta con soporte. |
Crear / editar un Finn
"No puedo guardar mi Finn: el botón Guardar está atenuado."
| Causa probable | Qué revisar |
|---|
| Campo obligatorio vacío | Busca etiquetas en rojo: normalmente Nombre, Voz o Idioma. |
| Error de validación en el flujo de trabajo | Si usas la pestaña Flujo de trabajo, busca nodos con bordes rojos. |
| Sesión del navegador caducada | Actualiza la página, vuelve a iniciar sesión e inténtalo de nuevo. Tus ediciones se guardan automáticamente como borradores. |
"Mi Finn no sigue el guion que escribí."
| Causa probable | Qué corregir |
|---|
| Campo de identidad demasiado vago | Sé específico. "Eres Maya, una recepcionista amable" funciona mejor que "Eres un asistente de IA". |
| Reglas de protección enterradas bajo demasiadas instrucciones | Mueve las reglas de protección críticas a su propio campo (Estilo y reglas de protección). |
| Instrucciones contradictorias entre campos | Revisa Identidad + Estilo + Bienvenida + Flujo de trabajo en busca de contradicciones. |
| La base de conocimiento contiene información contradictoria | Abre la pestaña Conocimiento en la barra lateral del Extractor de datos para una llamada de muestra y comprueba qué se recuperó. Elimina las contradicciones de la base de conocimiento. |
| Formato libre cuando necesitas estructura | Si tienes un flujo con orden estrictamente obligatorio, usa Flujos de trabajo en su lugar. |
"El Finn habla demasiado / habla muy poco."
| Síntoma | Solución |
|---|
| Habla demasiado | Añade a las Pautas de respuesta: "Mantén las respuestas en menos de dos frases salvo que se pida más detalle." |
| Demasiado breve | Añade a las Pautas de respuesta: "Da respuestas completas con ejemplos cuando sea relevante." |
| Interrumpe a la persona que llama | Ajusta Configuración → Configuración de llamadas → Sensibilidad de interrupción (menor = más paciente) |
| Silencios largos e incómodos | Ajusta max_idle_duration a un valor menor (p. ej. 5 s en lugar de 10 s) |
"Mi Finn hace la misma pregunta dos veces."
| Causa probable | Solución |
|---|
| La respuesta de la persona que llama no coincidió con el formato esperado | Flexibiliza el analizador del nodo Ask o reformula la pregunta |
| El LLM no guardó la respuesta en memoria | Añade a las Pautas de respuesta: "Una vez respondida una pregunta, no la vuelvas a hacer." |
| Error de bucle en el flujo de trabajo | Abre el flujo de trabajo → busca una conexión que vuelva al nodo Ask |
Base de conocimiento
"Finn no responde preguntas que sé que están en los documentos."
| Causa probable | Qué comprobar |
|---|
| Documentos aún sin indexar | Pestaña Base de conocimiento → comprueba el estado. Debe indicar Indexado. Haz clic en Reindexar ahora si se queda bloqueado. |
| El documento es un PDF solo de imagen | Los PDF escaneados no pasan por OCR. Conviértelos primero a texto (por ejemplo, con Adobe o una herramienta de OCR en línea). |
| El documento es demasiado largo y la recuperación omite la sección relevante | Divide el documento en archivos más pequeños y específicos. |
| La formulación de la pregunta no coincide con la del documento | Abre la barra lateral del extractor de datos → pestaña Conocimiento de una llamada de muestra → revisa qué se recuperó. Si aparecen fragmentos incorrectos, la base de conocimiento necesita más cobertura semántica. |
| El archivo supera el límite de 25 MB | Comprímelo o divídelo. |
«Finn da respuestas desactualizadas.»
| Causa probable | Solución |
|---|
| Sigue habiendo una versión antigua del documento en la base de conocimiento | Base de conocimiento → elimina el archivo antiguo y sube el nuevo |
| La importación del sitio web tiene contenido en caché obsoleto | Base de conocimiento → Importaciones de sitios web → [URL] → Volver a rastrear ahora |
| Resultado de consulta en caché (poco frecuente) | Haz clic en Reindexar ahora para forzar la actualización |
Despliegues
«Hice clic en Lanzar, pero no sale ninguna llamada.»
| Causa probable | Qué revisar |
|---|
| Fuera de la franja horaria de llamadas | Los despliegues solo marcan dentro de la franja horaria configurada, en la hora local de quien recibe la llamada. Si lanzas a las 8 AM PT con una franja de 9 a 18, la primera llamada no saldrá hasta las 9 AM. |
| Audiencia vacía | Abre la audiencia y confirma que tiene filas. Los problemas de sincronización pueden dejarla vacía. |
| Todos los números están suprimidos | Configuración → Cumplimiento → Lista de no llamar. Si suprimiste tu lista de prueba por error, quítalos de ahí. |
| Número de origen no registrado | Los números de EE. UU. sin registro de identificador de llamada fallan de forma silenciosa. Revisa Configuración → Números de teléfono → [Número] → Estado de registro. |
| Se alcanzó el límite de gasto | Despliegues en vivo → el panel de estado mostrará «Límite alcanzado». Aumenta el límite o espera al siguiente periodo. |
| Despliegue en pausa | Despliegues en vivo → haz clic en el despliegue → revisa el estado. |
| Causa probable | Solución |
|---|
| El identificador de llamada muestra «SPAM LIKELY» | Registra el identificador de llamada. Sin registro, las operadoras de EE. UU. etiquetan tus llamadas como spam y la tasa de respuesta se desploma. |
| El mensaje de bienvenida suena a spam | Refina la apertura. "Hola, soy [nombre] y llamo de [nombre de empresa reconocible] por [motivo que esperarían]." El "por" importa: las aperturas genéricas terminan en cuelgue. |
| Llamadas a horas inadecuadas | Comprueba que se esté aplicando la franja horaria de llamada. |
| La lista es fría (sin relación previa) | Esto no es un problema de Finn, sino de la lista. Las listas frías siempre tienen tasas bajas de contestación y permanencia. |
"El despliegue está en pausa y no sé por qué."
Live Deployments → haz clic en el despliegue → baja hasta Pause Reason. Motivos habituales:
| Motivo | Qué significa |
|---|
| Límite de gasto alcanzado | Se alcanzó el límite configurado para el despliegue. Auméntalo o cierra el despliegue. |
| Audiencia agotada | Se llamó a todos los contactos (con reintentos). Completa el despliegue o añade más contactos. |
| Búfer agotado | El despachador se quedó sin trabajo momentáneamente. Suele recuperarse solo en un minuto. |
| Pausa manual | Tú o alguien del equipo pulsó Pausa. Revisa el registro de auditoría. |
| Caída del operador | Problema del proveedor de telefonía. Se reanuda cuando termine su caída. |
| Límite del plan alcanzado | Has agotado la cuota mensual de llamadas de tu plan. Mejora el plan o espera al siguiente ciclo. |
Analítica
"La analítica muestra cero llamadas, pero sé que hubo llamadas."
| Causa probable | Solución |
|---|
| Estás viendo el despliegue equivocado | Revisa el desplegable de despliegues: es fácil acabar en otro |
| Caché obsoleta | Haz clic en Actualizar (el botón aparece cuando se ve la etiqueta "Cached") |
| Las llamadas duraron menos de 5 segundos | Algunas métricas descartan las llamadas muy cortas (se tratan como no contestadas). Consulta el registro completo de llamadas. |
"Los campos del análisis posterior a la llamada están vacíos."
| Causa probable | Solución |
|---|
| Campos añadidos después de iniciar el despliegue | El análisis posterior a la llamada solo se ejecuta en las llamadas finalizadas después de añadir el campo. Las llamadas nuevas sí se rellenarán. |
| La pregunta del campo es demasiado vaga | Reformúlala. "¿Mostró interés la persona que llamó?" funciona mejor que "¿Nivel de interés?" |
| La transcripción es demasiado corta | Si una llamada duró 5 segundos, no hay nada de donde extraer. |
| Error de extracción del LLM | Poco frecuente. Consulta el Estado de extracción de la llamada en la barra lateral. |
"El sentimiento parece incorrecto en las llamadas."
El análisis de sentimiento no es perfecto. Es un indicador útil, no un veredicto. Si la clasificación falla de forma constante, añade un campo personalizado posterior a la llamada con una pregunta más específica (p. ej. "¿El interlocutor pareció satisfecho con la resolución?") y usa ese campo en su lugar.
Números de teléfono
"Compré un número pero no puedo usarlo."
| Causa probable | Qué comprobar |
|---|
| Verificación de cumplimiento pendiente | Algunos países (India, Francia, Alemania) exigen KYC. Configuración → Números de teléfono → [Número] → Estado de cumplimiento. |
| Identificador de llamada no registrado (EE. UU.) | Las llamadas salientes fallan con "carrier rejected" hasta que se registre. |
| Troncal SIP mal configurada (BYO) | Configuración → Cuenta de telefonía → prueba la troncal. Habitual: códecs incompatibles, credenciales incorrectas. |
| Número no asignado a un Finn (entrante) | Configuración → Números de teléfono → [Número] → Finn entrante predeterminado → asigna uno. |
"Las llamadas salientes fallan con 'carrier rejected'."
| Causa | Solución |
|---|
| Identificador de llamada no registrado (EE. UU./Canadá) | Configuración → Números de teléfono → [Número] → Registro de identificador de llamada |
| El país de destino exige verificación del remitente | KYC en Configuración → Números de teléfono → Cumplimiento |
| El número de origen no admite voz | Compra un número con capacidad de voz; los números solo para SMS no pueden hacer llamadas |
| El operador filtra remitentes con mala reputación | Prueba con otro número de origen; los números antiguos a veces acaban en listas negras de los operadores |
Integraciones
| Causa probable | Solución |
|---|
| Frecuencia de sincronización demasiado baja | Configuración → Integraciones → [CRM] → configúralo cada 15 minutos o cada hora |
| Token del CRM caducado | Vuelve a autorizar la integración |
| El filtro excluye los contactos nuevos | Abre el filtro de CRM de la audiencia y verifica los criterios |
| API de CRM con límite de velocidad alcanzado | Espera y reintenta. Las sincronizaciones pesadas pueden activar los límites del CRM. |
«Mi webhook no recibe eventos.»
| Causa probable | Qué comprobar |
|---|
| URL inaccesible desde internet | Usa una URL pública, no localhost. Para pruebas locales, usa un túnel (ngrok, Cloudflare Tunnel). |
| Devuelve una respuesta que no es 2xx | La plataforma espera 200-299. Un 3xx/4xx/5xx provoca un reintento. |
| El endpoint agota el tiempo de espera | Debe responder en menos de 10 s. Para lógica de larga duración, acepta el webhook rápidamente y procésalo de forma asíncrona. |
| La firma HMAC no coincide | Verifica que tu implementación de firma coincida con nuestra especificación — consulta Integraciones → Webhooks. |
«Las reservas no aparecen en mi calendario.»
| Causa probable | Solución |
|---|
| Calendario seleccionado incorrecto | Configuración → Integraciones → Calendario → revisa el calendario seleccionado |
| Permisos revocados en el proveedor de calendario | Vuelve a autorizar la integración |
| La reserva fue a un calendario que no consultas | Mucha gente tiene varios calendarios; la reserva está en alguno. Revisa la vista de «todos los calendarios». |
| Título del evento de calendario confuso | Las reservas usan por defecto «Appointment via Finn» — busca por ese texto |
Facturación
«Mi factura es más alta de lo esperado.»
Configuración → Plan y facturación → Uso → Indicadores de anomalías. Busca líneas con más del doble de tu promedio de los últimos 30 días. Causas comunes:
- Un Finn se ejecutó con una audiencia hostil y quedó atrapado en llamadas largas (configura
limit_call_duration).
- Se lanzó un despliegue sin límite de gasto y marcó a una lista mucho mayor de lo previsto.
- Se activó una voz premium o un modelo premium (Configuración → Plan).
- Se añadió un país nuevo — las tarifas de telefonía internacional pueden ser de 10 a 50 veces las de EE. UU.
«Quiero un reembolso por un despliegue desperdiciado.»
Escribe a [email protected] con el ID del despliegue y una explicación. Los problemas causados por errores del sistema suelen reembolsarse. Los errores de configuración del usuario normalmente no, pero contáctanos igualmente — se evalúa caso por caso.
Cuenta y acceso
«No puedo iniciar sesión.»
| Causa probable | Qué probar |
|---|
| Contraseña olvidada | Haz clic en "¿Olvidaste tu contraseña?" en la página de inicio de sesión |
| Cuenta bloqueada tras demasiados intentos fallidos | Espera 15 minutos y vuelve a intentarlo |
| Correo electrónico sin confirmar | Revisa la carpeta de spam por si está el correo de confirmación |
| Cuenta de equipo, pero no te han invitado | Pide a tu administrador que te invite desde Configuración → Equipo |
| El SSO no funciona | Si tu organización usa SSO, debes iniciar sesión mediante el enlace de SSO, no con correo y contraseña |
"Perdí el acceso a mi cuenta / perdí el dispositivo de 2FA."
Escribe a [email protected] con una prueba de titularidad de la cuenta (correo de facturación, últimos 4 dígitos del método de pago, etc.). Te ayudaremos a recuperar el acceso.
Rendimiento y calidad
"La latencia es demasiado alta: Finn tarda mucho en responder."
Objetivo: <800 ms entre el final del habla del usuario y el inicio de la respuesta de Finn.
| Causa | Solución |
|---|
| Voz premium seleccionada | Cambia a una voz estándar (-100-200 ms) |
| Región lejana | Configura la región de la cuenta durante el registro para que sea la más cercana a tus interlocutores |
| Problemas de red en el operador | Suele ser pasajero: espera unos minutos |
| Flujo de trabajo complejo con muchos niveles anidados | Simplifícalo; contrae los subflujos |
| Base de conocimiento grande y recuperación lenta | Configuración → Conocimiento → reindexa o reduce el tamaño de la base de conocimiento |
"Finn suena robótico / poco humano."
| Causa | Solución |
|---|
| Nivel de voz estándar | Prueba una voz premium |
| Discrepancia de idioma | Comprueba que el idioma principal de la voz coincide con el que hablas |
| Directrices de respuesta demasiado restrictivas | "Mantén las respuestas en una sola frase" hace que suene cortante. Relájalas. |
| Flujo de trabajo que impone un guion rígido | Cambia a formato libre o usa los nodos Say con menos frecuencia |
Cuando nada más funciona
- Pausa el despliegue — se detiene la marcación y no se generan más costos.
- Revisa una llamada fallida reciente — abre la barra lateral del extractor de datos para ver el contexto completo.
- Busca en esta página de solución de problemas con Ctrl+F usando palabras clave de tu error.
- Escribe a soporte — [email protected] con el ID del despliegue, el ID de la llamada y tu descripción.
- Usa el Finn de la burbuja de chat — esquina inferior derecha — está entrenado con esta documentación y suele resolver los problemas al instante.
- Para clientes Enterprise — tu CSM dedicado está en tu canal de Slack.
Siguiente
- Preguntas frecuentes → — preguntas que no son exactamente de solución de problemas.
- Cumplimiento → — cosas que fallan por motivos legales o regulatorios.
- Glosario → — definiciones de cualquier término que no reconozcas.