Saltar al contenido principal
El chat aparece como una burbuja en una esquina de tu sitio. Lo que escriben tus visitantes llega a la Bandeja como cualquier otra conversación, y lo atiende el agente del canal o tu equipo. No hay que conectar ninguna cuenta.
1

Agregá el canal

En Canales, tocá Agregar canal y elegí Chat web. Completá el Nombre del canal, el Agente que atiende y el Equipo que recibe, y tocá Continuar. El canal queda encendido.
2

Pegá el código en tu sitio

En la página del canal, copiá el Código para tu sitio y pegalo antes de </body> en las páginas donde quieras el chat (o en la plantilla común, para que esté en todas):
3

Decí en qué sitios puede aparecer

En Sitios, agregá la dirección de tu sitio (tutienda.com.ar, o *.tutienda.com.ar para todos sus subdominios) y tocá Guardar. El navegador bloquea el chat en cualquier otro sitio. Sin ningún sitio, aparece en cualquiera que pegue el código.

Dónde pegar el código

  • HTML propio: antes de </body>, en cada página o en la plantilla que comparten.
  • WordPress: con un plugin de código en el pie (por ejemplo WPCode: Fragmentos de código → Encabezado y pie → Pie de página), o en el footer.php del tema.
  • Tiendanube: en Configuración → Códigos externos.
  • Shopify: Tienda online → Temas → Editar código, en theme.liquid, antes de </body>.
  • Google Tag Manager: una etiqueta HTML personalizado con el código, que se active en Todas las páginas.
Si tu sitio tiene una política de seguridad de contenido (CSP), sumá https://chat.desk.min-ai.ar a script-src y a frame-src.

Cómo se ve

En Apariencia elegís el Color, el Título (vacío: el nombre del canal), el Saludo que el visitante lee antes de escribir, la Posición (abajo a la derecha o a la izquierda) y el Idioma del chat (el del navegador del visitante, o uno fijo). La vista previa muestra cómo queda. En el celular, el chat abierto ocupa toda la pantalla. Si llega una respuesta con el chat cerrado, la burbuja muestra cuántos mensajes nuevos hay.

Antes del chat

En Antes del chat elegís qué le pide el chat al visitante antes de su primer mensaje: Nombre, Email y Teléfono, cada uno No, Opcional u Obligatorio. El agente lee esos datos en el contacto y lo llama por su nombre. A los visitantes que tu sitio identificó (ver Quién es el visitante) no se les pregunta. Lo que el visitante escribe ahí no está verificado: el nombre y el email quedan en el contacto, y el teléfono como un dato aparte (webchat_phone), para que nadie pueda hacerse pasar por un cliente de WhatsApp escribiendo su número. Pedir muchos datos obligatorios hace que algunos visitantes no escriban: lo más común es pedir el nombre, y el email o el teléfono como opcionales.

El chat como página

El chat como página propia es un enlace (https://chat.desk.min-ai.ar/chat/wc_…) que abre el chat solo, sin tu sitio: sirve para compartirlo por mail, en redes o en un código QR.

Lo que ve el agente

El agente sabe en qué página de tu sitio estaba el visitante cuando escribió, y que puede cerrar la página en cualquier momento: si hace falta seguir después, le pide un email o un teléfono. La respuesta le llega al visitante mientras tenga la página abierta, y la encuentra al volver desde el mismo navegador.

Quién es el visitante

Si tu sitio tiene usuarios, puede decirle a minai desk quién es cada uno. Así su conversación lo sigue en cualquier navegador, y el agente sabe su nombre y su email. En Quién es el visitante elegís:
  • No: todos escriben como visitantes anónimos.
  • Si inició sesión: los que iniciaron sesión en tu sitio llegan con su nombre; los demás, como anónimos.
  • Solo usuarios: solo pueden escribir los que iniciaron sesión.
Para usarlo, tocá Generar secreto y guardalo en tu servidor (se muestra una sola vez; si lo perdés, generá otro y el anterior deja de funcionar). Cuando el usuario inició sesión, tu servidor firma un JWT con ese secreto y tu página se lo pasa al chat:
sub (el id del usuario en tu sitio) y el vencimiento son obligatorios; name y email, opcionales. Lo que el visitante escribió antes de iniciar sesión pasa a su conversación. Nunca pongas el secreto en el código de la página. Otras órdenes que tu página le puede dar al chat: minaiDesk("open"), minaiDesk("close"), minaiDesk("toggle") y minaiDesk("logout") (cuando el usuario cierra la sesión: el navegador vuelve a ser un visitante nuevo).

El límite

Conversaciones nuevas por día cuida lo que gastás en el modelo si alguien abusa del chat (500 si no lo cambiás). Pasado el límite, los visitantes nuevos no pueden escribir hasta el día siguiente; las conversaciones que ya empezaron siguen. Además, un visitante no puede mandar más de 20 mensajes por minuto.

Apagar o quitar el canal

  • Apagar: el chat deja de aparecer en tu sitio, aunque el código siga pegado. El canal y sus conversaciones quedan: para volver, tocá Encender.
  • Quitar: se borran el canal y sus conversaciones (los contactos y los casos quedan), y el código pegado ya no muestra nada.