Partilhar via


Turnos para o Microsoft Teams

Para os gestores, planeje horários de turnos, transmita turnos abertos e não preenchidos para sua equipe. Para os membros da equipe, visualize facilmente seus turnos e faça solicitações de alteração de horário (troca/oferta/folga).

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

Serviço Class Regiões
Estúdio Copiloto Standard Todas as regiões do Power Automatic , exceto as seguintes:
     - China Cloud operado pela 21Vianet
Aplicações Lógicas Standard Todas as regiões do Logic Apps , exceto as seguintes:
     - Regiões do Azure China
Aplicações Power Standard Todas as regiões do Power Apps , exceto as seguintes:
     - China Cloud operado pela 21Vianet
Automatize o poder Standard Todas as regiões do Power Automatic , exceto as seguintes:
     - China Cloud operado pela 21Vianet
Contato
Nome Microsoft
URL https://support.microsoft.com/teams
Metadados do conector
Editora Microsoft
Sítio Web https://docs.microsoft.com/en-us/microsoftteams/expand-teams-across-your-org/shifts-for-teams-landing-page
Política de privacidade https://privacy.microsoft.com/privacystatement
Categorias Produtividade

O Shifts in Microsoft Teams é uma ferramenta de gestão de agendas que o ajuda a criar, atualizar e gerir agendas para a sua equipa.

O Shifts + Power Automate permite-lhe obter informações do Shifts e criar fluxos de trabalho personalizados com outras aplicações e realizar operações em escala. Automatize processos-chave com pouco ou nenhum código.

Problemas conhecidos e limitações com gatilhos

  • Não há suporte para gatilhos na região GCC.

A criar uma ligação

O conector suporta os seguintes tipos de autenticação:

Predefinição 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.

Esta conexão não é compartilhável. Se o aplicativo avançado for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.

Limites de Limitação

Name Chamadas Período de Renovação
Chamadas de API por conexão 100 60 segundos

Ações

Aprovar um pedido de Folga

Esta operação permite que os gestores aprovem um pedido de Folga.

Aprovar uma solicitação de Swap Shifts

Esta operação permite que um usuário aprove uma solicitação de Swap Shifts.

Aprovar uma solicitação de turno de oferta

Esta operação permite que os destinatários/gerentes aprovem uma solicitação de Turno de Oferta.

Aprovar uma solicitação Open Shift

Esta operação permite que os gerentes aprovem uma solicitação Open Shift.

Atualizar um turno aberto

Atualize um turno aberto em uma agenda.

Criar um novo Open Shift

Crie um novo Open Shift em uma agenda.

Criar um novo turno

Esta operação cria um novo Shift e atribui-o a um membro da equipa

Criar uma nova instância de tempo livre

Essa operação cria uma nova instância de Folga e a atribui a um membro da equipe

Excluir um turno

Esta operação exclui um Shift usando o ID exclusivo do Shift.

Excluir um turno aberto

Esta operação exclui um Open Shift.

Excluir uma instância de tempo livre

Esta operação exclui um Time Off usando seu ID exclusivo.

Listar todas as instâncias de tempo livre em uma equipe

Esta operação retorna todas as instâncias de Folga em uma Agenda

Listar todas as solicitações de folga em uma equipe

Esta operação retorna todas as solicitações de folga em uma agenda.

Listar todas as solicitações de Swap Shifts em uma equipe

Esta operação retorna todas as solicitações de Swap Shifts em um Schedule.

Listar todas as solicitações de turno de oferta em uma equipe

Esta operação retorna todas as solicitações de Turno de Oferta em uma Programação.

Listar todas as solicitações Open Shift em uma equipe

Esta operação retorna todas as solicitações de alteração Open Shift em uma agenda.

Listar todos os grupos de agendamento em uma equipe

Esta operação retorna todos os grupos de agendamento em uma agenda.

Listar todos os motivos de folga em uma equipe

Esta operação devolve a lista de Razões de Folga associadas a uma equipa.

Listar todos os tempos de folga das minhas equipes

Esta operação retorna momentos em que as pessoas estão fora de todas as suas equipes.

Listar todos os turnos abertos das minhas equipes

Esta operação retorna Open Shifts que precisam ser preenchidos de todas as suas equipes.

Listar todos os turnos abertos em uma equipe

Esta operação retorna todos os turnos abertos em uma equipe.

Listar todos os turnos das minhas equipes

Esta operação retorna Turnos atribuídos de todas as suas equipes.

Listar todos os turnos de uma equipe

Esta operação retorna todos os turnos atribuídos aos membros de uma equipe

Obtenha os detalhes de uma agenda

Esta operação retorna detalhes de uma Agenda usando a ID exclusiva da Agenda.

Obtenha um turno aberto

Esta operação retorna detalhes para um Open Shift.

Obter um Grupo de Agendamento

Esta operação retorna detalhes para um Grupo de Agendamento usando sua ID exclusiva.

Obter um pedido de Mudança de Oferta

Esta operação retorna uma solicitação de Offer Shift por ID.

Obter um pedido de Swap Shifts

Esta operação retorna uma solicitação de Swap Shifts por ID.

Obter um pedido Open Shift

Esta operação retorna uma solicitação de alteração Open Shift por ID.

Obter um turno

Esta operação retorna detalhes de um Shift usando o ID exclusivo do Shift.

Obter uma instância de tempo livre

Esta operação retorna detalhes para um Time Off usando seu ID exclusivo.

Receba um pedido de folga

Esta operação devolve um pedido de Folga por ID.

Recusar um pedido de Folga

Esta operação permite que os gerentes recusem uma solicitação de folga.

Recusar um pedido de Mudança de Oferta

Esta operação permite que os usuários recusem uma solicitação de Offer Shift.

Recusar um pedido de Swap Shifts

Esta operação permite que os usuários recusem uma solicitação de Swap Shifts.

Recusar um pedido Open Shift

Esta operação permite que os gestores recusem um pedido de Open Shift.

Aprovar um pedido de Folga

Esta operação permite que os gestores aprovem um pedido de Folga.

Parâmetros

Name Chave Necessário Tipo Description
Equipa
teamId True string

Adicionar ID da Equipa

ID de solicitação de folga
timeOffRequestId True string

O ID exclusivo da solicitação de folga

Mensagem do Gestor
message string

Uma mensagem do gestor para o remetente/destinatário quando um pedido é aceite.

Aprovar uma solicitação de Swap Shifts

Esta operação permite que um usuário aprove uma solicitação de Swap Shifts.

Parâmetros

Name Chave Necessário Tipo Description
Equipa
teamId True string

Adicionar ID da Equipa

Trocar turnos Alterar ID do Pedido
swapShiftsChangeRequestId True string

O ID exclusivo do pedido

Mensagem do destinatário/gestor
message string

Uma mensagem quando um pedido é aceite.

Aprovar uma solicitação de turno de oferta

Esta operação permite que os destinatários/gerentes aprovem uma solicitação de Turno de Oferta.

Parâmetros

Name Chave Necessário Tipo Description
Equipa
teamId True string

Adicionar ID da Equipa

ID de solicitação de turno da oferta
offerShiftRequestId True string

O ID exclusivo da solicitação de turno de oferta

Mensagem do destinatário/gestor
message string

Uma mensagem quando um pedido é aceite.

Aprovar uma solicitação Open Shift

Esta operação permite que os gerentes aprovem uma solicitação Open Shift.

Parâmetros

Name Chave Necessário Tipo Description
Equipa
teamId True string

Adicionar ID da Equipa

Abrir ID de Pedido de Alteração de Turno
openShiftChangeRequestId True string

O ID exclusivo do pedido

Mensagem do Gestor
message string

Uma mensagem do gestor para o remetente/destinatário quando um pedido é aceite.

Atualizar um turno aberto

Atualize um turno aberto em uma agenda.

Parâmetros

Name Chave Necessário Tipo Description
Equipa
teamId True string

Adicionar ID da Equipa

Abrir ID de turno
openShiftId True string

O ID exclusivo do Open Shift.

Agendamento de ID de Grupo
schedulingGroupId string

Agendamento de ID de Grupo

Nome de exibição
displayName string

Nome de exibição

Observações
notes string

Observações

Hora de Início
startDateTime True date-time

aaaa-MM-ddTHH:mm:ss.fffZ (formato UTC)

Hora de Término
endDateTime True date-time

aaaa-MM-ddTHH:mm:ss.fffZ (formato UTC)

Theme
theme string

Cor do tema.

Abrir contagem de slots
openSlotCount True integer

Abrir contagem de slots

É pago
isPaid boolean

É pago

Hora de Início
startDateTime True date-time

aaaa-MM-ddTHH:mm:ss.fffZ (formato UTC)

Hora de Término
endDateTime True date-time

aaaa-MM-ddTHH:mm:ss.fffZ (formato UTC)

Código
code string

Código

Nome de exibição
displayName string

Nome de exibição

Devoluções

Entidade Open Shift

Abrir turno
OpenShiftResponse

Criar um novo Open Shift

Crie um novo Open Shift em uma agenda.

Parâmetros

Name Chave Necessário Tipo Description
Equipa
teamId True string

Adicionar ID da Equipa

Agendamento de ID de Grupo
schedulingGroupId string

Agendamento de ID de Grupo

Nome de exibição
displayName string

Nome de exibição

Observações
notes string

Observações

Hora de Início
startDateTime True date-time

aaaa-MM-ddTHH:mm:ss.fffZ (formato UTC)

Hora de Término
endDateTime True date-time

aaaa-MM-ddTHH:mm:ss.fffZ (formato UTC)

Theme
theme string

Cor do tema.

Abrir contagem de slots
openSlotCount True integer

Abrir contagem de slots

É pago
isPaid boolean

É pago

Hora de Início
startDateTime True date-time

aaaa-MM-ddTHH:mm:ss.fffZ (formato UTC)

Hora de Término
endDateTime True date-time

aaaa-MM-ddTHH:mm:ss.fffZ (formato UTC)

Código
code string

Código

Nome de exibição
displayName string

Nome de exibição

Devoluções

Entidade Open Shift

Abrir turno
OpenShiftResponse

Criar um novo turno

Esta operação cria um novo Shift e atribui-o a um membro da equipa

Parâmetros

Name Chave Necessário Tipo Description
Equipa
teamId True string

Adicionar ID da Equipa

Agendamento de ID de Grupo
schedulingGroupId string

Agendamento de ID de Grupo

Nome de exibição
displayName string

Nome de exibição

Observações
notes string

Notas de mudança

Hora de Início
startDateTime True date-time

aaaa-MM-ddTHH:mm:ss.fffZ (formato UTC)

Hora de Término
endDateTime True date-time

aaaa-MM-ddTHH:mm:ss.fffZ (formato UTC)

Theme
theme True string

Cor do tema.

É pago
isPaid boolean

É pago

Hora de Início
startDateTime True date-time

aaaa-MM-ddTHH:mm:ss.fffZ (formato UTC)

Hora de Término
endDateTime True date-time

aaaa-MM-ddTHH:mm:ss.fffZ (formato UTC)

Código
code string

Código

Nome de exibição
displayName string

Nome de exibição

ID de utilizador
userId True string

Atribuído ao ID de usuário

Devoluções

Entidade de turno.

Criar uma nova instância de tempo livre

Essa operação cria uma nova instância de Folga e a atribui a um membro da equipe

Parâmetros

Name Chave Necessário Tipo Description
Equipa
teamId True string

Adicionar ID da Equipa

Motivo do tempo livre
timeOffReasonId True string

ID do motivo de folga

Hora de Início
startDateTime True date-time

aaaa-MM-ddTHH:mm:ss.fffZ (formato UTC)

Hora de Término
endDateTime True date-time

aaaa-MM-ddTHH:mm:ss.fffZ (formato UTC)

Theme
theme True string

Cor do tema.

ID de utilizador
userId True string

Atribuído ao ID de usuário

Devoluções

Entidade de folga.

Licença
TimeOffResponse

Excluir um turno

Esta operação exclui um Shift usando o ID exclusivo do Shift.

Parâmetros

Name Chave Necessário Tipo Description
Equipa
teamId True string

Adicionar ID da Equipa

ID do turno
shiftId True string

O ID exclusivo do Shift.

Excluir um turno aberto

Esta operação exclui um Open Shift.

Parâmetros

Name Chave Necessário Tipo Description
Equipa
teamId True string

Adicionar ID da Equipa

Abrir ID de turno
openShiftId True string

O ID exclusivo do Open Shift.

Excluir uma instância de tempo livre

Esta operação exclui um Time Off usando seu ID exclusivo.

Parâmetros

Name Chave Necessário Tipo Description
Equipa
teamId True string

Adicionar ID da Equipa

ID de folga
timeOffId True string

O ID exclusivo do Time Off.

Listar todas as instâncias de tempo livre em uma equipe

Esta operação retorna todas as instâncias de Folga em uma Agenda

Parâmetros

Name Chave Necessário Tipo Description
Equipa
teamId True string

Adicionar ID da Equipa

A partir da hora de início
startTime date-time

aaaa-MM-ddTHH:mm:ss.fffZ (formato UTC)

Para Terminar a Hora
endTime date-time

aaaa-MM-ddTHH:mm:ss.fffZ (formato UTC)

Tamanho da página
$top integer

Itens por página (ativar Paginação em .../Configurações)

Devoluções

Name Caminho Tipo Description
Lista de instâncias de tempo livre
value array of TimeOffResponse

Lista de instâncias de folga

Listar todas as solicitações de folga em uma equipe

Esta operação retorna todas as solicitações de folga em uma agenda.

Parâmetros

Name Chave Necessário Tipo Description
Equipa
teamId True string

Adicionar ID da Equipa

Tamanho da página
$top integer

Itens por página (ativar Paginação em .../Configurações)

Estado do pedido
state string

Filtro de estado de solicitação

Devoluções

Name Caminho Tipo Description
Lista de Pedidos de Folga
value array of TimeOffRequestResponse

Lista de pedidos de folga.

Listar todas as solicitações de Swap Shifts em uma equipe

Esta operação retorna todas as solicitações de Swap Shifts em um Schedule.

Parâmetros

Name Chave Necessário Tipo Description
Equipa
teamId True string

Adicionar ID da Equipa

Tamanho da página
$top integer

Itens por página (ativar Paginação em .../Configurações)

Estado do pedido
state string

Filtro de estado de solicitação

Devoluções

Name Caminho Tipo Description
Lista de solicitações de alteração de turnos de troca
value array of SwapShiftsChangeRequestResponse

Lista de solicitações de alteração de turnos de troca.

Listar todas as solicitações de turno de oferta em uma equipe

Esta operação retorna todas as solicitações de Turno de Oferta em uma Programação.

Parâmetros

Name Chave Necessário Tipo Description
Equipa
teamId True string

Adicionar ID da Equipa

Tamanho da página
$top integer

Itens por página (ativar Paginação em .../Configurações)

Estado do pedido
state string

Filtro de estado de solicitação

Devoluções

Name Caminho Tipo Description
Lista de solicitações de turno de oferta
value array of OfferShiftRequestResponse

Lista de solicitações de turno de oferta.

Listar todas as solicitações Open Shift em uma equipe

Esta operação retorna todas as solicitações de alteração Open Shift em uma agenda.

Parâmetros

Name Chave Necessário Tipo Description
Equipa
teamId True string

Adicionar ID da Equipa

Tamanho da página
$top integer

Itens por página (ativar Paginação em .../Configurações)

Estado do pedido
state string

Filtro de estado de solicitação

Devoluções

Name Caminho Tipo Description
Abrir Lista de Pedidos de Alteração de Turno
value array of OpenShiftChangeRequestResponse

Lista de solicitações de alteração de turno aberto.

Listar todos os grupos de agendamento em uma equipe

Esta operação retorna todos os grupos de agendamento em uma agenda.

Parâmetros

Name Chave Necessário Tipo Description
Equipa
teamId True string

Adicionar ID da Equipa

Tamanho da página
$top integer

Itens por página (ativar Paginação em .../Configurações)

Devoluções

Name Caminho Tipo Description
Lista de Grupos de Agendamento
value array of SchedulingGroupResponse

Lista de Grupos de Agendamento.

Listar todos os motivos de folga em uma equipe

Esta operação devolve a lista de Razões de Folga associadas a uma equipa.

Parâmetros

Name Chave Necessário Tipo Description
Equipa
teamId True string

Adicionar ID da Equipa

Tamanho da página
$top integer

Itens por página (ativar Paginação em .../Configurações)

Devoluções

A lista de motivos de folga.

Lista de motivos de folga associados a uma equipe
GetTimeOffReasonsResponse

Listar todos os tempos de folga das minhas equipes

Esta operação retorna momentos em que as pessoas estão fora de todas as suas equipes.

Parâmetros

Name Chave Necessário Tipo Description
A partir da hora de início
startTime date-time

aaaa-MM-ddTHH:mm:ss.fffZ (formato UTC)

Para Terminar a Hora
endTime date-time

aaaa-MM-ddTHH:mm:ss.fffZ (formato UTC)

Nome de exibição do usuário
assignedToUserName string

Atribuído ao usuário com nome

Tamanho da página
$top integer

Quantas vezes para buscar

Devoluções

Name Caminho Tipo Description
Tempos fora da lista
value array of TimeOffResponse

Lista de Tempos de Folga

Listar todos os turnos abertos das minhas equipes

Esta operação retorna Open Shifts que precisam ser preenchidos de todas as suas equipes.

Parâmetros

Name Chave Necessário Tipo Description
A partir da hora de início
startTime date-time

aaaa-MM-ddTHH:mm:ss.fffZ (formato UTC)

Para Terminar a Hora
endTime date-time

aaaa-MM-ddTHH:mm:ss.fffZ (formato UTC)

Tamanho da página
$top integer

Itens por página (ativar Paginação em .../Configurações)

Devoluções

Name Caminho Tipo Description
Abrir lista de turnos
value array of OpenShiftResponse

Lista de turnos abertos

Listar todos os turnos abertos em uma equipe

Esta operação retorna todos os turnos abertos em uma equipe.

Parâmetros

Name Chave Necessário Tipo Description
Equipa
teamId True string

Adicionar ID da Equipa

A partir da hora de início
startTime date-time

aaaa-MM-ddTHH:mm:ss.fffZ (formato UTC)

Para Terminar a Hora
endTime date-time

aaaa-MM-ddTHH:mm:ss.fffZ (formato UTC)

Tamanho da página
$top integer

Itens por página (ativar Paginação em .../Configurações)

Devoluções

Name Caminho Tipo Description
Abrir lista de turnos
value array of OpenShiftResponse

Lista de turnos abertos

Listar todos os turnos das minhas equipes

Esta operação retorna Turnos atribuídos de todas as suas equipes.

Parâmetros

Name Chave Necessário Tipo Description
A partir da hora de início
startTime date-time

aaaa-MM-ddTHH:mm:ss.fffZ (formato UTC)

Para Terminar a Hora
endTime date-time

aaaa-MM-ddTHH:mm:ss.fffZ (formato UTC)

Nome de exibição do usuário
assignedToUserName string

Atribuído ao usuário com nome

Tamanho da página
$top integer

Itens por página (ativar Paginação em .../Configurações)

Devoluções

Name Caminho Tipo Description
Lista de turnos
value array of ShiftResponse

Lista de turnos

Listar todos os turnos de uma equipe

Esta operação retorna todos os turnos atribuídos aos membros de uma equipe

Parâmetros

Name Chave Necessário Tipo Description
Equipa
teamId True string

Adicionar ID da Equipa

A partir da hora de início
startTime date-time

aaaa-MM-ddTHH:mm:ss.fffZ (formato UTC)

Para Terminar a Hora
endTime date-time

aaaa-MM-ddTHH:mm:ss.fffZ (formato UTC)

Tamanho da página
$top integer

Itens por página (ativar Paginação em .../Configurações)

Devoluções

Name Caminho Tipo Description
Lista de turnos
value array of ShiftResponse

Lista de turnos

Obtenha os detalhes de uma agenda

Esta operação retorna detalhes de uma Agenda usando a ID exclusiva da Agenda.

Parâmetros

Name Chave Necessário Tipo Description
Equipa
teamId True string

Adicionar ID da Equipa

Devoluções

Entidade de programação.

Obtenha um turno aberto

Esta operação retorna detalhes para um Open Shift.

Parâmetros

Name Chave Necessário Tipo Description
Equipa
teamId True string

Adicionar ID da Equipa

Abrir ID de turno
openShiftId True string

O ID exclusivo do Open Shift.

Devoluções

Entidade Open Shift

Abrir turno
OpenShiftResponse

Obter um Grupo de Agendamento

Esta operação retorna detalhes para um Grupo de Agendamento usando sua ID exclusiva.

Parâmetros

Name Chave Necessário Tipo Description
Equipa
teamId True string

Adicionar ID da Equipa

Agendamento de ID de Grupo
schedulingGroupId True string

A ID exclusiva do Grupo de Agendamento.

Devoluções

Entidade do Grupo de Agendamento

Grupo de Agendamento
SchedulingGroupResponse

Obter um pedido de Mudança de Oferta

Esta operação retorna uma solicitação de Offer Shift por ID.

Parâmetros

Name Chave Necessário Tipo Description
Equipa
teamId True string

Adicionar ID da Equipa

ID de solicitação de turno da oferta
offerShiftRequestId True string

O ID exclusivo da solicitação de turno de oferta

Devoluções

Entidade de solicitação de turno de oferta

Solicitação de turno de oferta
OfferShiftRequestResponse

Obter um pedido de Swap Shifts

Esta operação retorna uma solicitação de Swap Shifts por ID.

Parâmetros

Name Chave Necessário Tipo Description
Equipa
teamId True string

Adicionar ID da Equipa

Trocar turnos Alterar ID do Pedido
swapShiftsChangeRequestId True string

O ID exclusivo do pedido

Devoluções

Entidade de solicitação de turno de troca

Solicitação de turno de troca
SwapShiftsChangeRequestResponse

Obter um pedido Open Shift

Esta operação retorna uma solicitação de alteração Open Shift por ID.

Parâmetros

Name Chave Necessário Tipo Description
Equipa
teamId True string

Adicionar ID da Equipa

Abrir ID de Pedido de Alteração de Turno
openShiftChangeRequestId True string

O ID exclusivo do pedido

Devoluções

Entidade de solicitação de alteração de turno aberto

Abrir Pedido de Alteração de Turno
OpenShiftChangeRequestResponse

Obter um turno

Esta operação retorna detalhes de um Shift usando o ID exclusivo do Shift.

Parâmetros

Name Chave Necessário Tipo Description
Equipa
teamId True string

Adicionar ID da Equipa

ID do turno
shiftId True string

O ID exclusivo do Shift.

Devoluções

Entidade de turno.

Obter uma instância de tempo livre

Esta operação retorna detalhes para um Time Off usando seu ID exclusivo.

Parâmetros

Name Chave Necessário Tipo Description
Equipa
teamId True string

Adicionar ID da Equipa

ID de folga
timeOffId True string

O ID exclusivo do Time Off.

Devoluções

Entidade de folga.

Licença
TimeOffResponse

Receba um pedido de folga

Esta operação devolve um pedido de Folga por ID.

Parâmetros

Name Chave Necessário Tipo Description
Equipa
teamId True string

Adicionar ID da Equipa

ID de solicitação de folga
timeOffRequestId True string

O ID exclusivo da solicitação de folga

Devoluções

Entidade de solicitação de folga

Pedido de Licença
TimeOffRequestResponse

Recusar um pedido de Folga

Esta operação permite que os gerentes recusem uma solicitação de folga.

Parâmetros

Name Chave Necessário Tipo Description
Equipa
teamId True string

Adicionar ID da Equipa

ID de solicitação de folga
timeOffRequestId True string

O ID exclusivo da solicitação de folga

Mensagem do Gestor
message string

Uma mensagem do gerente para o remetente/destinatário quando uma solicitação é recusada.

Recusar um pedido de Mudança de Oferta

Esta operação permite que os usuários recusem uma solicitação de Offer Shift.

Parâmetros

Name Chave Necessário Tipo Description
Equipa
teamId True string

Adicionar ID da Equipa

ID de solicitação de turno da oferta
offerShiftRequestId True string

O ID exclusivo da solicitação de turno de oferta

Mensagem do destinatário/gestor
message string

Uma mensagem quando uma solicitação é recusada.

Recusar um pedido de Swap Shifts

Esta operação permite que os usuários recusem uma solicitação de Swap Shifts.

Parâmetros

Name Chave Necessário Tipo Description
Equipa
teamId True string

Adicionar ID da Equipa

Trocar turnos Alterar ID do Pedido
swapShiftsChangeRequestId True string

O ID exclusivo do pedido

Mensagem do destinatário/gestor
message string

Uma mensagem quando uma solicitação é recusada.

Recusar um pedido Open Shift

Esta operação permite que os gestores recusem um pedido de Open Shift.

Parâmetros

Name Chave Necessário Tipo Description
Equipa
teamId True string

Adicionar ID da Equipa

Abrir ID de Pedido de Alteração de Turno
openShiftChangeRequestId True string

O ID exclusivo do pedido

Mensagem do Gestor
message string

Uma mensagem do gerente para o remetente/destinatário quando uma solicitação é recusada.

Acionadores

Quando um Shift é criado, atualizado ou excluído

Esta operação é acionada quando um Shift é criado, atualizado ou excluído.

Quando uma solicitação de folga é criada, atualizada ou excluída

Esta operação é acionada quando uma solicitação de tempo de folga é criada, atualizada ou excluída.

Quando uma solicitação de turno de oferta é criada, atualizada ou excluída

Essa operação é acionada quando uma solicitação de Mudança de Oferta é criada, atualizada ou excluída.

Quando uma solicitação Open Shift é criada, atualizada ou excluída

Esta operação é acionada quando uma solicitação Open Shift é criada, atualizada ou excluída.

Quando uma solicitação Swap Shifts é criada, atualizada ou excluída

Esta operação é acionada quando uma solicitação Swap Shifts é criada, atualizada ou excluída.

Quando um Shift é criado, atualizado ou excluído

Esta operação é acionada quando um Shift é criado, atualizado ou excluído.

Parâmetros

Name Chave Necessário Tipo Description
Equipa
teamId True string

Adicionar ID da Equipa

Devoluções

Carga útil do back-end contendo metadados de assinatura, bem como dados

Quando uma solicitação de folga é criada, atualizada ou excluída

Esta operação é acionada quando uma solicitação de tempo de folga é criada, atualizada ou excluída.

Parâmetros

Name Chave Necessário Tipo Description
Equipa
teamId True string

Adicionar ID da Equipa

Devoluções

Carga útil do back-end contendo metadados de assinatura, bem como dados

Quando uma solicitação de turno de oferta é criada, atualizada ou excluída

Essa operação é acionada quando uma solicitação de Mudança de Oferta é criada, atualizada ou excluída.

Parâmetros

Name Chave Necessário Tipo Description
Equipa
teamId True string

Adicionar ID da Equipa

Devoluções

Carga útil do back-end contendo metadados de assinatura, bem como dados

Quando uma solicitação Open Shift é criada, atualizada ou excluída

Esta operação é acionada quando uma solicitação Open Shift é criada, atualizada ou excluída.

Parâmetros

Name Chave Necessário Tipo Description
Equipa
teamId True string

Adicionar ID da Equipa

Devoluções

Carga útil do back-end contendo metadados de assinatura, bem como dados

Quando uma solicitação Swap Shifts é criada, atualizada ou excluída

Esta operação é acionada quando uma solicitação Swap Shifts é criada, atualizada ou excluída.

Parâmetros

Name Chave Necessário Tipo Description
Equipa
teamId True string

Adicionar ID da Equipa

Devoluções

Carga útil do back-end contendo metadados de assinatura, bem como dados

Definições

WebhookPushResponse

Carga útil do back-end contendo metadados de assinatura, bem como dados

Name Caminho Tipo Description
valor
value array of WebhookNotificationEntity

Lista de valores

WebhookNotificationEntity

Name Caminho Tipo Description
Alterar Tipo
changeType string

Tipo de alteração de recurso (criado/atualizado/excluído).

resourceData
resourceData WebhookPushResponseResourceEntity

WebhookPushResponseResourceEntity

Name Caminho Tipo Description
ID do Recurso
id string

ID do recurso atualizado.

ID da Equipa
teamId string

ID da equipe onde a atualização aconteceu.

ScheduleResponse

Entidade de programação.

Name Caminho Tipo Description
ID da agenda
id string

A ID exclusiva da Agenda.

Agendar Fuso Horário
timeZone string

O fuso horário da agenda.

Status da provisão de cronograma
provisionStatus string

O status de provisão do cronograma.

Código de status de provisão de cronograma
provisionStatusCode string

O código de status da provisão da agenda.

TimeOffResponse

Entidade de folga.

Name Caminho Tipo Description
ID
id string

O ID exclusivo do Time Off.

Data de Criação Hora
createdDateTime date-time

aaaa-MM-ddTHH:mm:ss.fffZ (formato UTC)

Data e Hora da Modificação
lastModifiedDateTime date-time

aaaa-MM-ddTHH:mm:ss.fffZ (formato UTC)

Atribuído ao ID de usuário
userId string

Atribuído ao ID de usuário.

Informação do Utilizador
userInfo UserInfo

Informação do Utilizador

Informação da Equipa
teamInfo TeamInfo

Informação da Equipa

sharedTimeOff SharedTimeOff

Versão compartilhada do Time Off.

Rascunho de alterações >
draftTimeOff DraftTimeOff

Versão preliminar do Time Off

SharedTimeOff

Versão compartilhada do Time Off.

Name Caminho Tipo Description
ID do motivo de folga
timeOffReasonId string

ID do motivo de folga.

Hora de Início
startDateTime date-time

aaaa-MM-ddTHH:mm:ss.fffZ (formato UTC)

Hora de Término
endDateTime date-time

aaaa-MM-ddTHH:mm:ss.fffZ (formato UTC)

Theme
theme Theme

Cor do tema.

DraftTimeOff

Versão preliminar do Time Off

Name Caminho Tipo Description
ID do motivo de folga
timeOffReasonId string

ID do motivo de folga.

Hora de Início
startDateTime date-time

aaaa-MM-ddTHH:mm:ss.fffZ (formato UTC)

Hora de Término
endDateTime date-time

aaaa-MM-ddTHH:mm:ss.fffZ (formato UTC)

Theme
theme Theme

Cor do tema.

ShiftResponse

Entidade de turno.

Name Caminho Tipo Description
ID
id string

O ID exclusivo do Shift.

Data de Criação Hora
createdDateTime date-time

aaaa-MM-ddTHH:mm:ss.fffZ (formato UTC)

Data e Hora da Modificação
lastModifiedDateTime date-time

aaaa-MM-ddTHH:mm:ss.fffZ (formato UTC)

Atribuído ao ID de usuário
userId string

Atribuído ao ID de usuário.

Agendamento de ID de Grupo
schedulingGroupId string

Agendamento ID do grupo.

Agendamento de informações do grupo
schedulingGroupInfo SchedulingGroupInfo

Agendamento de informações do grupo

Informação do Utilizador
userInfo UserInfo

Informação do Utilizador

Informação da Equipa
teamInfo TeamInfo

Informação da Equipa

sharedShift SharedShift

Versão compartilhada do Shift.

Rascunho de alterações >
draftShift DraftShift

Versão preliminar do Shift

SharedShift

Versão compartilhada do Shift.

Name Caminho Tipo Description
Nome de exibição
displayName string

Nome de exibição

Observações
notes string

Notas de mudança

Hora de Início
startDateTime date-time

aaaa-MM-ddTHH:mm:ss.fffZ (formato UTC)

Hora de Término
endDateTime date-time

aaaa-MM-ddTHH:mm:ss.fffZ (formato UTC)

Theme
theme Theme

Cor do tema.

Activities
activities Activities

Atividades por turnos

Mudança de Rascunho

Versão preliminar do Shift

Name Caminho Tipo Description
Nome de exibição
displayName string

Nome de exibição

Observações
notes string

Observações

Hora de Início
startDateTime date-time

aaaa-MM-ddTHH:mm:ss.fffZ (formato UTC)

Hora de Término
endDateTime date-time

aaaa-MM-ddTHH:mm:ss.fffZ (formato UTC)

Theme
theme Theme

Cor do tema.

Activities
activities Activities

Atividades por turnos

Theme

Cor do tema.

Cor do tema.

Theme
string

Activities

Atividades por turnos

Name Caminho Tipo Description
É pago
isPaid boolean

É pago

Hora de Início
startDateTime date-time

aaaa-MM-ddTHH:mm:ss.fffZ (formato UTC)

Hora de Término
endDateTime date-time

aaaa-MM-ddTHH:mm:ss.fffZ (formato UTC)

Código
code string

Código

Nome de exibição
displayName string

Nome de exibição

AgendamentoGroupResponse

Entidade do Grupo de Agendamento

Name Caminho Tipo Description
ID
id string

A ID exclusiva do Grupo de Agendamento.

Nome de exibição
displayName string

O nome para exibição do Grupo de Agendamento.

Está ativo
isActive boolean

Indica se o Grupo de Agendamento pode ser usado ao criar novas entidades ou atualizar as existentes.

IDs de utilizador
userIds array of string

Lista de IDs de usuários no Grupo de Agendamento.

AgendamentoGroupInfo

Agendamento de informações do grupo

Name Caminho Tipo Description
Agendamento de ID de Grupo
schedulingGroupId string

A ID exclusiva do Grupo de Agendamento.

Nome de exibição
displayName string

O nome para exibição do Grupo de Agendamento.

Código
code string

O código do grupo de agendamento.

Informações do usuário

Informação do Utilizador

Name Caminho Tipo Description
ID do Utilizador
userId string

O ID do usuário.

Nome de exibição
displayName string

O nome para exibição do usuário.

TeamInfo

Informação da Equipa

Name Caminho Tipo Description
ID da Equipa
teamId string

O ID da equipa.

Nome de exibição
displayName string

O nome de exibição da equipe.

OpenShiftResponse

Entidade Open Shift

Name Caminho Tipo Description
ID
id string

O ID exclusivo do Open Shift.

Data de Criação Hora
createdDateTime date-time

aaaa-MM-ddTHH:mm:ss.fffZ (formato UTC)

Data e Hora da Modificação
lastModifiedDateTime date-time

aaaa-MM-ddTHH:mm:ss.fffZ (formato UTC)

Agendamento de ID de Grupo
schedulingGroupId string

Agendamento de ID de Grupo

Agendamento de informações do grupo
schedulingGroupInfo SchedulingGroupInfo

Agendamento de informações do grupo

Informação da Equipa
teamInfo TeamInfo

Informação da Equipa

sharedOpenShift SharedOpenShift

Versão partilhada do Open Shift

Rascunho de alterações >
draftOpenShift DraftOpenShift

Versão preliminar do Open Shift

SharedOpenShift

Versão partilhada do Open Shift

Name Caminho Tipo Description
Nome de exibição
displayName string

Nome de exibição

Observações
notes string

Observações

Hora de Início
startDateTime date-time

aaaa-MM-ddTHH:mm:ss.fffZ (formato UTC)

Hora de Término
endDateTime date-time

aaaa-MM-ddTHH:mm:ss.fffZ (formato UTC)

Theme
theme Theme

Cor do tema.

Abrir contagem de slots
openSlotCount integer

Abrir contagem de slots

Activities
activities Activities

Atividades por turnos

RascunhoOpenShift

Versão preliminar do Open Shift

Name Caminho Tipo Description
Nome de exibição
displayName string

Nome de exibição

Observações
notes string

Observações

Hora de Início
startDateTime date-time

aaaa-MM-ddTHH:mm:ss.fffZ (formato UTC)

Hora de Término
endDateTime date-time

aaaa-MM-ddTHH:mm:ss.fffZ (formato UTC)

Theme
theme Theme

Cor do tema.

Abrir contagem de slots
openSlotCount integer

Abrir contagem de slots

Activities
activities Activities

Atividades por turnos

GetTimeOffReasonsResponse

A lista de motivos de folga.

Name Caminho Tipo Description
Matriz contendo motivos de folga
value array of object

A lista de motivos de folga.

ID do motivo de folga
value.id string

O ID exclusivo do motivo de folga.

Tempo de Criação
value.createdDateTime date-time

aaaa-MM-ddTHH:mm:ss.fffZ (formato UTC)

Data e Hora da Modificação
value.lastModifiedDateTime date-time

aaaa-MM-ddTHH:mm:ss.fffZ (formato UTC)

Nome de exibição
value.displayName string

Nome de exibição

Tipo de ícone
value.iconType string

Tipo de ícone

Está ativo
value.isActive boolean

Está ativo

TimeOffRequestResponse

Entidade de solicitação de folga

Name Caminho Tipo Description
ID
id string

O ID exclusivo da solicitação de folga.

Tempo de Criação
createdDateTime date-time

aaaa-MM-ddTHH:mm:ss.fffZ (formato UTC)

Hora da Modificação
lastModifiedDateTime date-time

aaaa-MM-ddTHH:mm:ss.fffZ (formato UTC)

Atribuído A
assignedTo string

A pessoa a quem o pedido é atribuído: «gestor» ou «destinatário»

Estado
state string

«aprovado», «pendente» ou «recusado»

Hora do remetente
senderDateTime date-time

Hora em que o pedido foi enviado

Mensagem do remetente
senderMessage string

A mensagem do remetente da solicitação

ID do remetente
senderUserId string

A ID do usuário que enviou a solicitação

Tempo de Ação do Gerente
managerActionDateTime date-time

Momento em que o gerente respondeu

Mensagem do Gestor
managerActionMessage string

A mensagem do gestor

ID do Gestor
managerUserId string

O ID do gerente que respondeu

Hora de Início
startDateTime date-time

Início da folga solicitada

Hora de Término
endDateTime date-time

Fim do tempo solicitado

ID do motivo de folga
timeOffReasonId string

O ID do motivo de folga

OfferShiftRequestResponse

Entidade de solicitação de turno de oferta

Name Caminho Tipo Description
ID
id string

O ID exclusivo da solicitação de turno de oferta.

Tempo de Criação
createdDateTime date-time

aaaa-MM-ddTHH:mm:ss.fffZ (formato UTC)

Hora da Modificação
lastModifiedDateTime date-time

aaaa-MM-ddTHH:mm:ss.fffZ (formato UTC)

Atribuído A
assignedTo string

A pessoa a quem o pedido é atribuído: «gestor» ou «destinatário»

Estado
state string

«aprovado», «pendente» ou «recusado»

Hora do remetente
senderDateTime date-time

Hora em que o pedido foi enviado

Mensagem do remetente
senderMessage string

A mensagem do remetente da solicitação

ID do remetente
senderUserId string

A ID do usuário que enviou a solicitação

ID do turno do remetente
senderShiftId string

A ID do turno do remetente

Tempo do recetor
recipientActionDateTime date-time

Hora em que o destinatário respondeu

Mensagem do destinatário
recipientActionMessage string

A mensagem do destinatário

ID do destinatário
recipientUserId string

O ID do destinatário do pedido

Tempo de Ação do Gerente
managerActionDateTime date-time

Momento em que o gerente respondeu

Mensagem do Gestor
managerActionMessage string

A mensagem do gestor

ID do Gestor
managerUserId string

O ID do gerente que respondeu

SwapShiftsChangeRequestResponse

Entidade de solicitação de turno de troca

Name Caminho Tipo Description
ID
id string

A ID exclusiva da solicitação Swap Shift.

Tempo de Criação
createdDateTime date-time

aaaa-MM-ddTHH:mm:ss.fffZ (formato UTC)

Hora da Modificação
lastModifiedDateTime date-time

aaaa-MM-ddTHH:mm:ss.fffZ (formato UTC)

Atribuído A
assignedTo string

A pessoa a quem o pedido é atribuído: «gestor» ou «destinatário»

Estado
state string

«aprovado», «pendente» ou «recusado»

Hora do remetente
senderDateTime date-time

Hora em que o pedido foi enviado

Mensagem do remetente
senderMessage string

A mensagem do remetente da solicitação

ID do remetente
senderUserId string

A ID do usuário que enviou a solicitação

ID do turno do remetente
senderShiftId string

A ID do turno do remetente

Tempo do recetor
recipientActionDateTime date-time

Hora em que o destinatário respondeu

Mensagem do destinatário
recipientActionMessage string

A mensagem do destinatário

ID do destinatário
recipientUserId string

O ID do destinatário do pedido

ID do turno do destinatário
recipientShiftId string

A ID do turno do destinatário

Tempo de Ação do Gerente
managerActionDateTime date-time

Momento em que o gerente respondeu

Mensagem do Gestor
managerActionMessage string

A mensagem do gestor

ID do Gestor
managerUserId string

O ID do gerente que respondeu

OpenShiftChangeRequestResponse

Entidade de solicitação de alteração de turno aberto

Name Caminho Tipo Description
ID
id string

A ID exclusiva da solicitação Open Shift Change.

Tempo de Criação
createdDateTime date-time

aaaa-MM-ddTHH:mm:ss.fffZ (formato UTC)

Hora da Modificação
lastModifiedDateTime date-time

aaaa-MM-ddTHH:mm:ss.fffZ (formato UTC)

Atribuído A
assignedTo string

A pessoa a quem o pedido é atribuído: «gestor» ou «destinatário»

Estado
state string

«aprovado», «pendente» ou «recusado»

Hora do remetente
senderDateTime date-time

Hora em que o pedido foi enviado

Mensagem do remetente
senderMessage string

A mensagem do remetente da solicitação

ID do remetente
senderUserId string

A ID do usuário que enviou a solicitação

Tempo de Ação do Gerente
managerActionDateTime date-time

Momento em que o gerente respondeu

Mensagem do Gestor
managerActionMessage string

A mensagem do gestor

ID do Gestor
managerUserId string

O ID do gerente que respondeu

Abrir ID de turno
openShiftId string

O ID do Open Shift que está sendo solicitado