Solución de problemas

Empieza con un caso reproducible#

Antes de cambiar la configuración, anota:

• El espacio de trabajo/sitio, la ruta pública o el endpoint de la API, y la hora exacta con zona horaria.
• El resultado esperado y el resultado real.
• El navegador/dispositivo o el canal del proveedor externo.
• Si el fallo afecta a la vista previa del propietario, a una página de demostración alojada antigua, al widget incrustado, al conector y/o a la API.
• El texto de estado/error seguro, el x-request-id de la respuesta, el último error del conector o el ID del evento de entrega del proveedor.
• La última hora en la que funcionaba y el cambio reciente más pequeño.

No incluyas credenciales en texto plano de la API, del proveedor o del conector, secretos de webhook, datos privados de clientes, cabeceras de autorización completas ni contenido de conversaciones que no sea necesario.

Los cambios del sitio no aparecen#

1. Confirma que la URL del dashboard corresponde al sitio y al espacio de trabajo correctos.
2. Confirma que la acción de guardado indicó que se completó correctamente.
3. Las instrucciones y el conocimiento indexado se aplican a las nuevas conversaciones sin necesidad de volver a publicar. Si el propio widget está oculto, actívalo de nuevo en el menú Ponlo en marcha de la página del Agent → Widget para sitio web (o en la tarjeta En tu sitio web de la pestaña Resumen).
4. En los ajustes de Visualización (y en la insignia de marca), los cambios se guardan automáticamente y ya actualizan el widget en vivo: no hace falta volver a publicar; abre una ventana privada.
5. Abre un widget incrustado real (o un slug alojado antiguo, si aún tienes alguno) en una ventana privada.
6. Si solo la vista previa social está desactualizada, usa la caché o el depurador de esa plataforma.

Despublicar y editar son cosas distintas. Un conector de mensajería conectado puede seguir respondiendo aunque el widget esté desactivado.

La respuesta del agente es débil o incorrecta#

Haz exactamente la misma pregunta en el probador del propietario y en una conversación pública nueva. Confirma que la fuente de conocimiento relevante está indexada, contiene una respuesta explícita, está actualizada y no entra en conflicto con otra fuente. Revisa las reglas de idioma/personalidad por si hay algún límite que impida la respuesta.

Cuando la fuente no tiene respuesta, mejora el comportamiento de respaldo/escalado en lugar de indicarle al agente que adivine. Usa Fuentes de conocimiento para crear un conjunto de aceptación con preguntas directas, parafraseadas y de límites.

El lanzador del widget no aparece o está bloqueado#

Confirma que el sitio está publicado, que la incrustación está habilitada, que el script tiene el slug exacto del sitio y que el origen padre final del navegador (incluidos esquema, nombre de host y puerto) está en la lista de permitidos. En DevTools, inspecciona la solicitud de embed.js, los errores de CSP, el estado del gestor de consentimiento, la solicitud del iframe y la presencia de una única raíz data-maf-embed.

Si el texto funciona pero el micrófono no, comprueba HTTPS, el permiso del navegador, el permiso allow del iframe y la Permissions Policy del sitio anfitrión. Sigue la guía completa de Resumen de la incrustación y Seguridad y CSP.

La voz no funciona#

Separa el modo que falla: mensaje de voz, llamada en vivo o voz del conector. Que la vía de texto funcione solo demuestra que la clave del modelo de lenguaje es correcta.

Comprueba por separado las claves del proveedor de transcripción, de TTS y de tiempo real; después revisa el derecho del plan, el saldo de créditos, la asignación de minutos en vivo, el permiso del navegador y los idiomas configurados. Prueba con una grabación corta y limpia antes de investigar un archivo largo o con ruido.

El conector no recibe mensajes#

Usa la guía del canal y compara ambos lados. Confirma que el conector está habilitado, que las credenciales siguen validándose, que la URL de webhook/interacción/skill del proveedor es la actual, que el evento/Página/número/bloque necesario está suscrito, que el modo de la aplicación incluye al usuario de prueba y que la entrega por HTTPS público funciona.

Que la verificación del webhook tenga éxito no demuestra que la suscripción a eventos en tiempo de ejecución ni los permisos de salida sean correctos. Compara los registros de entrega del proveedor con Último mensaje y con el error guardado del conector. Prueba primero el texto y después la voz.

No se ofrecen dominios personalizados#

No vendemos ni asociamos dominios de customers. Coloca el agente en el sitio que ya tienes mediante la incrustación. Los eventos antiguos del complemento de dominio de Polar se ignoran o se cancelan y nunca generan credits.

Falla una solicitud a la API#

Registra el método, la ruta con versión, el estado, el código de error estable, el x-request-id de la respuesta y las cabeceras de límite de frecuencia relevantes. Después clasifica:

Usa Credenciales y tokens, Scopes y errores y Límites de frecuencia. Nunca resuelvas un error de la API moviendo una credencial de servidor al código del navegador.

La facturación o el uso parecen incorrectos#

Distingue entre acceso a la plataforma, créditos mensuales, créditos comprados, número de sitios, minutos en vivo, frecuencia de la API, canales de mensajería (Operate+) y BYOK/team members (Scale). Una recarga solo cambia los credits. Los cargos del proveedor con BYOK son independientes de la facturación de Make Agent Fast.

Ante un uso inesperado, contén la fuente probable antes de investigar: desactiva un conector, revoca una clave, elimina un origen de incrustación no deseado o detén un bucle de reintentos de la API. Conserva el intervalo de tiempo y los ID de solicitud/proveedor sin exponer secretos.

Reúne detalles seguros para el soporte#

Si sigues bloqueado, usa el control de comentarios de la guía más relevante o contacta con soporte desde el dashboard con:

• El identificador del sitio/espacio de trabajo y la función afectada.
• La marca de tiempo exacta con zona horaria y los pasos reproducibles.
• El resultado esperado frente al real.
• La URL pública sin secretos, cuando sea relevante.
• El estado HTTP, el código de error estable, el x-request-id o el ID del evento del proveedor.
• Una captura de pantalla censurada o una carga útil mínima sin secretos ni datos personales.

Indica lo que ya has comprobado. Así evitas que te repitan consejos de configuración y se delimita claramente dónde está el fallo.