Listar tipos de evento en Calendly, con una API
Lista 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.
- Identificador
- calendly_list_event_types
La llamada
POST https://connect.reportei.com/api/tools/calendly_list_event_types/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"user": "<user>"
}
}Tu sistema envía el id de la conexión de tu cliente y los argumentos de la tool. Los headers son los mismos de toda la API de Connect: el token de tu producto y el token de tu cliente.
Parámetros
Las descripciones de los parámetros siguen la documentación oficial de la app, en inglés.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| user | string | No | URI of the user whose event types to list: the uri from Get current user. Send user or organization. |
| organization | string | No | URI of the organization, to list all of its event types: the current_organization from Get current user. Send user or organization. |
| active | boolean | No | true for only the active event types, false for only the inactive ones. Omit it for all. |
| admin_managed | boolean | No | true for only the event types managed by an admin, false to leave them out. Omit it for all. |
| sort | string | No | Comma-separated field:direction pairs. The fields are name, position, created_at and updated_at, and the direction is asc or desc. The default is name:asc. |
| page_token | string | No | The pagination.next_page_token of the previous response, sent with the same filters. |
| count | integer | No | Event types per page, up to 100. The default is 20. |
Conexiones posibles
Tu cliente conecta su cuenta de Calendly una sola vez, con uno de los modos de abajo. La misma conexión sirve para todas las tools del toolkit.
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.
La respuesta
Si la llamada tiene éxito, Connect conserva el status y el cuerpo de la respuesta de la app. Los errores HTTP devueltos por la app usan el objeto {error, api_error}; la autenticación o validación pueden fallar antes de la ejecución. El header X-Toolkit-Execution-Id identifica la ejecución registrada, disponible en GET /api/tools/executions/{uuid}.
Lista para agentes de IA
El input de esta tool es un JSON Schema, disponible en GET /api/tools/calendly_list_event_types. Se convierte en la definición de tool de tu agente sin conversión.
Otras 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.
- 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.
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.
