> ## Documentation Index > Fetch the complete documentation index at: https://help.desk.min-ai.ar/llms.txt > Use this file to discover all available pages before exploring further. # Conectar el email > Los mails de tu casilla de atención: Gmail o Google Workspace con una app de Google de tu empresa, o cualquier otro proveedor por IMAP. Conectás la casilla donde te escriben tus clientes (por ejemplo, `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. > [!NOTE] > > 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 > [!TIP] > > Hacelo en una computadora: la consola de Google Cloud es incómoda en el teléfono. Entrá a Google Cloud con la cuenta de la casilla que vas a conectar, o con una de tu empresa que la administre. **1. Creá un proyecto** En [console.cloud.google.com/projectcreate](https://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](https://console.cloud.google.com/apis/library/gmail.googleapis.com), con tu proyecto elegido arriba, tocá **Habilitar**. **3. Armá la pantalla de permisos** En [Google Auth Platform](https://console.cloud.google.com/auth/overview), tocá **Comenzar**: 1. **Nombre de la aplicación**: el de tu empresa. **Correo electrónico de asistencia al usuario**: el tuyo. 2. **Público**: **Interno** si la casilla es de Google Workspace (de tu dominio); **Usuarios externos** si es una cuenta de Gmail. 3. **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](https://console.cloud.google.com/auth/branding): * **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). No subas un logo: Google pediría verificar la app. Tocá **Guardar**. **5. Publicá la app (solo cuentas de Gmail)** En [Público](https://console.cloud.google.com/auth/audience), 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](https://console.cloud.google.com/auth/clients/create): 1. **Tipo de aplicación**: **Aplicación web**. Ponele un nombre (por ejemplo, **desk**). 2. 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`). 3. 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** > > * **«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](https://myaccount.google.com/security) y creá una en [myaccount.google.com/apppasswords](https://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. Desk solo lee la **Bandeja de entrada**, sin marcar nada como leído, y guarda una copia de cada respuesta en **Enviados** (Gmail la guarda solo). ## 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-reply` no abren conversación. Tus instrucciones para el agente (en **Agentes**) valen igual que en los otros canales: el tono, qué resuelve y cuándo deriva. No hace falta explicarle que es un mail. ## 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). **Quitar** hace que desk deje de leer la casilla y borra sus conversaciones. Los mails siguen en tu casilla; los contactos y los casos quedan. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.