Saltar al contenido principal

Conectar cuentas de correo

Campbooks se conecta a tu proveedor de correo mediante OAuth — nunca ve tu contraseña, y el token de actualización que almacena está cifrado en reposo. Es compatible con Zoho Mail, Google Workspace (Gmail) y Microsoft 365.

El calendario viene incluido. Al conectar un buzón de Google o Zoho se solicitan los permisos de calendario en el mismo acceso OAuth, de modo que el calendario se sincroniza automáticamente — no hay un flujo de conexión separado para el calendario. Consulta Calendario.

Proveedores compatibles​

ProveedorAPIConsolaCallback de correo
Zoho MailZoho Mail REST APIZoho API Console/oauth/zoho/callback
Google WorkspaceGmail APIGoogle Cloud Console/oauth/gmail/callback
Microsoft 365Microsoft GraphCentro de administración de Entra/oauth/microsoft/callback

Autoriza cada URL de callback como <url-de-tu-app>/oauth/<proveedor>/callback — p. ej. http://localhost:3000/oauth/gmail/callback en local, o https://app.example.com/oauth/gmail/callback en producción.

Zoho Mail​

1. Crea un cliente API de Zoho​

  1. Ve a la Zoho API Console.
  2. Crea una nueva Aplicación basada en servidor.
  3. Añade el URI de redireccionamiento: <url-de-tu-app>/oauth/zoho/callback.
  4. Apunta tu Client ID y Client Secret.

2. Configura las variables de entorno​

ZOHO_CLIENT_ID=your_client_id
ZOHO_CLIENT_SECRET=your_client_secret
ZOHO_REGION=eu   # eu | com | in | au | jp — debe coincidir con tu centro de datos Zoho

3. Conecta en Campbooks​

  1. Ve a Configuración → Cuentas de correo y haz clic en Añadir cuenta de correo.
  2. Elige Zoho Mail y autoriza la conexión en Zoho.
  3. Tras la autorización, Campbooks almacena un token de actualización cifrado e inicia el primer análisis.

Google Workspace (Gmail)​

1. Crea un proyecto en Google Cloud​

  1. Ve a la Google Cloud Console y crea un proyecto.
  2. Activa la API de Gmail y la API de Google Calendar.
  3. Crea credenciales OAuth 2.0 (tipo: Aplicación web).
  4. Añade el URI de redireccionamiento: <url-de-tu-app>/oauth/gmail/callback.

2. Configura las variables de entorno​

GOOGLE_CLIENT_ID=your_client_id
GOOGLE_CLIENT_SECRET=your_client_secret

3. Conecta en Campbooks​

  1. Ve a Configuración → Cuentas de correo y haz clic en Añadir cuenta de correo.
  2. Elige Google Workspace y autoriza a través de la pantalla de consentimiento de Google.

La conexión de Gmail y la integración interactiva Enviar a Drive son apps de Google separadas — Drive usa el scope completo drive restringido de Google y su propio /oauth/google/callback. Consulta Google Drive.

Microsoft 365​

1. Registra una aplicación en Entra​

  1. Ve al Centro de administración de Entra → Registros de aplicaciones → Nuevo registro.
  2. Tipos de cuenta admitidos: Cuentas en cualquier directorio organizacional (cuentas de trabajo/escuela — la app usa el endpoint /organizations/).
  3. Añade un URI de redireccionamiento web: <url-de-tu-app>/oauth/microsoft/callback.
  4. Crea un secreto de cliente.

2. Configura las variables de entorno​

MICROSOFT_CLIENT_ID=your_client_id
MICROSOFT_CLIENT_SECRET=your_client_secret
ENABLE_MICROSOFT_MAILBOX=1   # muestra el botón "Conectar Microsoft 365"

3. Conecta en Campbooks​

  1. Ve a Configuración → Cuentas de correo y haz clic en Añadir cuenta de correo.
  2. Elige Microsoft 365 y autoriza a través de la pantalla de consentimiento de Microsoft.

Compartir cuentas​

Un buzón conectado puede compartirse con otras personas del espacio de trabajo con permisos de visualización o envío por usuario, de modo que un equipo puede trabajar en una misma bandeja de entrada sin compartir la contraseña. Todos los puntos de acceso — la app web, Scout y los flujos de trabajo — respetan el mismo control de permisos.

Después de conectar​

Una vez conectada una cuenta, Campbooks la mantiene sincronizada automáticamente. Consulta Análisis de correo para ver cómo funcionan el análisis y el procesamiento.

Última actualización en