> For the complete documentation index, see [llms.txt](https://prometheo.gitbook.io/prometheo/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://prometheo.gitbook.io/prometheo/canales-adicionales/gmail.md).

# Gmail

## Conectar Gmail con Prometheo

En este tutorial vas a aprender cómo conectar una cuenta de Gmail con Prometheo para que tu asistente pueda recibir y responder automáticamente los correos que ingresen a esa casilla.

Antes de avanzar, es importante entender cómo funciona esta conexión y qué tenés que revisar para evitar respuestas no deseadas.

***

### ¿Cómo funciona la conexión con Gmail?

Cuando conectás una cuenta de Gmail a Prometheo, el asistente queda habilitado para trabajar con los correos que ingresen a esa casilla.

Prometheo puede:

* Recibir los correos entrantes de la cuenta conectada.
* Leer el contenido del mensaje recibido.
* Generar una respuesta automática usando las instrucciones configuradas en tu asistente.
* Enviar la respuesta desde la misma casilla de Gmail conectada.

Esto significa que el comportamiento del asistente dependerá directamente del prompt, las instrucciones y la configuración que tenga cargada en Prometheo.

\
Antes de conectar Gmail, **revisá cuidadosamente las instrucciones de tu asistente. Una vez conectada la casilla**, **Prometheo podrá responder automáticamente los correos entrantes usando ese criterio.**

***

### Información importante antes de empezar

Actualmente, la integración funciona únicamente con cuentas de Gmail.

Para poder conectarla, necesitás:

* Tener acceso a la cuenta de Gmail que querés conectar.
* Poder ingresar a la configuración de seguridad de esa cuenta.
* Activar la Verificación en 2 pasos de Google.
* Crear una contraseña de aplicación.
* Tener tu asistente de Prometheo correctamente configurado.
* Verificar que el asistente esté encendido.
* Contar con saldo disponible en tu cuenta de Prometheo.

{% hint style="info" %}
La contraseña de aplicación no es la misma contraseña que usás para iniciar sesión en Gmail. Es una clave especial generada por Google para permitir que una aplicación externa, como Prometheo, pueda conectarse de forma segura a tu cuenta.
{% endhint %}

***

### Paso 1: Ingresar a tu cuenta de Google

Abrí tu navegador e ingresá a:

<https://myaccount.google.com/>

Asegurate de iniciar sesión con la cuenta de Gmail que querés conectar a Prometheo.

Si tenés varias cuentas abiertas en el navegador, revisá bien que estés configurando la cuenta correcta. La conexión se hará con la cuenta que estés usando en Google al momento de crear la contraseña de aplicación.

***

### Paso 2: Entrar en la sección Seguridad

Dentro de tu cuenta de Google, buscá el menú lateral y seleccioná la opción **Seguridad**.

Desde esta sección vas a poder administrar los métodos de acceso, protección de la cuenta y configuraciones necesarias para permitir la conexión con Prometheo.

***

### Paso 3: Activar la Verificación en 2 pasos

En la sección **Seguridad**, buscá la opción **Verificación en 2 pasos**.

Ingresá allí y seguí los pasos que Google te indique para activarla.

Google puede pedirte que confirmes tu identidad usando alguno de estos métodos:

* Tu contraseña actual.
* Un código enviado por SMS.
* Una notificación en tu celular.
* Una app de autenticación.
* Otro método de seguridad asociado a tu cuenta.

La Verificación en 2 pasos es obligatoria para poder crear una contraseña de aplicación.

{% hint style="info" %}
Si no activás la Verificación en 2 pasos, Google no te permitirá generar la contraseña de aplicación necesaria para conectar Gmail con Prometheo.
{% endhint %}

***

### Paso 4: Abrir la sección Contraseñas de aplicación

Una vez activada la Verificación en 2 pasos, abrí este enlace en el navegador:

<https://myaccount.google.com/apppasswords>

Google puede pedirte que inicies sesión nuevamente o que confirmes tu identidad antes de continuar.

Esto es normal, ya que estás por generar una credencial especial para conectar una aplicación externa a tu cuenta.

***

### Paso 5: Crear una contraseña de aplicación para Prometheo

Dentro de la sección de contraseñas de aplicación, creá una nueva contraseña.

Cuando Google te pida ingresar un nombre para identificarla, escribí:

**Prometheo**

Este nombre sirve para que puedas reconocer fácilmente, dentro de tu cuenta de Google, que esa contraseña fue creada para la conexión con Prometheo.

Después de ingresar el nombre, confirmá la creación.

***

### Paso 6: Copiar la clave generada por Google

Google generará una clave especial para la aplicación.

Copiala exactamente como aparece en pantalla.

{% hint style="warning" %}
Guardá esta clave con cuidado en el momento en que Google la muestra. Por seguridad, es posible que después no puedas volver a verla. Si la perdés, vas a tener que generar una nueva contraseña de aplicación.
{% endhint %}

No uses tu contraseña normal de Gmail en Prometheo. La clave que tenés que usar es la contraseña de aplicación generada por Google.

***

### Paso 7: Ingresar a Prometheo

Ahora ingresá a tu cuenta de Prometheo.

Desde el panel principal, buscá la sección **Conexiones**.

Esta sección es donde se administran las integraciones disponibles para conectar canales externos con tu asistente.

***

### Paso 8: Seleccionar la conexión Gmail

Dentro de **Conexiones**, seleccioná la opción **Gmail**.

Prometheo te pedirá los datos necesarios para vincular la casilla.

***

### Paso 9: Escribir la dirección de Gmail

En el campo correspondiente, ingresá la dirección de Gmail que querés conectar.

Por ejemplo:

<usuario@gmail.com>

Revisá que el correo esté escrito correctamente, sin errores, espacios de más ni caracteres faltantes.

La dirección que escribas debe coincidir con la cuenta de Google en la que generaste la contraseña de aplicación.

***

### Paso 10: Pegar la contraseña de aplicación

En el campo **Contraseña**, pegá la clave especial generada por Google.

Pegala respetando el formato en el que fue entregada por Google, incluyendo los espacios si aparecen.

{% hint style="info" %}
**No pegues la contraseña habitual de Gmail. Para esta conexión tenés que usar únicamente la contraseña de aplicación creada desde tu cuenta de Google.**
{% endhint %}

***

### Paso 11: Confirmar la conexión

Después de ingresar el correo y la contraseña de aplicación, confirmá la conexión en Prometheo.

Si los datos son correctos, la cuenta de Gmail quedará conectada y Prometheo podrá comenzar a trabajar con los correos entrantes de esa casilla.

***

### Paso 12: Enviar un correo de prueba

Para verificar que todo funcione correctamente, enviá un correo de prueba desde otra casilla.

No uses la misma cuenta conectada para hacer la prueba. Lo ideal es enviar el mensaje desde otro Gmail, Outlook u otra dirección de correo.

El flujo esperado es el siguiente:

1. Enviás un correo a la casilla conectada.
2. El correo ingresa en Gmail.
3. Prometheo detecta el mensaje.
4. El asistente genera una respuesta usando sus instrucciones.
5. La respuesta se envía automáticamente desde la casilla conectada.

***

### Qué revisar si no responde automáticamente

Si el correo ingresa correctamente en Gmail pero no recibe respuesta automática, revisá estos puntos:

#### 1. Verificá que el asistente esté encendido

Ingresá a Prometheo y confirmá que el asistente asociado a la conexión esté activo.

Si el asistente está apagado, no responderá los correos aunque Gmail esté conectado correctamente.

***

#### 2. Verificá que tengas saldo disponible

Prometheo necesita saldo disponible para procesar mensajes y generar respuestas.

Si no hay saldo suficiente, el asistente puede recibir el correo pero no generar ni enviar una respuesta.

***

#### 3. Revisá las instrucciones del asistente

Confirmá que el prompt del asistente tenga instrucciones claras sobre cómo debe responder los correos.

Por ejemplo, podés revisar si el asistente tiene definido:

* Qué tipo de consultas debe responder.
* Qué tono debe usar.
* Qué información debe pedir si falta algún dato.
* Qué casos debe derivar a una persona.
* Qué límites debe respetar.
* Qué datos de la empresa, producto o servicio debe conocer.

Mientras más claras sean las instrucciones, mejores serán las respuestas automáticas.

***

#### 4. Confirmá que la casilla conectada sea la correcta

Verificá que el correo conectado en Prometheo sea exactamente el mismo Gmail en el que generaste la contraseña de aplicación.

Si generaste la clave en una cuenta distinta, la conexión puede fallar o no funcionar correctamente.

***

#### 5. Revisá la contraseña de aplicación

Si la conexión no funciona, puede que la contraseña de aplicación haya sido copiada de forma incorrecta.

En ese caso, podés volver a ingresar a:

<https://myaccount.google.com/apppasswords>

Luego generá una nueva contraseña de aplicación con el nombre **Prometheo** y reemplazá la clave anterior en la configuración de la conexión.

***

### Cuándo pedir una revisión adicional

Si ya revisaste que:

* El correo ingresa correctamente a Gmail.
* El asistente está encendido.
* Hay saldo disponible.
* La contraseña de aplicación fue generada correctamente.
* El Gmail conectado coincide con la cuenta configurada.
* Las instrucciones del asistente están cargadas correctamente.

Y aun así no se envían respuestas automáticas, será necesario realizar un chequeo adicional de la conexión.

En ese caso, contactá al equipo de soporte o al responsable de la implementación para revisar el estado de la integración.

***

### Recomendaciones antes de dejar Gmail activo

Antes de usar la conexión en producción, se recomienda hacer varias pruebas con mensajes reales o similares a los que recibiría la casilla.

Probá distintos escenarios, por ejemplo:

* Una consulta simple.
* Una consulta incompleta.
* Un mensaje con varios temas.
* Un correo que debería ser respondido automáticamente.
* Un correo que debería ser derivado o no respondido.
* Un mensaje enviado desde una casilla externa.

Esto te permitirá validar si el asistente interpreta correctamente los correos y responde de acuerdo con las instrucciones configuradas.

{% hint style="warning" %}
Recordá que Prometheo responderá en función del prompt del asistente. Si necesitás que no responda ciertos casos, que derive conversaciones o que pida información adicional antes de responder, eso debe estar indicado en sus instrucciones.
{% endhint %}

***

### Resumen del proceso

Para conectar Gmail con Prometheo:

1. Ingresá a tu cuenta de Google.
2. Entrá en **Seguridad**.
3. Activá la **Verificación en 2 pasos**.
4. Abrí la sección de **Contraseñas de aplicación**.
5. Creá una contraseña con el nombre **Prometheo**.
6. Copiá la clave generada por Google.
7. Entrá a Prometheo.
8. Abrí **Conexiones**.
9. Seleccioná **Gmail**.
10. Ingresá la dirección de Gmail.
11. Pegá la contraseña de aplicación.
12. Confirmá la conexión.
13. Enviá un correo de prueba desde otra casilla.

Una vez completados estos pasos, Prometheo quedará conectado a Gmail y podrá responder automáticamente los correos entrantes usando las instrucciones de tu asistente.
