Google Calendar
Conecte Google Calendar para que un agente pueda crear, enumerar y cancelar eventos en su calendario principal y avisar por correo a los invitados.
Qué conseguirá
Un agente podrá poner eventos en su Google Calendar, enumerar los próximos y cancelar uno, durante una llamada.
Descripción general y casos de uso
- Reservar una cita directamente en su calendario e invitar al cliente.
- Decir a quien llama lo que ya está reservado.
- Cancelar un evento cuando quien llama lo pide.
Requisitos previos
- Una cuenta de Google cuyo calendario quiera que use el agente. Los eventos van al calendario principal de esa cuenta.
- Si Phynxa no aporta la aplicación de Google para su espacio de trabajo, un cliente OAuth de Google Cloud (consulte más abajo).
Configuración de la cuenta externa (en Google)
Solo hace falta si el cuadro Connect pide un Client ID y un secreto. Google controla estas pantallas. La guía de Google: Create events.
- En la consola de Google Cloud, cree un cliente OAuth (aplicación web) y active la API de Google Calendar.
- Añada la URL de redireccionamiento que muestra el cuadro de Phynxa como URI de redireccionamiento autorizado.
- Copie el Client ID y el Client secret.
Conéctelo en Phynxa
- Integrations, Connect en Google Calendar. Si dice Sign in with Google, púlselo y apruebe. En caso contrario, pegue primero el Client ID y el secreto.
- Elija su cuenta de Google y apruebe.
- La tarjeta muestra Connected con su dirección.
Permisos y ajustes
Ámbitos: calendar.events (crear, enumerar y eliminar eventos) y userinfo.email (para mostrar qué cuenta está conectada). Solo se solicitan esos; la conexión no guarda nada que no use.
Úselo en una llamada
| Acción | Qué hace | Se ejecuta |
|---|---|---|
| Create calendar event | Añade un evento con título, inicio, fin, zona horaria y correos de los invitados. Se envía una invitación por correo a los invitados. | En segundo plano |
| List calendar events | Enumera los eventos entre dos horas, opcionalmente los que contengan cierto texto. | Espera |
| Cancel event | Elimina un evento por su id. Se avisa a los invitados. | En segundo plano |
Las horas se dan como fecha y hora con una zona horaria, como 2026-11-02T15:00:00 y Asia/Dubai. El agente conoce su propia zona horaria y la hora actual, así que «mañana a las 3» funciona cuando su Timezone es correcta.
Pruébelo
Test connection y después pida en Chat al agente que reserve una reunión mañana a las 3 y revise Google Calendar.
Resultado esperado
El evento aparece en su calendario principal; los invitados reciben invitaciones.
Solución de problemas
- El evento cae a una hora equivocada. Fije la Timezone del agente en Language and timezone.
- Acceso bloqueado. Puede que su aplicación de Google Cloud esté en modo de pruebas; añada su cuenta como usuario de prueba, o publique la aplicación.
- «The connected app could not be reached.» Inténtelo de nuevo; si persiste, use Reconnect.
Seguridad y credenciales
Los tokens se almacenan cifrados. Revoque el acceso en cualquier momento en la página de seguridad de su cuenta de Google; Remove también lo elimina en Phynxa.
Guías relacionadas
¿Algo de esto no coincide con lo que ve en el panel? Avísenos.