Calendario Zoho
Zoho Calendar es un calendario de negocios en línea que facilita la programación. Puede usarlo para mantenerse al día de su programación y también compartir calendarios con su equipo para mantener a todos los usuarios en la misma página.
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 | Calendario Zoho |
| URL | https://www.zoho.com/calendar/contact.html |
| Correo Electrónico | zmintegration@zohomail.com |
| Metadatos del conector | |
|---|---|
| Publicador | Zoho Mail |
| Sitio web | https://www.zoho.com/calendar/ |
| Directiva de privacidad | https://www.zoho.com/privacy.html |
| Categorías | Colaboración; Productividad |
Calendario Zoho
Zoho Calendar es un calendario de negocios en línea que hace que su programación sea sin esfuerzo. El conector zoho Calendar proporciona la capacidad de administrar el calendario y realizar acciones repetitivas, como crear, editar, eliminar eventos mediante la creación de flujos de trabajo mediante el modelo de desencadenador de acciones.
Prerrequisitos
Una cuenta comprobada de Zoho Calendar. Haga clic aquí para crear su primera cuenta.
Obtención de credenciales
Al crear una nueva conexión,
- Seleccione el dominio donde reside su cuenta de Zoho.
- Escriba las credenciales del calendario zoho.
- Incluso si la aplicación de energía se comparte con otro usuario, debe crear una nueva conexión para empezar a usarla.
Zoho Calendar API usa OAuth2.0 para autenticarse y, por tanto, no se requiere ninguna autenticación secundaria una vez configurada la cuenta.
Introducción al conector
Siga los pasos siguientes para conectarse al calendario zoho:
- Inicie sesión en su cuenta de Power Automate y haga clic en Crear en el menú de la izquierda.
- Puede optar por crear un flujo de nube, un flujo de escritorio o un flujo de negocio. Para conectarse al calendario zoho, elija el flujo de nube automatizado.
- Puede crear un flujo o plantilla.
- Escriba los valores deseados para la acción correspondiente.
Problemas conocidos y limitaciones
- Actualmente, los eventos periódicos no se admiten en el conector.
Errores y soluciones comunes
- Para evitar errores de autenticación, elija el dominio donde está hospedada la cuenta de Calendario zoho.
Preguntas más frecuentes
https://www.zoho.com/calendar/help/getting-started.html
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 |
|---|---|---|---|
| Seleccione la región donde residen los datos de la cuenta de Zoho. | cuerda / cadena | Seleccione el dominio. | Cierto |
Limitaciones
| Nombre | Llamadas | Período de renovación |
|---|---|---|
| Llamadas API por conexión | 100 | 60 segundos |
Acciones
| Actualizar evento |
Actualiza un evento existente en el calendario de un usuario. |
| Creación de un nuevo evento |
Agrega un nuevo evento al calendario del usuario. |
| Eliminar evento |
Elimina un evento del calendario del usuario. |
| Eventos de búsqueda |
Obtiene la lista de eventos en todos los calendarios. |
| Obtener detalles del calendario |
recupera los detalles de un calendario determinado mediante el UID de calendario. |
| Obtener evento |
Obtiene los detalles de un evento determinado, como el título del evento, la fecha de inicio, la fecha de finalización, etc., del calendario especificado de un usuario. |
| Obtener lista de calendarios |
Obtiene la lista de todos los calendarios con el UID del calendario, el nombre y la zona horaria. |
| Obtener lista de eventos |
Obtiene la lista de todos los eventos entre el intervalo de fechas especificado en formato aaaa-MM-ddTHH:mm:sszzz. |
Actualizar evento
Actualiza un evento existente en el calendario de un usuario.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Calendario
|
cuid | True | string |
Especifique el calendario o escriba el identificador único del calendario. |
|
Event
|
euid | True | string |
Escriba el identificador único del evento. |
|
Title
|
title | True | string |
Especificar el título del evento |
|
Hora de inicio
|
start | True | string |
Especifique la hora de inicio del evento con el formato aaaa-MM-ddTHH:mm:sszzz |
|
Hora de finalización
|
end | True | string |
Especifique la hora de finalización del evento con el formato aaaa-MM-ddTHH:mm:sszzz |
|
Timezone
|
timezone | string |
Especificar la zona horaria del evento |
|
|
Color
|
color | string |
Elija el color del evento o especifique el valor hexadecimal del color. |
|
|
Description
|
description | string |
Especificar la descripción del evento |
|
|
Ubicación
|
location | string |
Especificar la ubicación del evento |
|
|
URL
|
url | string |
Especificar la dirección URL del evento |
|
|
Privada
|
isprivate | boolean |
Especificar si el evento es privado o no |
|
|
Está todo el día
|
isallday | boolean |
Especifique si el evento es un evento de todo el día. |
|
|
id. de correo electrónico
|
string |
Especificar las direcciones de correo electrónico de los asistentes |
||
|
Transparencia
|
transparency | integer |
Especifique si el evento debe agregarse a la programación de disponibilidad. |
|
|
Permitir reenvío
|
allowForwarding | boolean |
Especificar si el evento se puede reenviar o no |
|
|
type
|
action | string |
Especifique el tipo de recordatorio de eventos (correo electrónico, notificaciones, etc.) |
|
|
en minutos
|
minutes | integer |
Especifique el tiempo para recordarle antes o después del evento (p. ej.: - 5 para antes, 5 para después) |
Devoluciones
- Body
- SingleEventRes
Creación de un nuevo evento
Agrega un nuevo evento al calendario del usuario.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Calendario
|
cuid | True | string |
Especifique el calendario o escriba el identificador único del calendario. |
|
Title
|
title | True | string |
Especificar el título del evento |
|
Hora de inicio
|
start | True | string |
Especifique la hora de inicio del evento con el formato aaaa-MM-ddTHH:mm:sszzz |
|
Hora de finalización
|
end | True | string |
Especifique la hora de finalización del evento con el formato aaaa-MM-ddTHH:mm:sszzz |
|
Timezone
|
timezone | string |
Especificar la zona horaria del evento |
|
|
Color
|
color | string |
Elija el color del evento o especifique el valor hexadecimal del color. |
|
|
Description
|
description | string |
Especificar la descripción del evento |
|
|
Ubicación
|
location | string |
Especificar la ubicación del evento |
|
|
URL
|
url | string |
Especificar la dirección URL del evento |
|
|
Privada
|
isprivate | boolean |
Especificar si el evento es privado o no |
|
|
Está todo el día
|
isallday | boolean |
Especifique si el evento es un evento de todo el día. |
|
|
id. de correo electrónico
|
string |
Especificar las direcciones de correo electrónico de los asistentes |
||
|
Transparencia
|
transparency | integer |
Especifique si el evento debe agregarse a la programación de disponibilidad. |
|
|
Permitir reenvío
|
allowForwarding | boolean |
Especificar si el evento se puede reenviar o no |
|
|
type
|
action | string |
Especifique el tipo de recordatorio de eventos (correo electrónico, notificaciones, etc.) |
|
|
en minutos
|
minutes | integer |
Especifique el tiempo para recordarle antes o después del evento (p. ej.: - 5 para antes, 5 para después) |
Devoluciones
- Body
- SingleEventRes
Eliminar evento
Elimina un evento del calendario del usuario.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Calendario
|
cuid | True | string |
Especifique el calendario o escriba el identificador único del calendario. |
|
Event
|
euid | True | string |
Escriba el identificador único del evento. |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
events
|
events | array of object |
events |
|
uid
|
events.uid | string |
uid |
|
recurrenceid
|
events.recurrenceid | string |
recurrenceid |
Eventos de búsqueda
Obtiene la lista de eventos en todos los calendarios.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Calendario
|
cuid | True | string |
Especifique el calendario o escriba el identificador único del calendario. |
|
Hora de inicio
|
start | True | string |
Especifique la hora de inicio del evento con el formato aaaa-MM-ddTHH:mm:sszzz. |
|
Hora de finalización
|
end | string |
Especifique la hora de finalización del evento con el formato aaaa-MM-ddTHH:mm:sszzz. |
|
|
Buscar texto
|
searchtext | string |
Especifique que se debe buscar en el título |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
buscar
|
search | array of object |
buscar |
|
Identificador único de evento
|
search.uid | string |
Identificador único del evento |
|
Es todo el día
|
search.isallday | boolean |
Si el evento es un evento de todo el día |
|
Id. único del calendario
|
search.caluid | string |
Identificador único del calendario |
|
Title
|
search.title | string |
Título del evento |
|
type
|
search.type | integer |
type |
|
Timezone
|
search.dateandtime.timezone | string |
zona horaria del evento |
|
hora de comienzo
|
search.dateandtime.start | string |
Hora de inicio del evento |
|
hora de finalización
|
search.dateandtime.end | string |
Hora de finalización del evento |
Obtener detalles del calendario
recupera los detalles de un calendario determinado mediante el UID de calendario.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Calendario
|
cuid | True | string |
Especifique el calendario o escriba el identificador único del calendario. |
Devoluciones
- Body
- SingleCalendarRes
Obtener evento
Obtiene los detalles de un evento determinado, como el título del evento, la fecha de inicio, la fecha de finalización, etc., del calendario especificado de un usuario.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Calendario
|
cuid | True | string |
Especifique el calendario o escriba el identificador único del calendario. |
|
Event
|
euid | True | string |
Escriba el identificador único del evento. |
Devoluciones
- Body
- SingleEventRes
Obtener lista de calendarios
Obtiene la lista de todos los calendarios con el UID del calendario, el nombre y la zona horaria.
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
calendars
|
calendars | array of SingleCalendarRes |
calendars |
Obtener lista de eventos
Obtiene la lista de todos los eventos entre el intervalo de fechas especificado en formato aaaa-MM-ddTHH:mm:sszzz.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Calendario
|
cuid | True | string |
Especifique el calendario o escriba el identificador único del calendario. |
|
Por instancia
|
byinstance | True | boolean |
Recupera todas las instancias de eventos de repetición como un evento independiente cuando se establece como true. El intervalo de fechas no debe superar los 31 días. |
|
Hora de inicio
|
start | True | string |
Especifique la hora de inicio con el formato aaaa-MM-ddThh:mm:sszzz |
|
Hora de finalización
|
end | True | string |
Especifique la hora de finalización con el formato aaaa-MM-ddThh:mm:sszzz |
|
Timezone
|
timezone | string |
Especificar la zona horaria del evento |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
events
|
events | array of SingleEventRes |
events |
Desencadenadores
| Editar notificación de eventos |
Cuando se actualiza un evento a un calendario |
| Eliminar notificación de eventos |
Cuando se elimina un evento en un calendario |
| Nueva notificación de eventos |
Cuando se agrega un evento a un calendario |
Editar notificación de eventos
Eliminar notificación de eventos
Cuando se elimina un evento en un calendario
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Identificador único de evento
|
zc_data.uid | string |
Identificador único del evento |
|
Id. único del calendario
|
zc_data.caluid | string |
Identificador único del calendario |
Nueva notificación de eventos
Definiciones
SingleEventRes
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Color
|
color | string |
Valor de color de evento en hexadecimal |
|
Title
|
title | string |
Título del evento |
|
Duración
|
duration | string |
Duración del evento |
|
Identificador único de evento
|
uid | string |
Identificador único del evento |
|
Evento creado por
|
createdby | string |
Usuario que creó el evento |
|
Se aprueba
|
isApproved | boolean |
Indica si se aprueba el evento creado. |
|
Ubicación
|
location | string |
Ubicación del evento |
|
URL
|
url | string |
Dirección URL del evento |
|
Dirección URL de la vista de eventos
|
viewEventURL | string |
Dirección URL única del evento. |
|
timezone
|
dateandtime.timezone | string |
Zona horaria del evento |
|
hora de comienzo
|
dateandtime.start | string |
Hora de inicio del evento |
|
hora de finalización
|
dateandtime.end | string |
Hora de finalización del evento |
|
Evento modificado por última vez en
|
lastmodifiedtime | string |
Fecha y hora en que se modificó por última vez el evento |
|
Es privado
|
isprivate | boolean |
Si el evento es un evento privado o no |
|
Asistentes
|
attendees | array of object |
Asistentes del evento |
|
nombre para mostrar
|
attendees.dName | string |
Mostrar nombres de asistentes |
|
id. de correo electrónico
|
attendees.email | string |
Las direcciones de correo electrónico de los asistentes. |
|
asistencia
|
attendees.attendance | integer |
Indica si la asistencia es obligatoria, opcional o no obligatoria. |
|
estado
|
attendees.status | string |
Hace referencia al estado de los asistentes (Acción aceptada,rechazada/provisional/necesita) |
|
Fecha de creación
|
createdtime_millis | string |
Hora de creación del evento en GMT |
|
Tipo de notificación
|
notifyType | integer |
Notifica a los asistentes sobre el evento en función de su preferencia de notificación predeterminada. |
|
Organizador
|
organizer | string |
Detalles del organizador del evento. |
|
Es todo el día
|
isallday | boolean |
Si el evento es un evento de todo el día |
|
Transparencia
|
transparency | integer |
Si el evento debe agregarse a la programación de disponibilidad |
|
Modificado por
|
modifiedby | string |
Hace referencia al usuario que modificó el evento. |
|
Etiqueta de evento
|
etag | string |
Hace referencia a la etiqueta de evento para identificar el modo en el que se creó o modificó el evento. |
|
Id. único del calendario
|
caluid | string |
Identificador único del calendario |
|
Permitir reenvío
|
allowForwarding | boolean |
Indica si el evento se puede reenviar o no. |
|
Recordatorios
|
reminders | array of object | |
|
Tipo de recordatorio
|
reminders.action | string |
Hace referencia al tipo de recordatorio de eventos (correo electrónico, notificación, elemento emergente). |
|
Recuérdame en
|
reminders.minutes | string |
Hace referencia al tiempo de recordatorio en minutos. |
SingleCalendarRes
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Color
|
color | string |
Valor de color del calendario en hexadecimal |
|
Timezone
|
timezone | string |
Zona horaria del calendario |
|
Color del texto
|
textcolor | string |
Color de texto del calendario en hexadecimal |
|
Description
|
description | string |
la descripción del calendario |
|
Id. único del calendario
|
uid | string |
Identificador único del calendario |
|
Es el valor predeterminado
|
isdefault | boolean |
Si el calendario es un calendario predeterminado |
|
Incluir disponibilidad
|
include_infreebusy | boolean |
Estado de disponibilidad del calendario |
|
Nombre
|
name | string |
nombre del calendario |
|
Estado
|
status | boolean |
Estado del calendario |
EventNotifyRes
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Color
|
zc_data.color | string |
Valor de color de evento en hexadecimal |
|
Title
|
zc_data.title | string |
Título del evento |
|
Fecha de creación
|
zc_data.createdtime | string |
hora de creación del evento |
|
Zona horaria del usuario
|
zc_data.user_timezone | string |
Zona horaria del usuario |
|
Duración del evento
|
zc_data.duration | string |
Duración del evento |
|
Identificador único de evento
|
zc_data.uid | string |
Identificador único del evento |
|
Es todo el día
|
zc_data.isallday | boolean |
Si el evento es un evento de todo el día |
|
Ubicación
|
zc_data.location | string |
Ubicación del evento |
|
etag
|
zc_data.etag | string |
Hace referencia a la etiqueta de evento para identificar el modo en el que se creó o modificó el evento. |
|
Identificador único del calendario
|
zc_data.caluid | string |
Identificador único del calendario |
|
timezone
|
zc_data.dateandtime.timezone | string |
Zona horaria del evento |
|
hora de comienzo
|
zc_data.dateandtime.start | string |
Hora de inicio del formato de evento aaaaMMddTHHmmss |
|
hora de finalización
|
zc_data.dateandtime.end | string |
Hora de finalización del formato de evento aaaaMMddTHHmmss |
|
Evento modificado por última vez en
|
zc_data.lastmodifiedtime | string |
Fecha y hora en que se modificó por última vez el evento |