Agendamiento
Calendly en tu producto y en tus agentes de IA, con una API
El toolkit de Calendly cubre tipos de evento, horarios libres, eventos programados y sus invitados: listarlos y leerlos, crear y actualizar tipos de evento individuales, agendar una reunión, cancelarla y generar enlaces de agendamiento de un solo uso. El cliente conecta Calendly una vez con OAuth, y tu producto o agente de IA llama a cada operación por un único endpoint de Connect, sin armar el flujo OAuth ni guardar tokens.
15 días de prueba. Sin tarjeta de crédito.
POST https://connect.reportei.com/api/tools/calendly_create_event_type/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"owner": "<owner>",
"name": "<name>"
}
}Cómo funciona
Del cliente conectado a la primera llamada a Calendly.
- 1
Tu cliente conecta la cuenta
Tu sistema abre una sesión de Connect para el toolkit y tu cliente conecta su cuenta de Calendly. 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 Calendly.
Agendar reuniones desde tu producto
Lee los horarios libres de un tipo de evento y crea el invitado desde tu propia pantalla, para que el cliente agende sin salir de tu app.
Sincronizar reuniones con un CRM
Lista los eventos programados y sus invitados, con respuestas y seguimiento UTM, y guárdalos en tu CRM o herramienta de reportes.
Agendamiento con un agente de IA
Dale al agente las herramientas de horarios libres y de enlace de agendamiento, para que ofrezca un horario, lo agende o envíe un enlace de un solo uso a un lead.
Tools
12 tools de Calendly
- Obtener usuario actualGETDevuelve el usuario de Calendly conectado: uri, la URI del usuario que piden Listar tipos de evento, Listar eventos programados y Crear tipo de evento, y current_organization, la URI de la organización, con name, email, scheduling_url y timezone.
- Listar tipos de eventoGETLista los tipos de evento de un usuario o de una organización: envía user u organization. Cada elemento tiene uri, name, duration en minutos, scheduling_url y active. La respuesta tiene collection y pagination: pasa pagination.next_page_token como page_token para leer la página siguiente.
- Obtener tipo de eventoGETDevuelve un tipo de evento, con name, duration en minutos, duration_options, locations, custom_questions (las preguntas de reserva que responde Crear invitado del evento), scheduling_url y active.
- Crear tipo de eventoPOSTCrea un tipo de evento individual (one-on-one) para un usuario y lo devuelve. Solo este tipo (solo) se puede crear por la API, y se crea inactivo salvo que active sea true.
- Actualizar tipo de eventoPATCHActualiza un tipo de evento individual y lo devuelve. Solo cambian los campos enviados. Solo los tipos de evento de tipo solo se pueden actualizar por la API.
- Listar horarios libres del tipo de eventoGETLista los horarios de inicio libres de un tipo de evento en un rango de hasta 31 días a futuro. Cada elemento tiene start_time en UTC, invitees_remaining y scheduling_url. No hay paginación: pide un rango más corto cuando haga falta.
- Listar eventos programadosGETLista las reuniones programadas de un usuario o de una organización: envía user u organization. Cada elemento tiene uri, name, status, start_time y end_time en UTC, event_type e invitees_counter. La respuesta tiene collection y pagination: pasa pagination.next_page_token como page_token para leer la página siguiente.
- Obtener evento programadoGETDevuelve una reunión programada, con name, status, start_time y end_time en UTC, event_type, location, invitees_counter, event_memberships (los anfitriones) y, si fue cancelada, cancellation.
- Cancelar evento programadoPOSTCancela una reunión programada para todos sus invitados y devuelve la cancelación. Un evento grupal se cancela completo: no se puede cancelar un solo invitado de un evento grupal por la API.
- Listar invitados del eventoGETLista los invitados de una reunión programada, con name, email, status, questions_and_answers, tracking (los parámetros UTM de la reserva), no_show, cancel_url y reschedule_url. La respuesta tiene collection y pagination: pasa pagination.next_page_token como page_token para leer la página siguiente.
OAuth con la app de tu producto
Registras la app OAuth de tu producto una sola vez, con POST /api/merchants/credentials/calendly, y tu cliente autoriza la cuenta en una pantalla de consentimiento. Connect renueva el token cuando está por vencer.
Preguntas sobre el toolkit de Calendly
¿Necesito implementar la API de Calendly?
No. Connect ya trae 12 tools de Calendly 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 Calendly?
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.
