soporte@tuempresa.com). Desk la lee cada minuto, cada mail nuevo entra como una conversación y la respuesta sale desde esa misma dirección, en el mismo hilo.
Hay dos formas de conectarla:
- Gmail o Google Workspace: con una app de Google de tu empresa (un proyecto gratis en Google Cloud, a tu nombre). Se hace una vez y lleva unos 10 minutos.
- Otro proveedor (IMAP): con la dirección y una contraseña de aplicación. Sirve para la mayoría de los proveedores (Yahoo, iCloud, Zoho, el hosting de tu dominio…), y también para Gmail si preferís no crear la app.
Outlook, Hotmail y Microsoft 365 todavía no se pueden conectar: Microsoft no deja entrar con contraseña.
Agregá el canal
1
Elegí Email
En Canales, tocá Agregar canal y elegí Email.
2
Elegí quién atiende
Completá el Nombre del canal, el Agente que atiende y el Equipo que recibe, y tocá Continuar. Llegás a la pestaña Conexión del canal.
3
Elegí dónde está la casilla
En ¿Dónde está la casilla?, elegí Gmail o Google Workspace u Otro proveedor (IMAP), y seguí la sección que corresponde acá abajo.
Gmail o Google Workspace
1
Creá un proyecto
En console.cloud.google.com/projectcreate, creá un proyecto (por ejemplo, desk) y entrá a él.
2
Habilitá la API de Gmail
En la página de la API de Gmail, con tu proyecto elegido arriba, tocá Habilitar.
3
Armá la pantalla de permisos
En Google Auth Platform, tocá Comenzar:
- Nombre de la aplicación: el de tu empresa. Correo electrónico de asistencia al usuario: el tuyo.
- Público: Interno si la casilla es de Google Workspace (de tu dominio); Usuarios externos si es una cuenta de Gmail.
- Información de contacto: tu mail. Aceptá la política y tocá Crear.
4
Completá los datos de la app
En Desarrollo de la marca:
- Página principal y Política de privacidad: los links de tu sitio.
- Dominios autorizados: el de tu sitio y min-ai.ar (desk vuelve de Google a una dirección de ese dominio).
5
Publicá la app (solo cuentas de Gmail)
En Público, tocá Publicar app y Confirmar. Google avisa que habría que verificarla: no hace falta, la app es de tu empresa y solo la usa tu casilla. Publicarla evita que la conexión se corte a los 7 días. Si elegiste Interno (Workspace), este paso no va.
6
Creá el cliente
En Clientes → Crear cliente:
- Tipo de aplicación: Aplicación web. Ponele un nombre (por ejemplo, desk).
- En URIs de redireccionamiento autorizados, tocá Agregar URI y pegá la que te muestra la consola de desk en URI de redireccionamiento autorizada (
https://desk.min-ai.ar/hooks/email/google). - Tocá Crear y, antes de cerrar, Descargar JSON: después Google no te muestra el secreto de nuevo.
7
Subí el JSON y autorizá
En la consola de desk, tocá Subir el JSON, elegí el archivo que descargaste y tocá Autorizar con Google. Elegí la cuenta de la casilla.Google te muestra «Google no ha verificado esta aplicación»: es esperable, la app es tuya (tu mail aparece como desarrollador). Tocá Configuración avanzada → Ir a min-ai.ar. Si el permiso de Gmail tiene una casilla, marcala y tocá Continuar.Volvés a la página del canal: «¡Listo, está conectado!». Desde ese momento, desk lee los mails nuevos.
Si algo sale mal
Si algo sale mal
- «A ese cliente le falta la URI de redireccionamiento»: editá el cliente en Google Cloud, agregá la URI de la consola, guardá y descargá el JSON de nuevo.
- «Ese cliente es de tipo App de escritorio»: creá otro cliente, de tipo Aplicación web.
- «La API de Gmail está apagada»: tocá Habilitar la API de Gmail en tu proyecto, después Habilitar, y autorizá de nuevo.
- «Quedó sin marcar el acceso a Gmail»: autorizá de nuevo y marcá la casilla del permiso en la pantalla de Google.
- El canal se desconecta a la semana: la app quedó en modo de prueba. Publicala (paso 5) y autorizá de nuevo.
Otro proveedor (IMAP)
1
Sacá una contraseña de aplicación
La mayoría de los proveedores no dejan entrar a otras apps con la contraseña de la cuenta: piden una contraseña de aplicación.
- Gmail: activá la verificación en 2 pasos y creá una en myaccount.google.com/apppasswords (nombre: desk). Son 16 letras.
- Yahoo e iCloud: en la seguridad de la cuenta, «Generar contraseña de app».
- El hosting de tu dominio: suele servir la contraseña de la casilla.
2
Conectá
En la consola, completá la Dirección de email y la Contraseña de aplicación, y tocá Conectar. Desk busca solo los servidores de tu proveedor, entra para probar que funcionan (leer por IMAP y enviar por SMTP) y queda conectado.Si no los encuentra, te pide los Servidores: uno para los dos (
mail.tuempresa.com) o IMAP y SMTP separados por coma (imap.tuempresa.com, smtp.tuempresa.com:587). Están en la ayuda de tu proveedor o en la configuración de tu programa de correo.Remitente y firma
En la pestaña Remitente del canal:- Nombre del remitente: cómo le aparece al cliente quién le escribe (por ejemplo, «Zapas · Atención»). Vacío: solo la dirección.
- Firma: va debajo de cada mail que sale de desk, lo escriba el agente o una persona del equipo. El agente no firma: la pone el canal.
Cómo atiende el email
El email no es un chat: el cliente lee cuando puede y no espera una respuesta en segundos. Por eso, en este canal:- Una respuesta completa por mail. El agente contesta todo lo que preguntaron en un solo mail, con saludo, párrafos y un cierre breve. Si necesita algo del cliente, se lo pide todo junto.
- Espera un minuto antes de contestar, por si llega un segundo mail («me olvidé de adjuntar…»): los lee juntos.
- Cada mail en su hilo. La respuesta sale con Re: y el asunto, y le llega al cliente en la misma conversación de su programa de correo. Si responde, sigue la misma conversación en desk.
- Solo lo nuevo. De cada mail, desk guarda lo que escribió el cliente, sin la parte citada de los mails anteriores. En la bandeja ves el asunto arriba de cada mail y los nombres de los adjuntos (los archivos quedan en tu casilla).
- Sin respuestas automáticas. Los rebotes, los «fuera de la oficina», los newsletters y los mails de
no-replyno abren conversación.
Cambiar la configuración
En la tarjeta de la casilla, Configurar. La página del canal tiene tres pestañas:- Atención: el nombre, el agente y el equipo del canal. Abajo, Quitar.
- Conexión: conectada, muestra la casilla, cómo entra desk (la app de Google y su proyecto, o los servidores IMAP y SMTP) y Desconectar, que borra las credenciales (en Gmail, también revoca el acceso de desk) y deja de leer la casilla; el canal y sus conversaciones quedan. Si el canal queda Desconectado (se revocó el acceso, cambió la contraseña o lo desconectaste), acá aparecen de nuevo las dos formas de conectarla: subí el JSON y autorizá otra vez, o cargá la contraseña nueva. Para cambiar cómo entra desk (de la app de Google a IMAP, o al revés), desconectala y conectala de la otra forma. Tiene que ser la misma casilla: para conectar otra, agregá otro canal.
- Remitente: el nombre y la firma (más arriba).