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
- Corpo
- UpsertTask_Response
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
- Corpo
- CreateProject_Response
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
- Corpo
- UpsertTask_Response
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
- Corpo
- CreateUser_Response
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
- Corpo
- DeleteTask_Response
Listar projetos
Essa operação retorna uma lista de todos os projetos associados à sua conta.
Retornos
- Corpo
- ListProjects_Response
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
- Corpo
- ListTasks_Response
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
- Corpo
- ListUsers_Response
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
- Corpo
- GetProject_Response
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.
- Corpo
- GetTask_Response
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
- Corpo
- GetUser_Response
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
Quando um usuário é criado
Quando uma tarefa é criada
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
|
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. |