Agendamiento
Google Calendar en tu producto y en tus agentes de IA, con una API
El toolkit de Google Calendar lista calendarios, lista, lee, crea, actualiza y elimina eventos, consulta intervalos ocupados (free/busy) y crea calendarios secundarios. Con Connect, un producto o agente de IA agenda en el calendario del cliente sin construir el flujo OAuth de Google ni renovar tokens.
15 días de prueba. Sin tarjeta de crédito.
POST https://connect.reportei.com/api/tools/google_calendar_create_event/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"calendarId": "<calendarId>",
"start": {},
"end": {}
}
}Cómo funciona
Del cliente conectado a la primera llamada a Google Calendar.
- 1
Tu cliente conecta la cuenta
Tu sistema abre una sesión de Connect para el toolkit y tu cliente conecta su cuenta de Google Calendar. Recibes el id de la conexión.
- 2
Tu producto llama a la tool
Un POST a /api/tools/{tool}/execute con el id de la conexión y los argumentos. Si la llamada tiene éxito, Connect conserva el status y el cuerpo de la respuesta de la app.
- 3
Connect se encarga del resto
Guarda la credencial cifrada, renueva tokens en conexiones OAuth que admiten renovación y registra las ejecuciones en un historial de auditoría disponible por API.
Casos de uso
Qué hace tu producto con Google Calendar.
Agendar desde tu producto
Crea un evento con invitados y enlace de Google Meet cuando un lead reserve una llamada, un cliente apruebe una publicación o una tarea tenga fecha límite.
Encontrar un hueco libre
Deja que un agente de IA lea los intervalos ocupados de uno o más calendarios entre dos fechas y proponga horarios que funcionen.
Un calendario por cliente
En una herramienta de agencia, crea un calendario secundario para cada cliente, como un calendario de contenido, y agrega eventos a medida que se planifica el trabajo.
Tools
8 tools de Google Calendar
- Listar calendariosGETLista los calendarios de la lista de calendarios del usuario. Usa el id de un elemento como calendarId en las herramientas de eventos. El id primary es el calendario principal del usuario.
- Listar eventosGETLista los eventos de un calendario. Define singleEvents como true para expandir los eventos recurrentes, lo cual es necesario para ordenar por startTime.
- Crear eventoPOSTCrea un evento. Usa start.dateTime y end.dateTime para un evento con hora, o start.date y end.date para un evento de todo el día. sendUpdates decide a quién se le envía correo sobre él. Un enlace de Google Meet necesita conferenceData con conferenceDataVersion 1.
- Obtener eventoGETDevuelve un evento con los invitados y sus respuestas, el enlace de Meet en hangoutLink y recurringEventId cuando es una instancia de un evento recurrente.
- Actualizar eventoPATCHCambia los campos enviados y conserva los demás. Una lista, como attendees o recurrence, reemplaza la lista completa, así que envía todos los invitados que deben quedarse. sendUpdates decide a quién se le envía correo sobre el cambio.
- Eliminar eventoDELETEElimina un evento. El id de un evento recurrente elimina toda la serie; el id de una instancia elimina solo esa. sendUpdates decide a quién se le envía correo sobre la cancelación. La respuesta está vacía, con estado 204.
- Obtener free/busyPOSTDevuelve los intervalos ocupados de uno o más calendarios entre timeMin y timeMax, en calendars, indexados por el id del calendario. Un calendario que el usuario no puede ver vuelve con errors en lugar de busy.
- Crear calendarioPOSTCrea un calendario secundario del usuario, como un calendario de contenido para un cliente. El id de la respuesta va en calendarId de las herramientas de eventos.
OAuth con la app de tu producto
Registras la app OAuth de tu producto una sola vez, con POST /api/merchants/credentials/google_calendar, y tu cliente autoriza la cuenta en una pantalla de consentimiento. Connect renueva el token cuando está por vencer.
Preguntas sobre el toolkit de Google Calendar
¿Necesito implementar la API de Google Calendar?
No. Connect ya trae 8 tools de Google Calendar descritas y listas. Tu cliente conecta la cuenta y tu sistema llama a cada tool por el mismo endpoint, con el mismo formato de solicitud.
¿Cómo conecta mi cliente su cuenta de Google Calendar?
Con el modo que acepta el toolkit: OAuth con la app de tu producto. Connect guarda la credencial cifrada y nunca la devuelve a tu sistema.
¿Funciona con agentes de IA?
Sí. El input de cada tool está descrito en JSON Schema, que tu agente usa directamente como definición de tool. El agente elige la tool y los argumentos, y tu sistema hace la llamada a Connect.
¿Mi cliente necesita una cuenta en Reportei?
No. Tu cliente conecta la cuenta en una pantalla de Connect, o tu sistema envía la credencial por la API, y sigue usando solo tu producto.
Toolkits de la misma categoría
Ver los 100 toolkitsMira Connect aplicado a tu producto.
Pruébalo durante 15 días sin tarjeta, o cuéntale tu caso a nuestro equipo.
