Compartilhar via


Projetos de trabalho em equipe (versão prévia)

Mantenha todas as tarefas da sua equipe em um só lugar. Colabore e trabalhe em tempo real para obter resultados reais. Projetos de trabalho em equipe é uma maneira poderosa e simples de colaborar com sua equipe.

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)
Metadados do conector
Publicador Microsoft
Site da Web https://www.teamwork.com/
Política de privacidade https://www.teamwork.com/legal/privacy-policy/

Para usar os gatilhos nessa integração, primeiro você deve ter habilitado webhooks para sua conta de Projetos de Trabalho em Equipe. Para habilitar webhooks, clique em Configurações no canto superior direito da sua conta de Projetos de Trabalho em Equipe, clique em Configurações do Site e selecione a guia Webhooks. Depois que a configuração estiver habilitada em sua conta, o uso de um gatilho registrará automaticamente o webhook para você.

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
Nome de usuário cadeia O nome de usuário para esta api Verdade
Senha secureString A senha dessa api Verdade
URL do site cadeia URL do site raiz (exemplo: https://my.teamwork.com ) Verdade

Limitações

Nome Chamadas Período de renovação
Chamadas à API por conexão 100 60 segundos
Frequência das pesquisas de gatilho 1 1 segundo

Ações

Atualizar tarefa

Essa operação é usada para atualizar as propriedades de uma tarefa específica.

Criar projeto

Essa operação é usada para criar um novo projeto de Trabalho em Equipe.

Criar tarefa

Essa operação é usada para criar uma nova tarefa.

Criar usuário

Essa operação é usada para criar um novo usuário.

Excluir tarefa

Essa operação é usada para excluir uma tarefa.

Listar projetos

Essa operação retorna uma lista de todos os projetos associados à sua conta.

Listar tarefas

Essa operação é usada para retornar uma lista de tarefas para um determinado projeto.

Listar usuários

Essa operação retorna uma lista de todos os usuários associados a um projeto específico.

Obter projeto

Essa operação retorna todas as propriedades associadas a um projeto específico, considerando sua ID.

Obter tarefa

Essa operação retorna todas as propriedades associadas com uma tarefa específica, considerando sua ID.

Obter usuário

Esta operação é usada para obter todos os detalhes de um usuário.

Atualizar tarefa

Essa operação é usada para atualizar as propriedades de uma tarefa específica.

Parâmetros

Nome Chave Obrigatório Tipo Description
ID da tarefa
taskId True string

ID exclusiva da tarefa.

Nome
content string

Nome da tarefa.

Description
description string

Descrição da tarefa.

Progress
progress string

Inteiro de 0 a 90.

Atribuir a
responsible-party-id string

Escolha uma pessoa.

Data de Início
start-date string

yyyy-MM-dd

Data de vencimento
due-date string

yyyy-MM-dd

Tempo estimado
estimated-minutes string

Minutos para concluir a tarefa.

Priority
priority string

Escolha uma prioridade.

Notificar pessoas
notify boolean

True para notificar as pessoas atribuídas a essa tarefa por email.

É privado
private boolean

True para tornar a tarefa privada.

Etiquetas
tags string

Uma lista separada por vírgulas de marcas para a tarefa.

Retornos

Criar projeto

Essa operação é usada para criar um novo projeto de Trabalho em Equipe.

Parâmetros

Nome Chave Obrigatório Tipo Description
Nome
name True string

Nome do projeto.

Description
description string

Mais detalhes sobre o projeto.

ID da categoria
category-id string

Escolher uma categoria

ID da empresa
companyId string

Escolha uma empresa existente.

Nova Empresa
newCompany string

Insira o nome de uma nova empresa externa.

Data de Início
startDate string

yyyy-MM-dd

Data de Término
endDate string

yyyy-MM-dd

Etiquetas
tags string

Uma lista separada por vírgulas de marcas para o projeto.

Retornos

Criar tarefa

Essa operação é usada para criar uma nova tarefa.

Parâmetros

Nome Chave Obrigatório Tipo Description
ID do projeto
projectId True string

Escolha um projeto.

ID da lista de tarefas
taskListId True string

Escolha uma lista de tarefas.

Nome
content True string

Título da tarefa.

Description
description string

Detalhes da tarefa.

Progress
progress string

Defina o progresso de 0 a 90.

Atribuir a
responsible-party-id string

Escolha um usuário.

Data de Início
start-date string

yyyy-MM-dd

Data de vencimento
due-date string

yyyy-MM-dd

Minutos estimados
estimated-minutes string

Para que uma tarefa seja concluída.

Priority
priority string

Escolha uma prioridade.

Notificar pessoas
notify boolean

True para notificar as pessoas atribuídas a essa tarefa por email.

É privado
private boolean

True para tornar a tarefa privada.

Etiquetas
tags string

Uma lista separada por vírgulas de marcas para a tarefa.

Retornos

Criar usuário

Essa operação é usada para criar um novo usuário.

Parâmetros

Nome Chave Obrigatório Tipo Description
Endereço de Email
email-address True string

Email do usuário.

Primeiro Nome
first-name True string

Nome do usuário.

Apelido
last-name True string

Sobrenome do usuário.

ID da empresa
company-id string

Empresa do usuário.

Cargo
title string

Título do usuário.

Página Inicial
phone-number-home string

Telefone doméstico do usuário.

Telemóvel
phone-number-mobile string

Telefone celular do usuário.

Office
phone-number-office string

Telefone do escritório do usuário.

Extensão do Office
phone-number-office-ext string

Extensão de telefone do escritório do usuário.

Fac-símile
phone-number-fax string

Número de fax do usuário.

Nome de usuário
user-name True string

Nome de exibição do usuário.

Retornos

Excluir tarefa

Essa operação é usada para excluir uma tarefa.

Parâmetros

Nome Chave Obrigatório Tipo Description
ID da tarefa
taskId True string

ID exclusiva da tarefa.

Retornos

Listar projetos

Essa operação retorna uma lista de todos os projetos associados à sua conta.

Retornos

Listar tarefas

Essa operação é usada para retornar uma lista de tarefas para um determinado projeto.

Parâmetros

Nome Chave Obrigatório Tipo Description
ID do projeto
projectId True string

Escolha um projeto.

ID da lista de tarefas
taskListId True string

Escolha uma lista de tarefas.

Retornos

Listar usuários

Essa operação retorna uma lista de todos os usuários associados a um projeto específico.

Parâmetros

Nome Chave Obrigatório Tipo Description
ID do projeto
projectId True string

Escolha um projeto.

Retornos

Obter projeto

Essa operação retorna todas as propriedades associadas a um projeto específico, considerando sua ID.

Parâmetros

Nome Chave Obrigatório Tipo Description
ID do projeto
projectId True string

ID exclusiva do projeto.

Retornos

Obter tarefa

Essa operação retorna todas as propriedades associadas com uma tarefa específica, considerando sua ID.

Parâmetros

Nome Chave Obrigatório Tipo Description
ID da tarefa
taskId True string

ID exclusiva da tarefa.

Retornos

Detalhes associados a uma tarefa específica.

Obter usuário

Esta operação é usada para obter todos os detalhes de um usuário.

Parâmetros

Nome Chave Obrigatório Tipo Description
ID da pessoa
personId True string

ID exclusiva da pessoa.

Retornos

Gatilhos

Quando um projeto é criado

Essa operação é disparada quando um novo projeto é criado.

Quando um usuário é criado

Essa operação é disparada quando um novo usuário é criado.

Quando uma tarefa é criada

Essa operação é disparada quando uma nova tarefa é criada.

Quando um projeto é criado

Essa operação é disparada quando um novo projeto é criado.

Retornos

Quando um usuário é criado

Essa operação é disparada quando um novo usuário é criado.

Retornos

Corpo
UserResponse

Quando uma tarefa é criada

Essa operação é disparada quando uma nova tarefa é criada.

Retornos

Corpo
TaskResponse

Definições

ProjectResponse

Nome Caminho Tipo Description
ID do projeto
objectId string

Identificador exclusivo do projeto.

TaskResponse

Nome Caminho Tipo Description
ID da tarefa
objectId string

Identificador exclusivo da tarefa.

UserResponse

Nome Caminho Tipo Description
Identificação de usuário
objectId string

Identificador exclusivo do usuário.

CreateProject_Response

Nome Caminho Tipo Description
ID do projeto
id string

ID exclusiva do projeto.

ListProjects_Response

Nome Caminho Tipo Description
Lista de projetos
projects array of Project_Response

Matriz de todos os projetos associados à sua conta.

GetProject_Response

Nome Caminho Tipo Description
projeto
project Project_Response

Project_Response

Nome Caminho Tipo Description
ID
category.id string

ID exclusiva da categoria do projeto.

Nome
category.name string

Nome da categoria do projeto.

ID
company.id string

ID exclusiva da empresa.

Nome
company.name string

Nome da empresa.

Criado Date-Time
created-on date-time

yyyyy-MM-ddTHH:mm:ss.fffZ

Description
description string

Mais detalhes sobre o projeto.

Terminar Date-Time
endDate string

yyyy-MM-dd

Temporizador Habilitado
harvest-timers-enabled boolean

True se o temporizador de colheita estiver habilitado.

ID do projeto
id string

ID exclusiva do projeto.

Atualização Date-Time
last-changed-on date-time

yyyyy-MM-ddTHH:mm:ss.fffZ

Logotipo
logo string

Logotipo do projeto.

Nome
name string

Nome do projeto.

Página Visão geral
overview-start-page string

URL da página de início da visão geral.

Privacidade Habilitada
privacyEnabled boolean

True se a privacidade estiver habilitada.

Estrelou
starred boolean

True se o projeto for estrelado.

Iniciar Date-Time
startDate string

yyyy-MM-dd

Página Iniciar
start-page string

URL da página inicial.

Situação
status string

Estado do projeto.

Substatus
subStatus string

Substatus do projeto.

Página Inicial de Tarefas
tasks-start-page string

URL da página de início de tarefas.

Tipo
type string

Tipo de projeto.

UpsertTask_Response

Nome Caminho Tipo Description
ID da tarefa
id string

ID exclusiva da tarefa.

ListTasks_Response

Nome Caminho Tipo Description
todo-items
todo-items array of Task_Response

Lista de tarefas junto com suas propriedades.

GetTask_Response

Detalhes associados a uma tarefa específica.

Nome Caminho Tipo Description
todo-item
todo-item Task_Response

Task_Response

Nome Caminho Tipo Description
Pode ser concluído
canComplete boolean

True se a tarefa puder ser concluída.

Pode editar
canEdit boolean

True se a tarefa puder ser editada.

Tempo de Log pode
canLogTime boolean

True se o tempo puder ser registrado na tarefa.

ID da empresa
company-id integer

ID exclusiva da empresa.

Nome da Empresa
company-name string

Nome da empresa.

Está concluído
completed boolean

True é que a tarefa foi concluída.

Nome
content string

Título da tarefa.

Criado Date-Time
created-on date-time

yyyyy-MM-ddTHH:mm:ss.fffZ

URL do Avatar do Criador
creator-avatar-url string

URL do avatar do criador de tarefas.

Nome do Criador
creator-firstname string

Nome do criador de tarefas.

ID do criador
creator-id integer

ID exclusiva do criador.

Sobrenome do Criador
creator-lastname string

Sobrenome do criador de tarefas.

Description
description string

Descrição da tarefa.

Data de vencimento
due-date string

yyyy-MM-dd

Minutos Estimados
estimated-minutes integer

Estimativa de tempo para a tarefa.

Colheita habilitada.
harvest-enabled boolean

True se a colheita estiver habilitada.

Contagem de dependências
has-dependencies integer

Número de dependências que a tarefa tem.

Tem predecessores
has-predecessors integer

Número de predecessores que a tarefa tem.

Tem lembretes
has-reminders boolean

True se os lembretes existirem.

Tem tíquetes
hasTickets boolean

True se houver tíquetes.

has-unread-comments
has-unread-comments boolean

True se houver comentários não lidos.

ID da tarefa
id integer

ID exclusiva da tarefa.

Atualização Date-Time
last-changed-on date-time

yyyyy-MM-ddTHH:mm:ss.fffZ

ID de bloqueio
lockdownId string

ID exclusiva do bloqueio.

ID da tarefa pai
parentTaskId string

ID exclusiva da tarefa pai.

Priority
priority string

Prioridade da tarefa.

Privado
private integer

1 se a tarefa for privada.

Progress
progress integer

Inteiro entre 0 e 90.

ID do projeto
project-id integer

ID exclusiva do projeto.

Nome do Projeto
project-name string

Nome do projeto.

Data de Início
start-date string

yyyy-MM-dd

Situação
status string

Excluído, concluído, reaberto ou novo.

ID da Lista todo
todo-list-id integer

ID exclusiva da lista de tarefas pendentes.

Nome da Lista Todo
todo-list-name string

Nome da lista de tarefas pendentes.

Alterações a seguir
userFollowingChanges boolean

True se o usuário estiver seguindo as alterações.

Comentários a seguir
userFollowingComments boolean

True se o usuário estiver seguindo comentários.

DeleteTask_Response

Nome Caminho Tipo Description
ID da tarefa
affectedTaskIds string

ID exclusiva da tarefa.

CreateUser_Response

Nome Caminho Tipo Description
Identificação de usuário
id string

Identificador exclusivo do usuário.

ListUsers_Response

Nome Caminho Tipo Description
Usuários
people array of User_Response

Lista de usuários.

GetUser_Response

Nome Caminho Tipo Description
pessoa
person User_Response

User_Response

Nome Caminho Tipo Description
Avatar URL
avatar-url string

URL do avatar do usuário.

ID da empresa
company-id string

ID exclusiva da empresa.

Nome da Empresa
company-name string

Nome da empresa.

Endereço de Email
email-address string

Email do usuário.

Email Alternativo 1
email-alt-1 string

Email alternativo do usuário.

Primeiro Nome
first-name string

Nome do usuário.

Identificação de usuário
id string

ID exclusiva do usuário.

Apelido
last-name string

Sobrenome do usuário,

Anotações
notes string

Anotações sobre o usuário.

Abrir ID
openId string

ID aberta do usuário.

Número do fax
phone-number-fax string

Número de fax do usuário.

Página Inicial
phone-number-home string

Telefone doméstico do usuário.

Telemóvel
phone-number-mobile string

Número de celular do usuário.

Código do país
phone-number-mobile-parts.countryCode string

Número de celular do usuário.

Telefone
phone-number-mobile-parts.phone string

Número de celular do usuário.

Prefixo
phone-number-mobile-parts.prefix string

Número de celular do usuário.

Office
phone-number-office string

Número de telefone do escritório do usuário.

Extensão do Office
phone-number-office-ext string

Número de telefone do escritório do usuário.

Pid
pid string

Pid do usuário.

Title
title string

Título do usuário.

Twitter
twitter string

Identificador do twitter do usuário.

Nome de usuário
user-name string

Nome de exibição do usuário.

Tipo
user-type string

Tipo de usuário.

Identificador Único Universal (UUID)
userUUID string

UUID do usuário.