Configurar el widget
Ve a la configuración del widget
En la app de Quikly, navega a Configuración → Integraciones → Instalar Widget Web.
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)
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
| Plan | Widgets | Conversaciones |
|---|---|---|
| Starter | 1 widget | 10 por mes |
| Professional | 1 widget | Ilimitadas |
| Agency | Hasta 3 widgets | Ilimitadas |
| Lifetime | 1 widget | Ilimitadas |
Personalización
Desde la página de configuración del widget, puedes configurar:| Ajuste | Descripción |
|---|---|
| Mensaje de bienvenida | El mensaje inicial que el agente muestra a los visitantes |
| Tono | Estilo de comunicación: profesional, amigable o técnico |
| Dominios permitidos | Dominios donde el widget tiene permiso para cargarse |
| Idioma | Idioma principal del agente (inglés o español) |
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.