11.02 Webmail y Google Calendar

☁️ Integración de Google Calendar y Webmail (Gmail) en tu CRM

Este tutorial te guía paso a paso para configurar las APIs de Google, obtener tus credenciales OAuth2, y conectar tu CRM con Gmail y Google Calendar de forma segura.

🧩 Requisitos previos

Antes de comenzar, asegúrate de tener:

• Una cuenta de Google activa.
• Acceso a la Google Cloud Console.
• Acceso de administrador en tu CRM.
• Navegador actualizado (recomendado Google Chrome).

🚀 1. Ingresar a la consola de Google

Abre el siguiente enlace:
🔗https://console.cloud.google.com/

🏢 2. Crear una organización (si no tienes una)

1. En el menú superior, haz clic en "Seleccionar organización".
2. Luego, selecciona "Nueva organización".
3. Completa la información solicitada.
4. Asocia tu cuenta de facturación y confirma la creación.

⚠️ Es importante tener una organización creada para poder habilitar servicios y usar credenciales OAuth.

💳 3. Agregar un método de pago

1. En el menú lateral, ve a Facturación > Métodos de pago.
2. Agrega una tarjeta de crédito o débito válida.
3. Confirma la activación de la facturación.

💡 Google no cobrará nada si no usas servicios de pago, pero lo solicita para habilitar las APIs.

📦 4. Crear un nuevo proyecto

1. Haz clic en el selector superior y elige "Nuevo proyecto".
2. Asigna un nombre (ejemplo: CRM Integration).
3. Selecciona tu organización y ubicación.
4. Presiona Crear.

⚙️ 5. Habilitar las APIs necesarias

1. En el panel izquierdo, entra en Biblioteca de APIs.
2. Busca y habilita las siguientes APIs:
   • Gmail API
   • Google Calendar API

✅ Asegúrate de que ambas aparezcan como "Habilitadas" en tu panel.

🔑 6. Crear credenciales OAuth 2.0

1. Ve al menú lateral → APIs y servicios > Credenciales.
2. Clic en + Crear credenciales → selecciona ID de cliente de OAuth 2.0.
3. Si aparece un mensaje para configurar la pantalla de consentimiento, hazlo (ver paso 8).
4. Completa el formulario:
   • Tipo de aplicación: Aplicación web
   • Nombre: CRM Integration
   • URIs autorizadas de redireccionamiento:
   • https://app.crm.com/gmail-callback.html
   • https://app.crm.com/google-callback.html
5. Haz clic en Crear.

💾 7. Descargar las credenciales

1. Una vez creadas, haz clic en el ícono de descarga 📥 del archivo .json.
2. Guarda los valores siguientes, los necesitarás más adelante:
   • client_id
   • client_secret

🧩 8. Configurar la pantalla de consentimiento OAuth

1. Ve a APIs y servicios → Pantalla de consentimiento OAuth.
2. Elige el tipo de usuario:
   • Interno: solo para usuarios dentro de tu organización.
   • Externo: para permitir cualquier cuenta de Google.
3. Completa la información:
   • Nombre de la aplicación (ejemplo: CRM Google Integration).
   • Correo de soporte.
   • Dominio del CRM (ejemplo: https://app.crm.com).
4. En el apartado Usuarios de prueba, agrega los correos autorizados para acceder (tus cuentas de Gmail o las de tu equipo).
5. Guarda los cambios y publica.

📅 9. Habilitar Google Calendar en tu CRM

1. Ingresa a tu CRM.
2. Ve a Configuraciones → Integraciones → Google Calendar.
3. Pega tus credenciales:
   client_id
   client_secret
4. Haz clic en Generar Token.
5. Se abrirá una ventana emergente de autenticación de Google.
6. Inicia sesión con tu cuenta y acepta los permisos solicitados.

✅ Una vez autenticado, tu CRM estará conectado a tu cuenta de Google Calendar.

Podrás crear, ver y sincronizar eventos directamente desde el CRM.

📧 10. Habilitar Gmail Webmail en el CRM

1. Desde tu CRM, ve a Canales → Crear nuevo canal → Tipo: Webmail.
2. Agrega tu correo electrónico de Gmail (el mismo que usaste en Google Console).
3. Pega nuevamente las credenciales:
   client_id
4. client_secret
5. No es necesario ingresar la contraseña de Gmail.
6. Haz clic en el botón azul Configurar OAuth2.
7. Se abrirá una ventana de Google para iniciar sesión y autorizar.

🔐 11. Obtener el código de autorización

Tras la autenticación, serás redirigido a una URL similar a esta:

https://app.watitan.com/#/gmail/callbackUrlBack?state=83&code=4/0AVGzR1CJAyOhxFcPDVAyiCLLYzTNHMj5scztJGhNNaPGKwfLojS_HR95ltBqkjyHYxjwBw&scope=https://mail.google.com/...

Copia solo el valor después de code= y antes de &scope=
Ejemplo:

4/0AVGzR1CJAyOhxFcPDVAyiCLLYzTNHMj5scztJGhNNaPGKwfLojS_HR95ltBqkjyHYxjwBw

🧠 12. Completar la configuración en el CRM

1. Pega el código en la ventana emergente del CRM.
2. Guarda el canal.
3. En la lista de canales, haz clic en Conectar.

⚠️ Esta versión beta solo permite recibir correos Gmail (lectura y sincronización de bandeja de entrada).

✅ ¡Listo!

Tu CRM ahora está conectado con:

• Google Calendar (para creación y sincronización de eventos).
• Gmail Webmail (para recepción de correos).

🧭 Resumen de configuración