Integración con Google Calendar

Uno de los roles más comunes para IPFlow es actuar como un Setter de citas. En lugar de enviar a los clientes a un aburrido enlace de Calendly, la IA puede agendar la reunión directamente conversando por WhatsApp.

---

Capacidades de la Integración

La integración nativa de IPFlow con Google Calendar le otorga a la Inteligencia Artificial dos "superpoderes" (Tools):

1. check_availability: La IA puede consultar tu calendario y descubrir qué huecos tienes libres en un día específico.
2. create_event: La IA puede insertar un evento en tu calendario de forma instantánea.

Requisitos de Configuración

A diferencia de conectar un canal, Calendar requiere configuraciones estrictas de seguridad (OAuth y Service Accounts) en la plataforma de Google Cloud.

(Si usas IPFlow Cloud, este proceso es manejado con un simple botón de "Iniciar Sesión con Google". Si estás en Self-Hosted, deberás configurar el archivo de Google Credentials JSON en tu .env).

Activación paso a paso

1. En IPFlow, entra al panel de Integraciones (desde el menú principal).
2. Vincula la cuenta de Google (Gmail o Workspace) donde deseas que se guarden las citas.
3. Asegúrate de obtener el ID del Calendario (Usualmente es tu correo electrónico, pero si creaste un sub-calendario llamado "Citas Ventas", tendrás que copiar su ID desde los ajustes de Google Calendar).
4. Ve a los Settings de tu Agente y enciende la herramienta de Google Calendar, pegando el ID correspondiente.

---

El "Prompt" Perfecto para Agendar

Tener la herramienta activa no sirve de nada si el agente no sabe cómo agendar. Aquí tienes la estructura recomendada para tu Prompt Architect (Bloque Strict Rules):

"Eres un Setter de citas. Sigue este protocolo para agendar:

1. Pide el nombre y correo del cliente.
2. Pregúntale qué día prefiere.
3. OBLIGATORIO: Usa tu herramienta para verificar disponibilidad en la fecha que el cliente indicó. NUNCA ofrezcas un horario sin verificar tu calendario primero.
4. Ofrécele máximo 2 opciones de horario libre.
5. Si el cliente elige uno, usa tu herramienta para crear el evento. Duración: 30 minutos. Título: '[Nombre Cliente] - Reunión de Asesoría'.
6. Confírmale al cliente que la cita fue agendada exitosamente."

Lidiar con la Zona Horaria

Agendar citas por chat es peligroso si tú estás en México y tu cliente está en España. Para evitar problemas, te sugerimos agregar una regla de seguridad en tu Prompt:

"Las horas de tu calendario están en zona horaria [Ej: UTC-5 / Hora de Ciudad de México]. Si el cliente está en otro país, OBLIGATORIO infórmale a qué hora local tuya corresponde la cita para evitar confusiones, o pregúntale su zona horaria y haz la conversión matemática antes de agendar."