Listar invitados del evento en Calendly, con una API
Lista 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.
- Identificador
- calendly_list_event_invitees
La llamada
POST https://connect.reportei.com/api/tools/calendly_list_event_invitees/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"uuid": "<uuid>"
}
}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 |
|---|---|---|---|
| uuid | string | Sí | UUID of the scheduled event: the last segment of its uri, from List scheduled events. |
| status | string | No | Only the active or only the canceled invitees.Valores: active, canceled |
| string | No | Only the invitee with this email address. | |
| sort | string | No | created_at:asc or created_at:desc. The default is created_at:asc. |
| page_token | string | No | The pagination.next_page_token of the previous response, sent with the same filters. |
| count | integer | No | Invitees 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_invitees. 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.
- 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.
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.
