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
- Body
- UpsertTask_Response
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
- Body
- CreateUser_Response
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
- Body
- DeleteTask_Response
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
- Body
- ListUsers_Response
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
- Body
- ListTasks_Response
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
- Body
- GetProject_Response
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.
- Body
- GetTask_Response
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
- Body
- GetUser_Response
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
- Body
- UpsertTask_Response
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
Quando um usuário é criado
Quando uma tarefa é criada
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
|
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. |