# Widget de soporte para tu web

Pon un botón de ayuda en tu web o comparte tu página de soporte, sin programar: cada mensaje te llega como un ticket y la respuesta sale por correo.

Con el widget de soporte, tus clientes te escriben desde tu web sin cuenta ni contraseña: un botón en una esquina abre un formulario con su nombre, su correo y su mensaje. Si no puedes tocar tu web, compartes el enlace de tu página de soporte, que lleva el mismo formulario. Cada mensaje entra en [Tickets de soporte](https://os.utilia.ai/docs/guides/support-tickets/overview) como un ticket «De tu web» y la respuesta de tu equipo le llega a esa persona por correo. No hay que programar nada.

## Antes de empezar

- **Tu plan** tiene que incluir el aplicativo Tickets de soporte con «Tickets propios». Los adjuntos no necesitan el Gestor de archivos.
- **El permiso «Configurar el widget de soporte»**. De serie lo tiene el Super Administrador, y quien administra los permisos puede dárselo a otras personas. Sin él, la pantalla no se abre.

Contestar lo que llega es otra tarea, con otros permisos: la cuenta [Contestar las solicitudes de tu web](https://os.utilia.ai/docs/guides/support-tickets/web-requests).

## Dónde está

Ve a **Ajustes › Tickets de soporte**. También llegas desde la tienda de aplicaciones: en **Ajustes › Aplicaciones › Explorar**, la ficha **Widget de soporte** te trae aquí con **Configurar**. Lo que cambias se guarda solo, al momento.

**Ajustes · Tickets de soporte**

1. En el menú de Ajustes, dentro de Aplicativos: Tickets de soporte.
2. Mostrar en tu web: enciende o apaga a la vez el botón de tu web y tu página de soporte.
3. Si ya se ha visto funcionando y en qué web, y cuántas solicitudes han llegado en los últimos 30 días; pulsa la fila para verlas.

_Con el widget apagado solo ves cómo saldrá y el botón «Activar el widget»._

El orden de la pantalla sigue a lo que toca hacer:

- **Mientras el widget no se ha visto en ninguna web**, justo debajo del estado va **Ponlo en tu web**, con tus dos caminos abiertos; después **Opciones**, **Aspecto** y **Dónde puede aparecer**.
- **En cuanto funciona**, suben **Opciones** y **Aspecto**, que es lo que se retoca, y **En tu web** baja con la línea plegada. El enlace de tu página de soporte sigue a la vista, para compartirlo cuando quieras.

En el teléfono, la barra de arriba dice «Tickets de soporte» y debajo si está activado. Sus acciones van en el menú **…**: ver las solicitudes, la versión para desarrolladores y cambiar la clave.

## Qué ve quien te escribe

**Dos formas de que te escriban**

### El botón en tu web (Pegas una línea)

Un botón flotante en la esquina que elijas, en todas las páginas de tu web. Al pulsarlo se abre el formulario sin salir de la página.

### Tu página de soporte (Sin tocar tu web)

Una página con la marca de tu empresa y el mismo formulario. Compartes su enlace o lo pones en el menú de tu web.

Puedes usar las dos a la vez. El formulario es el mismo en las dos:

- **Nombre**, **Correo** y **Mensaje**, de al menos 10 caracteres. No hay categoría ni prioridad que elegir.
- **Dictar** y **Ayúdame a redactarlo**, bajo el mensaje, si tienes puesta la [asistencia con IA](#asistencia-con-ia), con la línea «Opcional. Usa IA con lo que escribas, dictes o adjuntes.».
- **Adjuntar archivos**, si lo permites.
- Una línea de privacidad con el nombre de tu empresa: «Acme tratará tus datos para atender tu solicitud.». Con la [asistencia con IA](#asistencia-con-ia) puesta, dice también para qué sirven si se usa la ayuda: «Acme tratará tus datos para atender tu solicitud y, si usas la ayuda con IA, para preparar tu mensaje.». Si tienes puesta tu política de privacidad en [Ajustes › Organización › Contacto](https://os.utilia.ai/docs/guides/organization/contact), la enlaza. Si no, la pantalla del widget te avisa: «Tu widget no enlaza ninguna política de privacidad.», con **Añádela en Organización › Contacto**.
- **¿Ya eres cliente? Entra en tu portal**, si lo ofreces.
- **Enviar**.

Al enviar, la persona ve **Mensaje enviado**, «Te contestaremos por correo a» su dirección y su **Número de solicitud** (por ejemplo, TKT-ACME-12). Para quien escribe es una solicitud; para tu equipo, un ticket. En el teléfono, el formulario ocupa toda la pantalla; en el ordenador, es una ventana junto al botón. Sigue el modo claro u oscuro del aparato.

Quien escribe no ve ahí sus mensajes anteriores ni las respuestas: le llegan por correo, con un enlace a la conversación. Así, aunque alguien escriba con el correo de otra persona, lo que contesta tu equipo solo lo lee quien tiene ese buzón.

## Activar el widget

1. **Abre la pantalla**

   En **Ajustes › Tickets de soporte**. Apagado, el bloque **Widget de soporte** te enseña cómo saldrá en tu web: con el color de tu marca, abajo a la derecha y el botón «Ayuda».
2. **Pulsa Activar el widget**

   Aparecen los demás bloques: el enlace de tu página de soporte, la línea para tu web y los ajustes.
3. **Ponlo donde te vean**

   Comparte tu página de soporte, pega la línea en tu web o haz las dos cosas. Si tu web la lleva otra persona, mándale las instrucciones.
4. **Comprueba que funciona**

   En cuanto alguien abre una página de tu web con la línea pegada, el bloque dice «Funcionando en» y el nombre de tu web. Si acabas de pegarla, abre tu web y vuelve a cargar la pantalla.

Si no se ha visto en ninguna web, dice «Aún no lo hemos visto en ninguna web»; si lleva más de un día sin verse, «Visto por última vez en» y cuándo. Tu página de soporte no cuenta.

Si apagas **Activado**, el botón deja de salir en tu web y tu página de soporte dice que no está disponible. El aviso que sale al apagarlo trae **Deshacer**. Las conversaciones en marcha siguen: quien ya te escribió puede leer y contestar desde sus correos.

## Tu página de soporte

En **Ponlo en tu web** (o **En tu web**, cuando ya funciona), **Tu página de soporte** tiene su enlace, con **Copiar** y **Abrir**, y **Compartir el enlace** si tu aparato tiene hoja de compartir. No hace falta tocar código: ponlo en el menú de tu web («Ayuda» o «Contacto»), en la firma de tu correo o en tus redes. Al compartirlo, la vista previa dice «Soporte de» y el nombre de tu empresa.

La página lleva el logotipo o el nombre de tu empresa, el título que elijas en **Aspecto**, el mismo formulario que el botón y, al pie, el sello «Soporte con» de UTILIA OS. Funciona aunque limites el botón a unas webs en [Dónde puede aparecer](#dónde-puede-aparecer).

## Pegar la línea en tu web

Despliega **Pegar el botón en tu web**, pulsa **Copiar la línea** y pégala una sola vez en la plantilla común de tu web, al final de la página: el botón saldrá en todas sus páginas. Mientras no se haya visto funcionando, ese es el botón que destaca en el ordenador, porque es lo siguiente que toca; en el teléfono destaca **Compartir el enlace**. En cuanto funciona, la línea se queda plegada, y la pantalla recuerda si la abres o la pliegas.

Debajo, **Cómo pegarlo** despliega los pasos para cada tipo de web, y la próxima vez se abre en la que elegiste. Son estos:

### WordPress

1. En el escritorio de WordPress, instala un plugin para añadir código a todas las páginas, como WPCode.
2. Abre «Code Snippets › Header & Footer» y pega la línea en el cuadro del pie («Footer»).
3. Guarda los cambios.

### Wix

1. En el panel de tu sitio, abre «Configuración» y, en «Avanzado», «Código personalizado».
2. Pulsa «Añadir código personalizado», pega la línea, elige «Todas las páginas» y colócala al final del «Body».
3. Aplica los cambios.

Wix solo deja añadir código con un plan Premium y un dominio propio.

### Shopify

1. En «Tienda online › Temas», abre el menú del tema que usas y elige «Editar código».
2. Abre el archivo theme.liquid y pega la línea justo antes de `</body>`.
3. Guarda.

### Squarespace

1. En el panel de tu sitio, busca «Inyección de código» y ábrelo.
2. Pega la línea en el cuadro del pie de página y guarda.

Squarespace solo deja inyectar código desde el plan Core.

### Webflow

1. En tu proyecto, abre «Site settings › Custom code».
2. Pega la línea en «Footer code» y guarda.
3. Publica el sitio.

Webflow solo publica el código propio con un plan de sitio de pago. Su panel está en inglés, así que los menús van como allí se leen.

### Otra web

1. Pega la línea justo antes de `</body>` en la plantilla común de tu web, para que salga en todas sus páginas.
2. Si no puedes tocar el código, manda las instrucciones a quien lleva tu web o comparte tu página de soporte.

## Mandar las instrucciones

Si tu web la lleva otra persona, pulsa **Mandar las instrucciones a quien lleva tu web**. Escribe el **Correo de quien lleva tu web** y, si quieres, una **Nota (opcional)** de hasta 500 caracteres, como «Ponlo en todas las páginas menos en la tienda», y pulsa **Mandar**.

Le llega un correo en nombre de tu empresa, «Cómo poner el widget de soporte de» y el nombre de tu empresa, con la línea, los pasos para cada tipo de web, el enlace de tu página de soporte por si prefiere enlazarla y **Ver la guía**, que abre esta página. Tu empresa puede mandarlas hasta diez veces al día.

## Aspecto

En **Aspecto** decides cómo se ve. La vista previa del botón y del formulario abierto cambia al momento, y con **Claro** y **Oscuro** compruebas los dos modos.

- **Color**: el de tu marca (el **Color principal** de [Logo y colores de tu empresa](https://os.utilia.ai/docs/guides/organization/brand#elegir-los-colores)) o, si no lo tienes, el de serie; una de las muestras (Azul, Grafito, Verde azulado, Violeta, Granate o Naranja), u **Otro color**. El texto del botón se pone blanco o casi negro según el color, para que siempre se lea.
- **Esquina**: **Abajo a la derecha** o **Abajo a la izquierda**.
- **Texto del botón**: hasta 30 caracteres. De serie, «Ayuda».
- **Título del panel**: hasta 80 caracteres. De serie, «¿En qué podemos ayudarte?». Es también el título de tu página de soporte.

## Opciones

En **Opciones** está lo que ve quien te escribe y cómo le contestas, en este orden: adjuntos, asistencia con IA, entrada al portal y firma.

### Adjuntos

**Dejar adjuntar archivos** viene encendido: quien escribe puede añadir hasta 5 archivos de 10 MB cada uno, imágenes, PDF o texto. Cada archivo se comprueba por dentro, no solo por su extensión, pasa por el antivirus y queda como adjunto del ticket. Si uno falla, el mensaje llega igual y se le dice cuál no se adjuntó. Tu empresa recibe como mucho 300 archivos al día, sumando el widget, la página de soporte y las respuestas; pasado el tope, se puede escribir sin adjuntos. Apagado, el formulario no ofrece adjuntar, y quien escribió tampoco puede adjuntar al contestar desde sus correos.

### Asistencia con IA

Con **Asistencia con IA** encendida, bajo el mensaje salen dos botones para quien te escribe, en el botón de tu web y en tu página de soporte: **Dictar**, que pasa a texto lo que dice al micrófono, y **Ayúdame a redactarlo**, que le propone un mensaje más claro. Si dejas adjuntar archivos, la ayuda tiene en cuenta también las imágenes y los PDF que adjunte. Viene apagada.

- **Lo que propone.** Un mensaje en primera persona y en el idioma en que te escriben, que empieza por una frase con el asunto (será el título del ticket) y recoge lo que se ve en los adjuntos. Si falta un dato que tu equipo va a necesitar, lo pide en una última línea entre corchetes, como «\[Si lo tienes, añade el número de factura]». La propuesta sustituye a lo escrito y deja **Deshacer** a mano: la persona la revisa, la retoca y la envía ella. La IA nunca envía nada, no toca su nombre ni su correo y no elige el tipo ni la prioridad del ticket. Solo sirve para redactar una solicitud: si le piden otra cosa, no la hace.
- **Lo que gasta.** Cada dictado y cada ayuda sale de la bolsa de IA de tu empresa, la misma que usa tu equipo, y se ve en **Ajustes › Uso**. Si puedes ver la organización, **Ver el uso de IA**, en la propia fila, te lleva allí, y al volver la pantalla te deja en ella. Lo que se pague con saldo adicional sale en Uso con su propio nombre, «Ayuda para redactar del widget de soporte» y «Dictado del widget de soporte», para que sepas cuánto gasta tu web.
- **Su propio límite.** Justo debajo de **Asistencia con IA** está **Límite de IA del widget**, el mismo que tienen las aplicaciones conectadas: la parte de la bolsa de IA del plan que puede gastar tu widget en cada ciclo de facturación, del 1 al 100 %. Viene **Sin límite**, y entonces puede usar toda la bolsa y el saldo adicional. Eliges 10, 25 o 50 %, u **Otro…** para escribir el tuyo, y se guarda al momento; para quitarlo eliges **Sin límite**, con **Deshacer** en el aviso. La fila dice también cuánto de la bolsa lleva usado tu widget este ciclo («Este ciclo ha usado el 3 % de la bolsa de IA del plan.») y, con un límite puesto, cuándo se renueva. Al llegar a él, el widget deja de ofrecer **Dictar** y **Ayúdame a redactarlo** hasta el ciclo siguiente y sigue funcionando sin ellos; la fila de la asistencia dice «Tu widget ha llegado a su límite de IA…» con **Subir el límite**, que abre el límite ahí mismo, y te llega un aviso, que puedes apagar en [Mi perfil › Avisos](https://os.utilia.ai/dashboard/profile?tab=notifications), grupo **Tickets de soporte**, aviso **Límite de IA del widget de soporte**. Para cambiarlo hace falta también el permiso «Ver organización», el mismo que deja ver el uso de la bolsa, y se puede cambiar hasta 10 veces por ciclo. Si este ciclo tu empresa no tiene bolsa de IA, la fila no sale: lo que gasta tu widget lo frena entonces el límite de gasto por ciclo de tu saldo.
- **Los topes.** Cada grabación dura como mucho 2 minutos. La ayuda lee hasta 5 archivos, de 10 MB cada uno y 20 MB entre todos. Desde una misma conexión a internet se pueden pedir 10 ayudas y 10 dictados por hora, y 20 de cada al día. Tu widget admite 200 usos al día entre los dos, y la fila dice cuántos van («Hoy: 37 de 200 usos»). Pasado un tope, quien escribe lee «Ya has usado la ayuda con IA varias veces. Puedes enviar tu mensaje tal cual.» y sigue sin ella.
- **Si se acaba la IA.** Si la IA de tu empresa se pone en pausa (se acabó la bolsa sin saldo adicional, el saldo está desactivado o llegó a su límite de gasto), el widget deja de ofrecer los dos botones y sigue funcionando sin ellos. A quien te escribe nunca se le dice que tu empresa se ha quedado sin saldo: si le pilla a medias, lee «La ayuda con IA no está disponible ahora mismo. Puedes enviar tu mensaje tal cual.», y lo que había escrito no se pierde. En Ajustes, la fila dice «La IA de tu empresa está en pausa. Mientras, tu widget funciona sin la ayuda.», con el botón para añadir saldo o, si no lo compras tú, **Pedir saldo de IA**. Con los 200 usos del día pasa lo mismo hasta el día siguiente. En cuanto vuelve a haber IA, los botones vuelven solos; en tu web puede tardar un minuto y medio.
- **En el ticket.** Si quien escribe envía lo que le propuso la ayuda, aunque lo haya retocado, el ticket llega con «Redactado con ayuda de IA», en la fila de la bandeja y junto a la descripción de la ficha. Así tu equipo sabe que el texto está reescrito. Lo dictado sin pedir ayuda no lleva la marca. La pone su navegador al enviar: es un aviso para tu equipo, no una prueba.
- **Utilia no guarda lo que lee la IA.** La grabación, los archivos y el texto se usan solo para preparar esa respuesta: no se guardan, y tampoco el texto que sustituye la propuesta. El proveedor de IA lo trata por cuenta de Utilia, como el resto de la IA del producto, y solo puede conservarlo un tiempo limitado para vigilar abusos, según su política. Del ticket queda lo que la persona envía, con sus adjuntos, como siempre.

Si tu empresa ha desactivado la IA externa en **Ajustes › Privacidad y cookies**, la fila lo dice y no se puede encender; si ya estaba encendida, tu widget sigue funcionando sin la ayuda. Con la asistencia puesta y **En cualquier web**, conviene limitarlo a tus webs en [Dónde puede aparecer](#dónde-puede-aparecer), para que nadie gaste tu IA pegando la línea en otra.

### Entrada al portal

Solo si tu plan tiene el [portal del cliente](https://os.utilia.ai/docs/guides/client-portal/overview). Con **Ofrecer la entrada al portal** encendido, el formulario dice «¿Ya eres cliente? Entra en tu portal» y lleva a su página de entrada: quien ya tiene acceso abre el ticket desde su portal, donde ve todos los suyos. Viene apagado.

### Quién firma las respuestas

Con **Firmar con el nombre de quien contesta** apagado, que es como viene, todas las respuestas van firmadas como «Equipo de» y el nombre de tu empresa. Encendido, cada una lleva el nombre y el apellido de quien la escribe, en el correo y en la conversación.

## Dónde puede aparecer

De serie, **En cualquier web**: el botón sale allí donde se pegue la línea. Para que solo salga en tus webs, despliega **Dónde puede aparecer**, elige **Solo en estas webs** y añade cada una como la escribirías, por ejemplo `www.tuempresa.es`; para todos sus subdominios, `*.tuempresa.es`. Caben hasta 20. Si el botón se ha visto en una web que no está en la lista, la pantalla te pregunta «¿Es tuya» y esa web, con **Añádela**. Compruébalo antes: cualquiera puede pegar tu línea en su web.

Con la lista puesta, en las demás webs el botón no aparece y no se aceptan mensajes. Tu página de soporte funciona siempre, porque la sirve UTILIA OS. Mientras la lista esté vacía, sale en cualquier web, y volver a **En cualquier web** la vacía, con **Deshacer** en el aviso.

## Cambiar la clave

La línea y el enlace de tu página llevan una clave de tu empresa. Si tu línea aparece donde no debe, pulsa **Cambiar la clave**, la última fila de **Dónde puede aparecer** (en el teléfono, en el menú **…** de arriba), y confírmalo. La línea que pegaste y el enlace de tu página de soporte dejan de funcionar al momento: tendrás que pegar la línea nueva en tu web y volver a compartir el enlace. «Funcionando en» vuelve a empezar de cero. Las conversaciones en marcha no se cortan, porque los enlaces de los correos no dependen de la clave.

## Qué pasa después

Cuando alguien te escribe:

- **A esa persona** le llega al momento el correo «Hemos recibido tu mensaje», con su número de solicitud y un enlace a la conversación.
- **A tu equipo** le llega el aviso «Nueva solicitud desde tu web», y el ticket entra en la bandeja de tickets con «De tu web» y, si usó la ayuda para redactarlo, «Redactado con ayuda de IA».
- **Cada respuesta pública** de tu equipo le llega por correo a esa persona, que contesta desde el enlace. Las notas internas, nunca.

Cómo se atiende, cuánto fiarte de lo que te escriben y cuándo el ticket queda en la ficha de un cliente de tu CRM lo explica [Contestar las solicitudes de tu web](https://os.utilia.ai/docs/guides/support-tickets/web-requests).

## Privacidad

- **El botón no guarda nada en su navegador.** El botón de tu web no deja cookies ni ningún otro dato en el navegador de quien escribe, y tu página de soporte y la de la conversación no guardan lo que escribe ni sus enlaces. Lo escrito vive mientras la página está abierta: cerrar y volver a abrir el formulario lo conserva; recargar la página, no.
- **Lo justo de la página.** Con el mensaje se guardan los datos de su navegador y la dirección de la página desde la que escribió, sin lo que va detrás de «?» o de «#», que puede llevar datos personales. La página solo se guarda si es de la web desde la que se envía o tu página de soporte.
- **Utilia no guarda lo que lee la asistencia con IA.** Al ticket llega solo lo que la persona decide enviar; el detalle está en [Asistencia con IA](#asistencia-con-ia).
- **Tu empresa es la responsable.** Los datos de quien escribe son de tu empresa, como los del resto de tus clientes, y UTILIA OS los trata por cuenta tuya. Por eso el formulario lleva el nombre de tu empresa y tu política de privacidad, y, con la asistencia con IA puesta, su línea de privacidad dice también que, si se usa la ayuda, sus datos sirven para preparar su mensaje.

## Si no aparece en tu web

- **El widget está apagado.** En Ajustes, el bloque **Widget de soporte** solo enseña **Activar el widget**. Actívalo.
- **La línea no está en esa página.** Pégala en la plantilla común, no en una página suelta, y guarda o publica los cambios: Webflow, por ejemplo, no la pone en tu web hasta que publicas el sitio.
- **Tu plataforma no deja pegar código con tu plan.** Wix pide un plan Premium y un dominio propio; Squarespace, el plan Core; Webflow, un plan de sitio de pago. Mientras tanto, comparte tu página de soporte.
- **Has cambiado la clave.** La línea antigua ya no funciona: copia la nueva y sustitúyela.
- **Tu web no está en la lista.** Con **Solo en estas webs**, `tuempresa.es` y `www.tuempresa.es` son dos webs distintas: añade la que se ve en el navegador, o `*.tuempresa.es` para todas.
- **Tu web no deja cargar código de fuera.** Algunas webs limitan de dónde pueden cargar código. Quien la lleva tiene que permitir os.utilia.ai.
- **Tu plan ya no incluye los tickets propios** o tu cuenta está suspendida. El botón deja de salir y tu página de soporte dice «Esta página de soporte no está disponible».
- **Acabas de cambiar algo.** Un cambio de plan o de los datos de tu empresa, como su nombre o su logotipo, tarda hasta un minuto en verse en el widget.

## Si tu web tiene inicio de sesión

**¿Qué widget te conviene?**

### Sin programar (Esta guía)

Para cualquier web. Quien escribe deja su nombre y su correo, y sigue la conversación desde sus correos. Lo activas tú en Ajustes.

### Para desarrolladores (Tu aplicación con inicio de sesión)

Tus usuarios ven y siguen sus tickets dentro de tu aplicación. Necesita una aplicación propia en UTILIA OS y que tu servidor firme a cada usuario.

Si quieres que quien entra en tu aplicación vea sus tickets dentro de ella, con su lista y sus respuestas, necesitas la versión para desarrolladores, y la instala alguien que programa: está en [Widget de soporte para desarrolladores](https://os.utilia.ai/docs/developers/widget/overview). El pie de la pantalla de Ajustes también te lleva allí.
