Partilhar via


Projetos de Trabalho em Equipa (Pré-visualização)

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.

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

Serviço Class Regiões
Estúdio Copiloto Premium Todas as regiões do Power Automatic , exceto as seguintes:
     - Governo dos EUA (CCG)
     - Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Aplicações Lógicas Standard Todas as regiões do Logic Apps , exceto as seguintes:
     - Regiões do Azure Government
     - Regiões do Azure China
     - Departamento de Defesa dos EUA (DoD)
Aplicações Power Premium Todas as regiões do Power Apps , exceto as seguintes:
     - Governo dos EUA (CCG)
     - Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Automatize o poder Premium Todas as regiões do Power Automatic , exceto as seguintes:
     - Governo dos EUA (CCG)
     - Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Metadados do conector
Editora Microsoft
Sítio 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. Assim que a configuração estiver ativada na sua conta, o uso de um gatilho registrará automaticamente o webhook para você.

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.

Nome Tipo Description Obrigatório
Nome de utilizador cadeia (de caracteres) O nome de usuário para esta api Verdade
Palavra-passe securestring A senha para esta api Verdade
URL do site cadeia (de caracteres) URL do site raiz (exemplo: https://my.teamwork.com ) Verdade

Limites de Limitação

Name Chamadas Período de Renovação
Chamadas de API por conexão 100 60 segundos
Frequência das sondagens de desencadeamento 1 1 segundo

Ações

Criar o projeto

Esta operação é usada para criar um novo projeto de trabalho em equipe.

Criar tarefa

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

Criar utilizador

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

Excluir tarefa

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

Lista de utilizadores

Esta operação retorna uma lista de todos os usuários asosciated com um projeto específico.

Listar projetos

Esta operação devolve uma lista de todos os projetos associados à sua conta.

Listar tarefas

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

Obter projeto

Esta operação retorna todas as propriedades asosciated com um projeto específico, dada a sua id.

Obter tarefa

Esta operação retorna todas as propriedades asosciated com uma tarefa específica, dada a sua id.

Obter utilizador

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

Tarefa de atualização

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

Criar o projeto

Esta operação é usada para criar um novo projeto de trabalho em equipe.

Parâmetros

Name Chave Necessário Tipo Description
Nome
name True string

Nome do projeto.

Description
description string

Mais detalhes sobre o projeto.

ID da categoria
category-id string

Escolha 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 fim
endDate string

yyyy-MM-dd

Etiquetas
tags string

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

Devoluções

Criar tarefa

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

Parâmetros

Name Chave Necessá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 Para Conclusão
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 esta tarefa por e-mail.

É privado
private boolean

True para tornar a tarefa privada.

Etiquetas
tags string

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

Devoluções

Criar utilizador

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

Parâmetros

Name Chave Necessário Tipo Description
Endereço de E-mail
email-address True string

E-mail do usuário.

Nome Próprio
first-name True string

Nome do usuário.

Apelido
last-name True string

Apelido do utilizador.

ID da Empresa
company-id string

Empresa do utilizador.

Cargo
title string

Título do utilizador.

Base
phone-number-home string

Telefone residencial do usuário.

Telemóvel
phone-number-mobile string

Telemóvel do utilizador.

Office
phone-number-office string

Telefone do escritório do usuário.

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

Extensão telefónica do escritório do utilizador.

Fax
phone-number-fax string

Número de fax do utilizador.

Nome de utilizador
user-name True string

Nome para exibição do usuário.

Devoluções

Excluir tarefa

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

Parâmetros

Name Chave Necessário Tipo Description
ID da Tarefa
taskId True string

ID exclusivo da tarefa.

Devoluções

Lista de utilizadores

Esta operação retorna uma lista de todos os usuários asosciated com um projeto específico.

Parâmetros

Name Chave Necessário Tipo Description
ID do projeto
projectId True string

Escolha um projeto.

Devoluções

Listar projetos

Esta operação devolve uma lista de todos os projetos associados à sua conta.

Devoluções

Listar tarefas

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

Parâmetros

Name Chave Necessá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.

Devoluções

Obter projeto

Esta operação retorna todas as propriedades asosciated com um projeto específico, dada a sua id.

Parâmetros

Name Chave Necessário Tipo Description
ID do projeto
projectId True string

ID único do projeto.

Devoluções

Obter tarefa

Esta operação retorna todas as propriedades asosciated com uma tarefa específica, dada a sua id.

Parâmetros

Name Chave Necessário Tipo Description
ID da Tarefa
taskId True string

ID exclusivo da tarefa.

Devoluções

Detalhes associados a uma tarefa específica.

Obter utilizador

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

Parâmetros

Name Chave Necessário Tipo Description
Identificação da pessoa
personId True string

ID único da pessoa.

Devoluções

Tarefa de atualização

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

Parâmetros

Name Chave Necessário Tipo Description
ID da Tarefa
taskId True string

ID exclusivo 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 Para Conclusão
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 esta tarefa por e-mail.

É privado
private boolean

True para tornar a tarefa privada.

Etiquetas
tags string

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

Devoluções

Acionadores

Quando um projeto é criado

Esta operação é acionada quando um novo projeto é criado.

Quando um usuário é criado

Esta operação é acionada quando um novo usuário é criado.

Quando uma tarefa é criada

Esta operação é acionada quando uma nova tarefa é criada.

Quando um projeto é criado

Esta operação é acionada quando um novo projeto é criado.

Devoluções

Quando um usuário é criado

Esta operação é acionada quando um novo usuário é criado.

Devoluções

Quando uma tarefa é criada

Esta operação é acionada quando uma nova tarefa é criada.

Devoluções

Definições

Resposta ao Projeto

Name Caminho Tipo Description
ID do projeto
objectId string

Identificador único do projeto.

TaskResponse

Name Caminho Tipo Description
ID da Tarefa
objectId string

Identificador exclusivo da tarefa.

Resposta do usuário

Name Caminho Tipo Description
ID do Utilizador
objectId string

Identificador exclusivo do usuário.

CreateProject_Response

Name Caminho Tipo Description
ID do projeto
id string

ID único do projeto.

ListProjects_Response

Name Caminho Tipo Description
Lista de Projetos
projects array of Project_Response

Matriz de todos os projetos asosciated com sua conta.

GetProject_Response

Name Caminho Tipo Description
projecto
project Project_Response

Project_Response

Name Caminho Tipo Description
Id
category.id string

ID exclusivo da categoria do projeto.

Nome
category.name string

Nome da categoria do projeto.

Id
company.id string

ID único da empresa.

Nome
company.name string

Nome da empresa.

Criado Date-Time
created-on date-time

aaaa-MM-ddTHH:mm:ss.fffZ

Description
description string

Mais detalhes sobre o projeto.

Fim Date-Time
endDate string

yyyy-MM-dd

Temporizador ativado
harvest-timers-enabled boolean

True se o temporizador Harvest estiver ativado.

ID do projeto
id string

ID único do projeto.

Atualizado Date-Time
last-changed-on date-time

aaaa-MM-ddTHH:mm:ss.fffZ

Logótipo
logo string

Logótipo do projeto.

Nome
name string

Nome do projeto.

Página de visão geral
overview-start-page string

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

Privacidade ativada
privacyEnabled boolean

True se a privacidade estiver ativada.

Estrelado
starred boolean

Verdade se o projeto for estrelado.

Iniciar Date-Time
startDate string

yyyy-MM-dd

Página inicial
start-page string

URL da página inicial.

Situação
status string

Estado do projeto.

Subestatuto
subStatus string

Substatus do projeto.

Página inicial de tarefas
tasks-start-page string

URL da página inicial de tarefas.

Tipo
type string

Tipo de projeto.

UpsertTask_Response

Name Caminho Tipo Description
ID da Tarefa
id string

ID exclusivo da tarefa.

ListTasks_Response

Name Caminho Tipo Description
todo-itens
todo-items array of Task_Response

Lista de tarefas juntamente com suas propriedades.

GetTask_Response

Detalhes associados a uma tarefa específica.

Name Caminho Tipo Description
todo-item
todo-item Task_Response

Task_Response

Name Caminho Tipo Description
Pode concluir
canComplete boolean

True se a tarefa puder ser concluída.

Pode editar
canEdit boolean

True se a tarefa puder ser editada.

Pode registrar o tempo
canLogTime boolean

True se o tempo puder ser registrado na tarefa.

ID da Empresa
company-id integer

ID único da empresa.

Nome da Empresa
company-name string

Nome da empresa.

Está concluído
completed boolean

Verdadeiro é que a tarefa está concluída.

Nome
content string

Título da tarefa.

Criado Date-Time
created-on date-time

aaaa-MM-ddTHH:mm:ss.fffZ

URL do Avatar do Criador
creator-avatar-url string

URL do avatar do criador da tarefa.

Nome próprio do criador
creator-firstname string

Nome próprio do criador da tarefa.

ID do criador
creator-id integer

Id único do criador.

Sobrenome do criador
creator-lastname string

Apelido do criador da tarefa.

Description
description string

Descrição da tarefa.

Data Para Conclusão
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 ativada.

Contagem de dependências
has-dependencies integer

Número de dependências da tarefa.

Tem antecessores
has-predecessors integer

Número de antecessores que a tarefa tem.

Tem lembretes
has-reminders boolean

True se existirem lembretes.

Tem Bilhetes
hasTickets boolean

Verdade se existirem bilhetes.

tem-não-lido-comentários
has-unread-comments boolean

True se existirem comentários não lidos.

ID da Tarefa
id integer

ID exclusivo da tarefa.

Atualizado Date-Time
last-changed-on date-time

aaaa-MM-ddTHH:mm:ss.fffZ

Bloquear id
lockdownId string

Id único do lockdown.

ID da tarefa pai
parentTaskId string

ID exclusivo 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 único 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 completa
todo-list-id integer

ID exclusivo da lista todo.

Nome da Lista Completa
todo-list-name string

Nome da lista todo.

Alterações seguintes
userFollowingChanges boolean

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

Seguintes comentários
userFollowingComments boolean

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

DeleteTask_Response

Name Caminho Tipo Description
ID da Tarefa
affectedTaskIds string

ID exclusivo da tarefa.

CreateUser_Response

Name Caminho Tipo Description
ID do Utilizador
id string

Identificador exclusivo do usuário.

ListUsers_Response

Name Caminho Tipo Description
Utilizadores
people array of User_Response

Lista de utilizadores.

GetUser_Response

Name Caminho Tipo Description
pessoa
person User_Response

User_Response

Name Caminho Tipo Description
Avatar URL
avatar-url string

URL do avatar do usuário.

ID da Empresa
company-id string

ID único da empresa.

Nome da Empresa
company-name string

Nome da empresa.

Endereço de E-mail
email-address string

E-mail do usuário.

Email alternativo 1
email-alt-1 string

E-mail alternativo do usuário.

Nome Próprio
first-name string

Nome do usuário.

ID do Utilizador
id string

ID exclusivo do usuário.

Apelido
last-name string

Apelido do utilizador,

Observações
notes string

Notas sobre o utilizador.

Abrir ID
openId string

ID aberto do usuário.

Número de Fax
phone-number-fax string

Número de fax do utilizador.

Base
phone-number-home string

Telefone residencial do usuário.

Telemóvel
phone-number-mobile string

Número de telemóvel do utilizador.

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

Número de telemóvel do utilizador.

Telemóvel
phone-number-mobile-parts.phone string

Número de telemóvel do utilizador.

Prefixo
phone-number-mobile-parts.prefix string

Número de telemóvel do utilizador.

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 utilizador.

Twitter
twitter string

Identificador do twitter do usuário.

Nome de utilizador
user-name string

Nome para exibição do usuário.

Tipo
user-type string

Tipo de usuário.

Identificador Único Universal (UUID)
userUUID string

UUID do usuário.