Calendly (versión preliminar)
El conector de Calendly le permite automatizar eventos programados, aumentar la productividad y optimizar la eficiencia a través de flujos de trabajo automatizados.
Este conector está disponible en los siguientes productos y regiones:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Todas las regiones de Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Aplicaciones lógicas | Estándar | Todas las regiones de Logic Apps excepto las siguientes: - Regiones de Azure Government - Regiones de Azure China - Departamento de Defensa de EE. UU. (DoD) |
| Power Apps | Premium | Todas las regiones de Power Apps excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Power Automate | Premium | Todas las regiones de Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Contacto | |
|---|---|
| Nombre | Soporte técnico de Calendly |
| URL | https://help.calendly.com/hc/en-us |
| Correo Electrónico | support@calendly.com |
| Metadatos del conector | |
|---|---|
| Publicador | Calendly |
| Sitio web | https://calendly.com |
| Directiva de privacidad | https://calendly.com/privacy |
| Categorías | Productividad |
Creación de una conexión
El conector admite los siguientes tipos de autenticación:
| Predeterminado | Parámetros para crear una conexión. | Todas las regiones | No se puede compartir |
Predeterminado
Aplicable: Todas las regiones
Parámetros para crear una conexión.
Esta conexión no se puede compartir. Si la aplicación de energía se comparte con otro usuario, se pedirá a otro usuario que cree explícitamente una nueva conexión.
| Nombre | Tipo | Description | Obligatorio |
|---|---|---|---|
| Token de acceso personal | securestring | Token de acceso personal para esta API | Cierto |
Limitaciones
| Nombre | Llamadas | Período de renovación |
|---|---|---|
| Llamadas API por conexión | 100 | 60 segundos |
Acciones
| Crear invitación sin mostrar |
Marca un invitado como no mostrar. |
| Eliminar invitación sin mostrar |
Deshacer marcando un invitado como no mostrar |
| Obtener tipo de evento |
Devuelve información sobre un tipo de evento especificado. |
| Obtener tipos de eventos |
Devuelve todos los tipos de eventos asociados a su organización. |
Crear invitación sin mostrar
Marca un invitado como no mostrar.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
URI de invitación
|
invitee | True | string |
URI del invitador que se está marcando como No Show para un evento programado |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Sin mostrar URI
|
resource.uri | string |
Referencia canónica (identificador único) para no mostrar |
|
URI de invitación
|
resource.invitee | string |
Referencia canónica (identificador único) para el invitado asociado |
|
Creado en
|
resource.created_at | string |
El momento en el que no se creó ninguna presentación |
Eliminar invitación sin mostrar
Deshacer marcando un invitado como no mostrar
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Invitar sin mostrar UUID
|
uuid | True | string |
UUID del invitado cuyo registro no mostrar se va a quitar |
Devoluciones
No mostrar eliminado correctamente
- 204
- string
Obtener tipo de evento
Devuelve información sobre un tipo de evento especificado.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
UUID de tipo de evento
|
uuid | True | string |
UUID del tipo de evento que se solicita |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
resource
|
resource | EventType |
Obtener tipos de eventos
Devuelve todos los tipos de eventos asociados a su organización.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Active
|
active | boolean |
Devuelve solo los tipos de eventos activos si es true, solo inactivo si es false o todos los tipos de eventos si se omite este parámetro. |
|
|
Contar
|
count | integer |
Número de filas que se van a devolver. |
|
|
Token de página
|
page_token | string |
Token que se va a pasar para obtener la parte siguiente o anterior de la colección. |
|
|
Administrador administrado
|
admin_managed | boolean |
Devuelve solo los tipos de eventos administrados por el administrador si es true, excluye los tipos de eventos administrados por el administrador si es false o incluye todos los tipos de eventos si se omite este parámetro. |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
colección
|
collection | array of EventType |
colección |
|
Recuento de paginaciones
|
pagination.count | integer |
Número de filas que se van a devolver. |
|
URI de página siguiente
|
pagination.next_page | string |
URI para devolver la página siguiente de una lista ordenada ("null" indica que no hay ningún resultado adicional disponible). |
|
URI de página anterior
|
pagination.previous_page | string |
URI para devolver la página anterior de una lista ordenada ("null" indica que no hay ningún resultado adicional disponible). |
|
Token de página siguiente
|
pagination.next_page_token | string |
Token para devolver la página siguiente de una lista ordenada ("null" indica que no hay ningún resultado adicional disponible). |
|
Token de página anterior
|
pagination.previous_page_token | string |
Token para devolver la página anterior de una lista ordenada ("null" indica que no hay ningún resultado adicional disponible). |
Desencadenadores
| Creación de una suscripción de webhook (Invitee) |
Cree una suscripción de webhook para una organización que se desencadene cuando se programe o cancele un evento. |
| Crear suscripción de webhook (envío de formulario de enrutamiento) |
Cree una suscripción de webhook para una organización que se desencadene cuando se envía un formulario de enrutamiento. |
Creación de una suscripción de webhook (Invitee)
Cree una suscripción de webhook para una organización que se desencadene cuando se programe o cancele un evento.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
events
|
events | True | array of string |
events |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Webhook creado en
|
created_at | string |
El momento en que se creó el webhook (por ejemplo, "2020-01-02T03:04:05.678123Z"). |
|
URI de Creador de webhooks
|
created_by | string |
Referencia al usuario que creó la suscripción de webhook. |
|
Evento de webhook
|
event | string |
Evento que provocó que el webhook se desencadenara. |
|
Cancelar dirección URL del evento
|
payload.cancel_url | string |
Vínculo para cancelar el evento para el invitado. |
|
Invitación creada en
|
payload.created_at | string |
El momento en que se creó el evento (por ejemplo, "2020-01-02T03:04:05.678123Z"). |
|
Correo electrónico de invitación
|
payload.email | string |
Dirección de correo electrónico del invitado. |
|
URI de evento
|
payload.event | string |
Referencia al evento. |
|
Nombre del invitado
|
payload.name | string |
Nombre del invitado. |
|
Nombre de invitación
|
payload.first_name | string |
Nombre del invitador que reservó el evento cuando el tipo de evento está configurado para usar campos independientes para el nombre y apellidos. Null cuando el tipo de evento está configurado para usar un único campo para el nombre. |
|
Invitar a apellidos
|
payload.last_name | string |
El apellido del invitado que reservó el evento cuando el tipo de evento está configurado para usar campos independientes para el nombre y apellidos. Null cuando el tipo de evento está configurado para usar un único campo para el nombre. |
|
Nuevo URI de invitación
|
payload.new_invitee | string |
Vínculo a nuevo invitado, después de volver a programar. |
|
URI de invitación antiguo
|
payload.old_invitee | string |
Referencia a la instancia anterior de Invitee que se ha vuelto a programar. |
|
Una colección de las respuestas del invitado a preguntas en el formulario de confirmación de reserva del evento
|
payload.questions_and_answers | array of object |
Una colección de las respuestas del invitado a preguntas en el formulario de confirmación de reserva del evento. |
|
Pregunta
|
payload.questions_and_answers.question | string |
Pregunta en el formulario de reserva del invitado. |
|
Respuesta
|
payload.questions_and_answers.answer | string |
La respuesta del invitado a la pregunta. |
|
Posición de la pregunta
|
payload.questions_and_answers.position | number |
Posición de la pregunta en relación con otros usuarios en el formulario de reserva. |
|
Url del evento Reschedule
|
payload.reschedule_url | string |
Vínculo para volver a programar el evento para el invitado. |
|
¿Invitee Rescheduled?
|
payload.rescheduled | boolean |
Reprogramado |
|
Estado de invitación
|
payload.status | string |
estado |
|
Número de recordatorio de texto de invitación
|
payload.text_reminder_number | string |
text_reminder_number |
|
Zona horaria de invitación
|
payload.timezone | string |
timezone |
|
Campaña UTM
|
payload.tracking.utm_campaign | string |
Parámetro UTM usado para realizar un seguimiento de una campaña. |
|
Origen UTM
|
payload.tracking.utm_source | string |
Parámetro UTM que identifica el origen (plataforma donde se origina el tráfico). |
|
UTM Medium
|
payload.tracking.utm_medium | string |
Parámetro UTM que identifica el tipo de entrada (por ejemplo, Costo por clic (CPC), medios sociales, afiliados o código QR). |
|
Contenido de UTM
|
payload.tracking.utm_content | string |
Parámetro de seguimiento de contenido UTM. |
|
Término UTM
|
payload.tracking.utm_term | string |
Parámetro UTM usado para realizar un seguimiento de la palabra clave. |
|
Salesforce UUID
|
payload.tracking.salesforce_uuid | string |
Identificador único del registro de Salesforce. |
|
URI de invitación
|
payload.uri | string |
Referencia canónica (identificador único) para el invitado. |
|
URI de envío de formulario de enrutamiento
|
payload.routing_form_submission | string |
Referencia a un envío de formulario de enrutamiento que redirigió al invitado a una página de reserva. |
|
scheduled_event
|
payload.scheduled_event | ScheduledEvent | |
|
cancelación
|
payload.cancellation | Cancellation |
Proporciona datos relativos a la cancelación del evento |
|
pago
|
payload.payment | Payment |
Pago de invitación |
|
no_show
|
payload.no_show | NoShow |
Proporciona datos relativos a la no presentación asociada para el invitado. |
|
reconfirmación
|
payload.reconfirmation | Reconfirmation |
Suponiendo que la reconfirmación está habilitada para el tipo de evento, cuando se solicita la reconfirmación, este objeto está presente con un |
Crear suscripción de webhook (envío de formulario de enrutamiento)
Cree una suscripción de webhook para una organización que se desencadene cuando se envía un formulario de enrutamiento.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
events
|
events | True | array of string |
events |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Webhook creado en
|
created_at | string |
El momento en que se creó el webhook (por ejemplo, "2020-01-02T03:04:05.678123Z"). |
|
URI de Creador de webhooks
|
created_by | string |
Referencia al usuario que creó la suscripción de webhook. |
|
Evento de webhook
|
event | string |
Evento que provocó que el webhook se desencadenara. |
|
URI de envío de formulario de enrutamiento
|
payload.uri | string |
Referencia canónica (identificador único) para el envío del formulario de enrutamiento. |
|
URI de formulario de enrutamiento
|
payload.routing_form | string |
URI del formulario de enrutamiento asociado al envío. |
|
questions_and_answers
|
payload.questions_and_answers | array of object |
questions_and_answers |
|
UUID de pregunta
|
payload.questions_and_answers.question_uuid | string |
Identificador único para la pregunta del formulario de enrutamiento. |
|
Pregunta
|
payload.questions_and_answers.question | string |
Nombre de la pregunta (en formato legible). |
|
Respuesta
|
payload.questions_and_answers.answer | string |
Respuesta proporcionada por el encuestado cuando se envió el formulario. |
|
Campaña UTM
|
payload.tracking.utm_campaign | string |
Parámetro UTM usado para realizar un seguimiento de una campaña. |
|
Origen UTM
|
payload.tracking.utm_source | string |
Parámetro UTM que identifica el origen (plataforma donde se origina el tráfico). |
|
UTM Medium
|
payload.tracking.utm_medium | string |
Parámetro UTM que identifica el tipo de entrada (por ejemplo, Costo por clic (CPC), medios sociales, afiliados o código QR). |
|
Contenido de UTM
|
payload.tracking.utm_content | string |
Parámetro de seguimiento de contenido UTM. |
|
Término UTM
|
payload.tracking.utm_term | string |
Parámetro UTM usado para realizar un seguimiento de la palabra clave. |
|
Salesforce UUID
|
payload.tracking.salesforce_uuid | string |
Identificador único del registro de Salesforce. |
|
Tipo de resultado
|
payload.result.type | string |
Indica si el envío del formulario de enrutamiento dio lugar a un mensaje personalizado, un tipo de evento o una dirección URL externa. |
|
URI del remitente
|
payload.submitter | string |
La referencia al recurso Invitee al enrutar el envío de formularios da como resultado una reunión programada. |
|
Tipo de remitente
|
payload.submitter_type | string |
Tipo del recurso encuestado que envió el formulario y programó una reunión. |
|
Envío de formulario de enrutamiento creado en
|
payload.created_at | string |
Momento en que se envió el formulario de enrutamiento. |
|
Envío de formulario de enrutamiento actualizado en
|
payload.updated_at | string |
Momento en el que se actualizó por última vez el envío del formulario de enrutamiento. |
Definiciones
ScheduledEvent
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
URI de evento
|
uri | uri |
Referencia canónica (identificador único) para el recurso. |
|
Nombre del evento
|
name | string |
Nombre del evento. |
|
Estado del evento
|
status | string |
Indica si el evento es "activo" o "cancelado". |
|
Hora de inicio del evento
|
start_time | date-time |
El momento en que se programó el evento para iniciarse en hora UTC (por ejemplo, "2020-01-02T03:04:05.678123Z"). |
|
Hora de finalización del evento
|
end_time | date-time |
Momento en que el evento estaba programado para finalizar en hora UTC (por ejemplo, "2020-01-02T03:04:05.678123Z") |
|
URI de tipo de evento
|
event_type | uri |
El tipo de evento asociado a este evento |
|
location
|
location | Location |
Tipo base polimórfico para una ubicación de evento que Calendly admite |
|
Total de invitaciones
|
invitees_counter.total | number |
Total de invitaciones para un evento, incluidas las invitaciones que se han cancelado |
|
Total de invitaciones activas
|
invitees_counter.active | number |
Total de invitaciones para un evento que no se ha cancelado. |
|
Invitaciones máximas de eventos
|
invitees_counter.limit | number |
Número máximo de invitaciones activas que pueden reservar el evento. |
|
Evento creado en
|
created_at | date-time |
El momento en que se creó el evento (por ejemplo, "2020-01-02T03:04:05.678123Z") |
|
Evento actualizado en
|
updated_at | date-time |
El momento en que se actualizó por última vez el evento (por ejemplo, "2020-01-02T03:04:05.678123Z") |
|
event_memberships
|
event_memberships | array of object |
Lista de pertenencia a eventos |
|
URI del miembro del evento
|
event_memberships.user | uri |
Referencia canónica (identificador único) para el usuario. |
|
Correo electrónico del miembro del evento
|
event_memberships.user_email |
Dirección de correo electrónico del usuario. |
|
|
event_guests
|
event_guests | array of Guest |
Personas adicionales agregadas a un evento por un invitado |
|
cancelación
|
cancellation | Cancellation |
Proporciona datos relativos a la cancelación del evento |
|
Evento de calendario
|
calendar_event | LegacyCalendarEvent |
Información sobre el evento de calendario del proveedor del calendario. |
Cancelación
Proporciona datos relativos a la cancelación del evento
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Cancelado por
|
canceled_by | string |
Nombre de la persona que canceló. |
|
Motivo de cancelación
|
reason | string |
Motivo por el que se produjo la cancelación. |
|
Tipo de cancelador
|
canceler_type | string |
Indica si el evento fue cancelado por el "Host" o "Invitee". |
Guest
Una persona a la que un invitado ha invitado a ser un asistente invitado a un evento
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Correo electrónico de invitado del evento
|
El correo electrónico del invitado del evento. |
||
|
Invitado de evento creado en
|
created_at | date-time |
Hora en que se creó el invitado del evento. |
|
Invitado de evento actualizado en
|
updated_at | date-time |
Hora en que se actualizó por última vez el invitado del evento. |
Ubicación
Tipo base polimórfico para una ubicación de evento que Calendly admite
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Tipo de ubicación
|
type | string |
Indica el tipo de ubicación del evento. |
|
Estado de conferencia web
|
status | string |
Este campo solo se aplica a los tipos de ubicación zoom_conference, webex_conference, google_conference, gotomeeting y microsoft_teams_conference. |
|
Dirección URL de la reunión de conferencia web
|
join_url | uri |
Este campo solo se aplica a los tipos de ubicación zoom_conference, webex_conference, google_conference, gotomeeting y microsoft_teams_conference. |
|
Ubicación del evento
|
location | string |
Este campo solo se aplica a outbound_call, inbound_call, físicos, ask_invitee y tipos de ubicación personalizados. |
LegacyCalendarEvent
Información sobre el evento de calendario del proveedor del calendario.
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Tipo de evento Calendly
|
kind | string |
Indica al proveedor de calendario al que pertenece el evento. |
|
Id. de evento de calendario externo
|
external_id | string |
Identificador proporcionado por el proveedor de calendario para este evento de calendario. |
Pago
Pago de invitación
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Identificador externo de pago
|
external_id | string |
Identificador único del pago. |
|
Proveedor de pagos
|
provider | string |
Proveedor de pagos. |
|
Importe del pago
|
amount | float |
El importe del pago. |
|
Moneda del pago
|
currency | string |
Formato de moneda en el que se encuentra el pago. |
|
Condiciones de pago
|
terms | string |
Términos del pago. |
|
¿Pago correcto?
|
successful | boolean |
Indica si el pago se procesó correctamente. |
NoShow
Proporciona datos relativos a la no presentación asociada para el invitado.
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Sin mostrar URI
|
uri | string |
Referencia canónica (identificador único) para no mostrar |
|
No Show Created At
|
created_at | date-time |
Momento en el que no se creó ninguna presentación. |
Tipo de evento
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
URI de tipo de evento
|
uri | string |
Referencia canónica (identificador único) para el tipo de evento. |
|
Nombre del tipo de evento
|
name | string |
Nombre del tipo de evento (en formato legible). |
|
Active
|
active | boolean |
Indica si el evento está activo o no. |
|
Método Booking
|
booking_method | string |
Indica si el tipo de evento es para un sondeo o una reserva instantánea. |
|
Trago
|
slug | string |
Parte de la dirección URL del tipo de evento que identifica una página web específica (en un formato legible). |
|
Dirección URL de programación
|
scheduling_url | string |
Dirección URL del sitio de programación del usuario donde invita a reservar este tipo de evento. |
|
Duración
|
duration | integer |
La duración de las sesiones reservadas con este tipo de evento. |
|
Kind
|
kind | string |
Indica si el tipo de evento es "solo" (pertenece a un usuario individual) o "grupo". |
|
Tipo de agrupación
|
pooling_type | string |
Indica si el tipo de evento es "round robin" (alterna entre hosts) o "colectivo" (invita a elegir una hora cuando todos los participantes están disponibles) o "null" (el tipo de evento no tiene en cuenta la disponibilidad de los participantes de un grupo). |
|
Tipo
|
type | string |
Indica si el tipo de evento es "AdhocEventType" (evento ad hoc) o "StandardEventType" (tipo de evento estándar). |
|
Color
|
color | string |
Valor de color hexadecimal de la página de programación del tipo de evento. |
|
Creado en
|
created_at | string |
Momento en que se creó el tipo de evento (por ejemplo, "2020-01-02T03:04:05.678123Z"). |
|
Actualizado en
|
updated_at | string |
El momento en que se actualizó por última vez el tipo de evento (por ejemplo, "2020-01-02T03:04:05.678123Z"). |
|
Nota interna
|
internal_note | string |
Contenido de una nota que puede estar asociado al tipo de evento. |
|
Descripción (sin formato)
|
description_plain | string |
Descripción del tipo de evento (en texto sin formato). |
|
Descripción (HTML)
|
description_html | string |
Descripción del tipo de evento (con formato HTML). |
|
Tipo de perfil
|
profile.type | string |
Indica si el perfil pertenece a un "usuario" (individual) o "equipo". |
|
Nombre del perfil
|
profile.name | string |
Nombre legible para el perfil del usuario asociado al tipo de evento. |
|
URI del propietario del perfil
|
profile.owner | string |
Referencia única al usuario asociado al perfil. |
|
Secreto
|
secret | boolean |
Indica si el tipo de evento está oculto en la página de programación principal del propietario. |
|
Eliminado en
|
deleted_at | string |
Momento en que se eliminó el tipo de evento (por ejemplo, "2020-01-02T03:04:05.678123Z"). |
|
Administrador administrado
|
admin_managed | boolean |
Indica si un administrador de la organización administra este tipo de evento. |
|
custom_questions
|
custom_questions | array of object |
custom_questions |
|
Nombre de pregunta personalizado
|
custom_questions.name | string |
nombre |
|
Tipo de pregunta personalizado
|
custom_questions.type | string |
type |
|
Posición de pregunta personalizada
|
custom_questions.position | integer |
position |
|
Pregunta personalizada habilitada
|
custom_questions.enabled | boolean |
enabled |
|
Pregunta personalizada requerida
|
custom_questions.required | boolean |
required |
|
Opciones personalizadas de respuesta a preguntas
|
custom_questions.answer_choices | array of string |
answer_choices |
|
Incluir otros
|
custom_questions.include_other | boolean |
include_other |
Reconfirmación
Suponiendo que la reconfirmación está habilitada para el tipo de evento, cuando se solicita la reconfirmación, este objeto está presente con un created_at que refleja cuándo se envió la notificación de reconfirmación. Una vez que el invitado haya vuelto a confirmar el confirmed_at atributo cambiará de null a una marca de tiempo que refleje cuándo tomaron medidas.
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Reconfirmación creada en
|
created_at | date-time |
Cuando se creó la reconfirmación. |
|
Invitación confirmada en
|
confirmed_at | date-time |
Cuando el Invitador confirmó su asistencia. |