Compartilhar via

Calendário do Zoho

O Zoho Calendar é um calendário de negócios online que facilita o agendamento para você. Você pode usá-lo para se manter em cima da sua agenda e também compartilhar calendários com sua equipe para manter todos na mesma página.

Esse conector está disponível nos seguintes produtos e regiões:

Service Class Regions
Copilot Studio Premium Todas as regiões do Power Automate , exceto as seguintes:
     – Governo dos EUA (GCC)
     – Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Aplicativos Lógicos Standard Todas as regiões dos Aplicativos Lógicos , exceto as seguintes:
     – Regiões do Azure Governamental
     - Regiões do Azure China
     - Departamento de Defesa dos EUA (DoD)
Power Apps Premium Todas as regiões do Power Apps , exceto as seguintes:
     – Governo dos EUA (GCC)
     – Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Power Automate Premium Todas as regiões do Power Automate , exceto as seguintes:
     – Governo dos EUA (GCC)
     – Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Contato
Nome Calendário do Zoho
URL https://www.zoho.com/calendar/contact.html
Email zmintegration@zohomail.com
Metadados do conector
Publicador Zoho Mail
Site https://www.zoho.com/calendar/
Política de privacidade https://www.zoho.com/privacy.html
Categorias Colaboração; Produtividade

Calendário do Zoho

O Zoho Calendar é um calendário de negócios online que torna o agendamento fácil. O conector do Zoho Calendar oferece o poder de gerenciar seu calendário e executar ações repetitivas, como criar, editar, excluir eventos criando fluxos de trabalho usando o modelo de gatilho de ação.

Pré-requisitos

Uma conta do Zoho Calendar verificada. Clique aqui para criar sua primeira conta.

Como obter credenciais

Quando você cria uma nova conexão,

  • Selecione o domínio onde reside sua conta do Zoho.
  • Insira suas credenciais do Zoho Calendar.
  • Mesmo que o aplicativo de energia seja compartilhado com outro usuário, ele deverá criar uma nova conexão para começar a usá-lo.

A API de Calendário do Zoho usa o OAuth2.0 para autenticar e, portanto, nenhuma autenticação secundária é necessária após a configuração da conta.

Introdução ao conector

Siga as etapas abaixo para se conectar ao Zoho Calendar:

  • Faça logon em sua conta do Power Automate e clique em Criar no menu à esquerda.
  • Você pode optar por criar um fluxo de nuvem, um fluxo de área de trabalho ou um fluxo de negócios. Para se conectar ao Zoho Calendar, escolha o fluxo de nuvem automatizado.
  • Você pode criar um fluxo/modelo.
  • Insira os valores desejados para a respectiva ação.

Problemas e limitações conhecidos

  • Atualmente, não há suporte para eventos recorrentes no conector.

Erros e soluções comuns

  • Para evitar erros de autenticação, escolha o domínio em que sua conta do Zoho Calendar está hospedada.

perguntas frequentes

https://www.zoho.com/calendar/help/getting-started.html

Criando uma conexão

O conector dá suporte aos seguintes tipos de autenticação:
Default Parâmetros para criar conexão. Todas as regiões Não compartilhável

Padrão

Aplicável: todas as regiões

Parâmetros para criar conexão.

Essa não é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.

Nome Tipo Description Obrigatório
Selecione a região onde residem os dados da sua conta do Zoho. cadeia Selecione o domínio. Verdade

Limitações

Nome Chamadas Período de renovação
Chamadas à API por conexão 100 60 segundos

Ações

Atualizar evento

Atualiza um evento existente no calendário de um usuário.
Criar um novo evento

Adiciona um novo evento ao calendário do usuário.
Eventos de pesquisa

Obtém a lista de eventos em todos os calendários.
Excluir evento

Exclui um evento do calendário do usuário.
Obter detalhes do calendário

recupera os detalhes de um calendário específico usando a UID do Calendário.
Obter evento

Obtém os detalhes de um evento específico, como o título do evento, a data de início, a data de término etc., do calendário especificado de um usuário.
Obter lista de calendários

Obtém a lista de todos os calendários com a UID, o nome e o fuso horário do calendário.
Obter lista de eventos

Obtém a lista de todos os eventos entre o intervalo de datas especificado no formato yyyy-MM-ddTHH:mm:sszzz.

Atualizar evento

ID da operação:
Update_Event

Atualiza um evento existente no calendário de um usuário.

Parâmetros

Nome Chave Obrigatório Tipo Description
Calendário
 cuid True string

Especifique o calendário ou insira a ID exclusiva do calendário.
Event
 euid True string

Insira a ID exclusiva do evento.
Title
 title True string

Especificar o título do evento
Hora de início
 start True string

Especificar a hora de início do evento no formato yyyy-MM-ddTHH:mm:sszzz
Hora de término
 end True string

Especificar a hora de término do evento no formato yyyy-MM-ddTHH:mm:sszzz
Timezone
 timezone string

Especificar o fuso horário do evento
Cor
 color string

Escolha a cor do evento ou especifique o valor hexdecimal da cor
Description
 description string

Especificar a descrição do evento
Localização
 location string

Especificar o local do evento
URL
 url string

Especificar a URL do evento
Privado
 isprivate boolean

Especificar se o evento é privado ou não
É o dia todo
 isallday boolean

Especifique se o evento é um evento durante todo o dia.
ID do e-mail
 email string

Especificar os endereços de email dos participantes
Transparência
 transparency integer

Especifique se o evento deve ser adicionado à sua agenda de disponibilidade/disponibilidade.
Permitir Encaminhamento
 allowForwarding boolean

Especificar se o evento pode ser encaminhado ou não
tipo
 action string

Especifique o tipo de lembrete de evento (email, notificações etc.)
em minutos
 minutes integer

Especifique o tempo para lembrá-lo antes ou depois do evento (por exemplo: - 5 para antes, 5 para depois)

Retornos

Corpo
SingleEventRes

Criar um novo evento

ID da operação:
New_Event

Adiciona um novo evento ao calendário do usuário.

Parâmetros

Nome Chave Obrigatório Tipo Description
Calendário
 cuid True string

Especifique o calendário ou insira a ID exclusiva do calendário.
Title
 title True string

Especificar o título do evento
Hora de início
 start True string

Especificar a hora de início do evento no formato yyyy-MM-ddTHH:mm:sszzz
Hora de término
 end True string

Especificar a hora de término do evento no formato yyyy-MM-ddTHH:mm:sszzz
Timezone
 timezone string

Especificar o fuso horário do evento
Cor
 color string

Escolha a cor do evento ou especifique o valor hexdecimal da cor
Description
 description string

Especificar a descrição do evento
Localização
 location string

Especificar o local do evento
URL
 url string

Especificar a URL do evento
Privado
 isprivate boolean

Especificar se o evento é privado ou não
É o dia todo
 isallday boolean

Especifique se o evento é um evento durante todo o dia.
ID do e-mail
 email string

Especificar os endereços de email dos participantes
Transparência
 transparency integer

Especifique se o evento deve ser adicionado à sua agenda de disponibilidade/disponibilidade.
Permitir Encaminhamento
 allowForwarding boolean

Especificar se o evento pode ser encaminhado ou não
tipo
 action string

Especifique o tipo de lembrete de evento (email, notificações etc.)
em minutos
 minutes integer

Especifique o tempo para lembrá-lo antes ou depois do evento (por exemplo: - 5 para antes, 5 para depois)

Retornos

Corpo
SingleEventRes

Eventos de pesquisa

ID da operação:
Search_Events

Obtém a lista de eventos em todos os calendários.

Parâmetros

Nome Chave Obrigatório Tipo Description
Calendário
 cuid True string

Especifique o calendário ou insira a ID exclusiva do calendário.
Hora de início
 start True string

Especifique a hora de início do evento no formato yyyy-MM-ddTHH:mm:sszzz.
Hora de término
 end string

Especifique a hora de término do evento no formato yyyy-MM-ddTHH:mm:sszzz.
Pesquisar texto
 searchtext string

Especificar deve ser pesquisado no título

Retornos

Nome Caminho Tipo Description
busca
 search array of object

busca
ID exclusiva do evento
 search.uid string

Identificador exclusivo do evento
É o evento do dia todo
 search.isallday boolean

Se o evento é um evento durante todo o dia
ID exclusiva do calendário
 search.caluid string

Identificador exclusivo do calendário
Title
 search.title string

Título do evento
tipo
 search.type integer

tipo
Timezone
 search.dateandtime.timezone string

fuso horário do evento
hora de início
 search.dateandtime.start string

Hora de início do evento
hora de término
 search.dateandtime.end string

Hora de término do evento

Excluir evento

ID da operação:
Delete_Event

Exclui um evento do calendário do usuário.

Parâmetros

Nome Chave Obrigatório Tipo Description
Calendário
 cuid True string

Especifique o calendário ou insira a ID exclusiva do calendário.
Event
 euid True string

Insira a ID exclusiva do evento.

Retornos

Nome Caminho Tipo Description
events
 events array of object

events
uid
 events.uid string

uid
recurrenceid
 events.recurrenceid string

recurrenceid

Obter detalhes do calendário

ID da operação:
Get_Calendar_Details

recupera os detalhes de um calendário específico usando a UID do Calendário.

Parâmetros

Nome Chave Obrigatório Tipo Description
Calendário
 cuid True string

Especifique o calendário ou insira a ID exclusiva do calendário.

Retornos

Corpo
SingleCalendarRes

Obter evento

ID da operação:
Get_Event

Obtém os detalhes de um evento específico, como o título do evento, a data de início, a data de término etc., do calendário especificado de um usuário.

Parâmetros

Nome Chave Obrigatório Tipo Description
Calendário
 cuid True string

Especifique o calendário ou insira a ID exclusiva do calendário.
Event
 euid True string

Insira a ID exclusiva do evento.

Retornos

Corpo
SingleEventRes

Obter lista de calendários

ID da operação:
Get_Calendar_List

Obtém a lista de todos os calendários com a UID, o nome e o fuso horário do calendário.

Retornos

Nome Caminho Tipo Description
calendars
 calendars array of SingleCalendarRes

calendars

Obter lista de eventos

ID da operação:
Get_Event_List

Obtém a lista de todos os eventos entre o intervalo de datas especificado no formato yyyy-MM-ddTHH:mm:sszzz.

Parâmetros

Nome Chave Obrigatório Tipo Description
Calendário
 cuid True string

Especifique o calendário ou insira a ID exclusiva do calendário.
Por Instância
 byinstance True boolean

Recupera todas as instâncias de eventos de repetição como um evento separado quando ele é definido como true. O intervalo de datas não deve exceder 31 dias.
Hora de início
 start True string

Especificar a hora de início no formato yyyy-MM-ddThh:mm:sszzz
Hora de término
 end True string

Especificar a hora de término no formato yyyy-MM-ddThh:mm:sszzz
Timezone
 timezone string

Especificar o fuso horário do evento

Retornos

Nome Caminho Tipo Description
events
 events array of SingleEventRes

events

Gatilhos

Editar notificação de evento

Quando um evento é atualizado para um calendário
Excluir notificação de evento

Quando um evento é excluído em um calendário
Nova notificação de evento

Quando um evento é adicionado a um calendário

Editar notificação de evento

ID da operação:
Edit_Event_Notification

Quando um evento é atualizado para um calendário

Retornos

Corpo
EventNotifyRes

Excluir notificação de evento

ID da operação:
Delete_Event_Notification

Quando um evento é excluído em um calendário

Retornos

Nome Caminho Tipo Description
ID exclusiva do evento
 zc_data.uid string

Identificador exclusivo do evento
ID exclusiva do calendário
 zc_data.caluid string

Identificador exclusivo do calendário

Nova notificação de evento

ID da operação:
New_Event_Notification

Quando um evento é adicionado a um calendário

Retornos

Corpo
EventNotifyRes

Definições

SingleEventRes

Nome Caminho Tipo Description
Cor
 color string

Valor da cor do evento em hexadecimal
Title
 title string

Título do evento
Duração
 duration string

Duração do evento
ID exclusiva do evento
 uid string

Identificador exclusivo do evento
Evento criado por
 createdby string

O usuário que criou o evento
Aprovado
 isApproved boolean

Se o evento criado é aprovado.
Localização
 location string

O local do evento
URL
 url string

A URL do evento
URL de Exibição de Evento
 viewEventURL string

A URL exclusiva do evento.
timezone
 dateandtime.timezone string

Fuso horário do evento
hora de início
 dateandtime.start string

Hora de início do evento
hora de término
 dateandtime.end string

Hora de término do evento
Evento modificado pela última vez em
 lastmodifiedtime string

A data e a hora em que o evento foi modificado pela última vez
É privado
 isprivate boolean

Se o evento é um evento privado ou não
Participantes
 attendees array of object

Participantes do evento
nome de exibição
 attendees.dName string

Exibir nomes de participantes
ID do e-mail
 attendees.email string

Os endereços de email dos participantes.
participação
 attendees.attendance integer

Se o atendimento é obrigatório, opcional ou não é necessário.
status
 attendees.status string

Refere-se ao status dos participantes (Ação Aceita/Recusada/Provisória/Precisa)
Criado em
 createdtime_millis string

A hora de criação do evento em GMT
Tipo de notificação
 notifyType integer

Notifica os participantes sobre o evento com base em sua preferência de notificação padrão.
Organizador
 organizer string

Detalhes do organizador do evento.
É o evento do dia todo
 isallday boolean

Se o evento é um evento durante todo o dia
Transparência
 transparency integer

Se o evento deve ser adicionado à agenda de disponibilidade/disponibilidade
Modificado por
 modifiedby string

Refere-se ao usuário que modificou o evento.
Marca de evento
 etag string

Refere-se à marca de evento para identificar o modo no qual o evento foi criado/modificado.
ID exclusiva do calendário
 caluid string

Identificador exclusivo do calendário
Permitir encaminhamento
 allowForwarding boolean

Se o evento pode ser encaminhado ou não.
Lembretes
 reminders array of object
Tipo de lembrete
 reminders.action string

Refere-se ao tipo de lembrete de evento (email, notificação, pop-up.)
Lembre-me em
 reminders.minutes string

Refere-se ao tempo de lembrete em minutos.

SingleCalendarRes

Nome Caminho Tipo Description
Cor
 color string

Valor de cor do calendário em hexadecimal
Timezone
 timezone string

Fuso horário do calendário
Cor do texto
 textcolor string

Cor do texto do calendário em hexadecimal
Description
 description string

a descrição do calendário
ID exclusiva do calendário
 uid string

Identificador exclusivo do calendário
É o padrão
 isdefault boolean

Se o calendário é um calendário padrão
Incluir disponibilidade/disponibilidade
 include_infreebusy boolean

Status gratuito/ocupado do calendário
Nome
 name string

nome do calendário
Situação
 status boolean

Status do calendário

EventNotifyRes

Nome Caminho Tipo Description
Cor
 zc_data.color string

Valor da cor do evento em hexadecimal
Title
 zc_data.title string

Título do evento
Criado em
 zc_data.createdtime string

tempo de evento criado
Fuso horário do usuário
 zc_data.user_timezone string

Fuso horário do usuário
Duração do evento
 zc_data.duration string

Duração do evento
ID exclusiva do evento
 zc_data.uid string

Identificador exclusivo do evento
É o evento do dia todo
 zc_data.isallday boolean

Se o evento é um evento durante todo o dia
Localização
 zc_data.location string

Local do evento
etag
 zc_data.etag string

Refere-se à marca de evento para identificar o modo no qual o evento foi criado/modificado.
ID exclusiva do calendário
 zc_data.caluid string

Identificador exclusivo do calendário
timezone
 zc_data.dateandtime.timezone string

Fuso horário do evento
hora de início
 zc_data.dateandtime.start string

Hora de início do formato de evento yyyyMMddTHHmmss
hora de término
 zc_data.dateandtime.end string

Hora de término do formato de evento yyyyMMddTHHmmss
Evento modificado pela última vez em
 zc_data.lastmodifiedtime string

A data e a hora em que o evento foi modificado pela última vez