Configurar el widget
1
Ve a la configuración del widget
En la app de Quikly, navega a Configuración → Integraciones → Instalar Widget Web.
2
Configura el agente
Establece las siguientes opciones:
- Mensaje de bienvenida — el primer mensaje que ven los visitantes cuando se abre el widget
- Tono — profesional, amigable o técnico (afecta cómo se comunica el agente)
- Dominios permitidos — lista de dominios donde el widget puede cargarse (ej.,
tuagencia.com,www.tuagencia.com)
3
Copia el script de embebido
Quikly genera un snippet con tu
publicKey único. Cópialo.4
Agrega el script a tu sitio web
Pega el snippet antes de la etiqueta de cierre
</body> en cada página donde quieras que aparezca el widget.Código de embebido
El snippet de embebido se ve así:publicKey identifica tu cuenta y carga la configuración de tu widget (saludo, tono, dominios permitidos). No se expone ninguna clave de API en código del lado del cliente.
Lista de dominios permitidos
Por seguridad, el widget solo se carga en dominios que permitas explícitamente. Si una página intenta cargar el widget desde un dominio no autorizado, el script no hace nada silenciosamente. Agrega dominios en Configuración → Integraciones → Instalar Widget Web → Dominios Permitidos. Incluye todas las variaciones que usa tu sitio:tuagencia.comwww.tuagencia.comstaging.tuagencia.com(si quieres que también esté en staging)
Qué hace el widget
Cuando un visitante abre el widget:- El agente muestra tu mensaje de bienvenida
- Pregunta sobre el proyecto, stack y cronograma del visitante
- Basándose en la conversación, califica al lead como potencial cliente
- Si califica, el agente puede generar un borrador de propuesta usando tus tarjetas de tarifas y servicios
- Recibes una notificación en Quikly con los detalles de la sesión de lead
- Tú revisas, ajustas y apruebas — nada se comparte sin tu aprobación explícita
Disponibilidad por plan
Personalización
Desde la página de configuración del widget, puedes configurar:
El widget hereda el nombre de tu empresa, servicios y tarjetas de tarifas de tu perfil de Quikly. Asegúrate de que tu perfil esté completo para que el agente tenga contexto sobre lo que ofreces.
Solución de problemas
El widget no aparece en mi sitio
El widget no aparece en mi sitio
- Verifica que el dominio esté en tu lista de dominios permitidos (incluyendo
wwwsi corresponde) - Confirma que el script esté colocado antes de
</body>y se cargue sin errores en la consola - Verifica que tu
publicKeysea correcto comparándolo con Configuración → Integraciones
El widget carga pero el agente no responde
El widget carga pero el agente no responde
- Verifica que tu suscripción de Quikly esté activa
- Confirma que te quedan conversaciones de widget para el mes (plan Starter: 10/mes)
- Busca errores de red en la consola de desarrollador del navegador
El agente da respuestas irrelevantes sobre mis servicios
El agente da respuestas irrelevantes sobre mis servicios
El agente extrae contexto de tu perfil de Quikly. Ve a Mi Perfil y asegúrate de que la descripción de tu empresa, servicios, habilidades y tarjetas de tarifas estén completos. Mientras más contexto tenga, mejor califica los leads.