Documentación

Restricciones de dominio

Controla qué sitios web pueden incrustar el widget de tu agente.

Las restricciones de dominio limitan dónde se puede incrustar el widget de tu agente. Cuando están configuradas, el widget solo se carga en los dominios aprobados, lo que evita el uso no autorizado en otros sitios web.

Configurar las restricciones de dominio

  1. Ve a la pestaña Configuración de tu agente
  2. Haz clic en Seguridad
  3. Busca Dominios permitidos
  4. Activa la restricción
  5. Agrega tu(s) dominio(s)
  6. Guarda los cambios

Agregar dominios

Ingresa orígenes completos, incluido el protocolo. La validación de dominio realiza una coincidencia exacta de origen (protocolo + nombre de host + puerto):

  • https://example.com: coincide solo con https://example.com (NO con https://www.example.com)
  • https://www.example.com: coincide solo con https://www.example.com
  • https://*.example.com: coincide con cualquier subdominio (por ejemplo, https://app.example.com, https://www.example.com), pero NO con el dominio raíz

Ejemplos

EntradaCoincide conNo coincide con
https://mysite.comhttps://mysite.comhttps://www.mysite.com, https://app.mysite.com
https://www.mysite.comhttps://www.mysite.comhttps://mysite.com, https://app.mysite.com
https://*.mysite.comhttps://app.mysite.com, https://www.mysite.comhttps://mysite.com (dominio raíz)

Importante: para cubrir tanto el dominio raíz como el www, agrega ambas entradas:

https://mysite.com
https://www.mysite.com

Qué ocurre en dominios no autorizados

Cuando alguien intenta cargar tu widget desde un origen no aprobado, la API de chat devuelve una respuesta 403 Domain not allowed y el widget no podrá iniciar una conversación.

Tu agente y tus mensajes permanecen seguros.

Desarrollo y pruebas

Para el desarrollo local, agrega el origen completo, incluido el puerto:

  • http://localhost:3000
  • http://127.0.0.1:3000

Recuerda eliminarlos antes de pasar a producción, o usa agentes distintos para desarrollo y producción.

Varios dominios

Agrega todos los orígenes donde deba aparecer tu agente:

https://mysite.com
https://www.mysite.com
https://app.mysite.com
https://help.mysite.com

No hay límite en la cantidad de dominios permitidos.

Desactiva las restricciones

Para permitir la incrustación en cualquier dominio:

  1. Ve a Configuración > Seguridad
  2. Desactiva Dominios permitidos
  3. Guarda los cambios

Cuando el interruptor está desactivado, el widget se puede incrustar en cualquier lugar.

Casos de uso comunes

Un solo sitio de marketing

https://mycompany.com
https://www.mycompany.com

Varias propiedades

https://mainsite.com
https://blog.mainsite.com
https://shop.mainsite.com
https://support.mainsite.com

Desarrollo y producción

Crea agentes distintos:

  • Agente de producción: solo dominios de producción
  • Agente de desarrollo: localhost, dominios de staging

Solución de problemas

El widget no carga en mi sitio

  • Verifica que el origen esté en la lista permitida
  • Revisa que no haya errores tipográficos (https://mysite.com frente a https://www.mysite.com)
  • Asegúrate de que cada entrada incluya el protocolo (https:// o http://) y coincida con el puerto que usa el navegador
  • Borra la caché del navegador e inténtalo de nuevo

El widget carga en sitios no autorizados

  • Verifica que las restricciones de dominio estén guardadas
  • Comprueba si el comodín es demasiado amplio
  • Haz la prueba en una ventana privada o de incógnito

Próximos pasos