Compartilhar via


Powell Teams (versão prévia)

Os pontos de extremidade da API do Powell Teams permitem que você gerencie a governança de suas equipes (criação/atualização de suas equipes).

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)
Contato
Nome Suporte do Powell Teams
URL https://support.powell-software.com/
Email support-teams@powellsoftware.zendesk.com
Metadados do conector
Publicador Software DoLS
Site https://powell-software.com/
Política de privacidade https://powell-software.com/en/powell-teams-privacy/
Categorias Produtividade; Colaboração

Imagine que o Microsoft Teams seja criado automaticamente para projetos e processos em seus departamentos, economizando tempo e melhorando a colaboração. Isso agora é possível com o conector da API do Powell Teams.

Esse conector contém todas as APIs do Powell Teams e pode ser acoplado a produtos MS, como fluxo, aplicativo de energia ou aplicativo lógico

Por exemplo, o conector pode disparar automaticamente uma criação de equipe após o recebimento de um email ou por meio de uma ação disparada em uma solução de terceiros, como um CRM. Esse processo automatizado significa que a equipe certa será criada para facilitar a colaboração.

O conector permite um infinito de solução para seus casos de uso de negócios

Exemplo: cenário rfp, você verá como Linda, uma gerente de vendas, poderá colaborar instantaneamente com sua equipe em um modelo dedicado disparado automaticamente após a criação de sua oportunidade no CRM ou o recebimento de um email simples.

Pré-requisitos

Tenha a versão do Powell Teams (licença com API).

Como obter credenciais

Usamos a autenticação do Microsoft Entra ID Graph.

Introdução ao conector

https://support.powell-software.com/hc/en-us/articles/360020025800

perguntas frequentes

  • É possível criar equipes com o conector? Yes! É a principal aplicação desse conector de API. Criar equipes com base em seus modelos

  • É possível criar modelos com o conector? Não. A criação do modelo deve ser feita diretamente no aplicativo Powell Teams

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.

Limitações

Nome Chamadas Período de renovação
Chamadas à API por conexão 100 60 segundos

Ações

Aprovar ou negar uma aprovação pendente

Aprovar ou negar uma aprovação pendente

Atualizar uma equipe com base em informações de modelo do Powell Teams

Atualizar uma equipe com base em informações de modelo do Powell Teams

Criar uma equipe com base em informações de modelo do Powell Teams

Criar uma equipe com base em informações de modelo do Powell Teams

Listar todas as aprovações

Listar todas as aprovações

Listar todas as aprovações pendentes do usuário atual

Listar todas as aprovações pendentes do usuário atual

Listar todas as convenções de nomenclatura

Listar todas as convenções de nomenclatura

Listar todas as equipes do usuário

Listar todas as equipes do usuário

Listar todas as marcas

Listar todas as marcas

Listar todas as marcas de uma equipe

Listar todas as marcas de uma equipe

Listar todos os modelos do usuário

Listar todos os modelos do usuário

Métodos de lote

Métodos de lote

Obter equipes com o relatório de usuários ausentes

Obter equipes com o relatório de usuários ausentes

Obter equipes com relatórios de usuários externos

Obter equipes com relatórios de usuários externos

Obter equipes sem relatório de regra de nomenclatura válido

Obter equipes sem relatório de regra de nomenclatura válido

Obter equipes sem relatório mínimo de proprietários

Obter equipes sem relatório mínimo de proprietários

Obter imagem de modelo

Obter imagem de modelo

Obter informações de marcas de IDs de marca

Obter informações de marcas de IDs de marca

Obter o status da tarefa Trabalho

Obter o status da tarefa Trabalho

Obter uma convenção de nomenclatura por id

Obter uma convenção de nomenclatura por id

Aprovar ou negar uma aprovação pendente

Aprovar ou negar uma aprovação pendente

Parâmetros

Nome Chave Obrigatório Tipo Description
ApprovalId
ApprovalId uuid
Situação
Status integer
Comment
Comment string
Criado
Created date-time

Retornos

Atualizar uma equipe com base em informações de modelo do Powell Teams

Atualizar uma equipe com base em informações de modelo do Powell Teams

Parâmetros

Nome Chave Obrigatório Tipo Description
ID da equipe
teamId True uuid

ID da equipe a ser atualizada.

Description
Description string
Nome
Name string
TeamTemplateId
TeamTemplateId uuid
Visibilidade
Visibility string
AdditionalMembers
AdditionalMembers array of string
AdditionalGroupOwners
AdditionalGroupOwners array of string
AdditionalGroupMembers
AdditionalGroupMembers array of string
AdditionalOwners
AdditionalOwners array of string
Value
Value string
TagId
TagId uuid

Retornos

Criar uma equipe com base em informações de modelo do Powell Teams

Criar uma equipe com base em informações de modelo do Powell Teams

Parâmetros

Nome Chave Obrigatório Tipo Description
Description
Description string
Nome
Name string
TeamTemplateId
TeamTemplateId uuid
Visibilidade
Visibility string
AdditionalMembers
AdditionalMembers array of string
AdditionalGroupOwners
AdditionalGroupOwners array of string
AdditionalGroupMembers
AdditionalGroupMembers array of string
AdditionalOwners
AdditionalOwners array of string
Value
Value string
TagId
TagId uuid

Retornos

Listar todas as aprovações

Listar todas as aprovações

Retornos

Listar todas as aprovações pendentes do usuário atual

Listar todas as aprovações pendentes do usuário atual

Retornos

Listar todas as convenções de nomenclatura

Listar todas as convenções de nomenclatura

Retornos

Listar todas as equipes do usuário

Listar todas as equipes do usuário

Parâmetros

Nome Chave Obrigatório Tipo Description
Indicador da próxima página
page uuid

Indicador da próxima página

Retornos

Listar todas as marcas

Listar todas as marcas

Retornos

Listar todas as marcas de uma equipe

Listar todas as marcas de uma equipe

Parâmetros

Nome Chave Obrigatório Tipo Description
ID da equipe
teamId True uuid

ID da equipe

Retornos

Listar todos os modelos do usuário

Listar todos os modelos do usuário

Retornos

Métodos de lote

Métodos de lote

Parâmetros

Nome Chave Obrigatório Tipo Description
ID
Id string
url
url string
método
method string
body
body object
headers
headers array of string

Retornos

Obter equipes com o relatório de usuários ausentes

Obter equipes com o relatório de usuários ausentes

Retornos

Obter equipes com relatórios de usuários externos

Obter equipes com relatórios de usuários externos

Retornos

Obter equipes sem relatório de regra de nomenclatura válido

Obter equipes sem relatório de regra de nomenclatura válido

Retornos

Obter equipes sem relatório mínimo de proprietários

Obter equipes sem relatório mínimo de proprietários

Parâmetros

Nome Chave Obrigatório Tipo Description
Número mínimo de proprietários
numberOfMinimumOwners True string

Número mínimo de proprietários

Retornos

Obter imagem de modelo

Obter imagem de modelo

Parâmetros

Nome Chave Obrigatório Tipo Description
ID do modelo
templateId True uuid

ID do modelo

Retornos

response
string

Obter informações de marcas de IDs de marca

Obter informações de marcas de IDs de marca

Parâmetros

Nome Chave Obrigatório Tipo Description
body
body True array of uuid

Retornos

Obter o status da tarefa Trabalho

Obter o status da tarefa Trabalho

Parâmetros

Nome Chave Obrigatório Tipo Description
ID da tarefa a ser verificada
taskId True uuid

ID da tarefa a ser verificada

Retornos

Obter uma convenção de nomenclatura por id

Obter uma convenção de nomenclatura por id

Parâmetros

Nome Chave Obrigatório Tipo Description
ID da convenção de nomenclatura
namingId True uuid

ID da convenção de nomenclatura

Retornos

Definições

Powell.Teams.Common.Core.OperationResult_System.Collections.Generic.List_Powell.Teams.API.Models.Approval.ApiApprovalModel__

Nome Caminho Tipo Description
CorrelationId
CorrelationId uuid
ErrorCode
ErrorCode integer
Mensagem de Erro
ErrorMessage string
IsSucceed
IsSucceed boolean
Resultado
Result array of Powell.Teams.API.Models.Approval.ApiApprovalModel

Powell.Teams.API.Models.Approval.ApiApprovalModel

Nome Caminho Tipo Description
ID
Id uuid
Histórias
Histories array of Powell.Teams.API.Models.Approval.ApiApprovalHistoryModel
Equipe
Team Powell.Teams.API.Models.Team.ApiTeamExtendModel
ID do Inquilino (TenantId)
TenantId uuid
Criado
Created date-time
Aprovadores
Approvers array of string

Powell.Teams.API.Models.Approval.ApiApprovalHistoryModel

Nome Caminho Tipo Description
ID
Id uuid
Situação
Status integer
Comment
Comment string
Criador
Creator Powell.Teams.API.Models.User.ApiUserModel
Criado
Created date-time

Powell.Teams.API.Models.User.ApiUserModel

Nome Caminho Tipo Description
ID
Id uuid
Nome
Name string
AzureADId
AzureADId uuid
Email
Email string
Função
Role integer
Linguagem
Language string
ID do Inquilino (TenantId)
TenantId uuid

Powell.Teams.API.Models.Team.ApiTeamExtendModel

Nome Caminho Tipo Description
ID
Id uuid
OfficeGroupId
OfficeGroupId uuid
ID do Inquilino (TenantId)
TenantId uuid
DisplayName
DisplayName string
Description
Description string
OriginalTitle
OriginalTitle string
OriginalIncrementOfNamingRule
OriginalIncrementOfNamingRule integer
TeamTemplateId
TeamTemplateId uuid
Foto
Photo string
TagSettings
TagSettings array of Powell.Teams.API.Models.Tag.ApiTagSettingModel
Visibilidade
Visibility string
AdditionalMembers
AdditionalMembers array of string
AdditionalGroupOwners
AdditionalGroupOwners array of string
AdditionalGroupMembers
AdditionalGroupMembers array of string
AdditionalOwners
AdditionalOwners array of string
IsArchived
IsArchived boolean
Classification
Classification string
CurrentUserIsOwner
CurrentUserIsOwner boolean
Criado
Created date-time
ExpirationStart
ExpirationStart date-time
ExpirationDate
ExpirationDate date-time
IsFavorite
IsFavorite boolean
WebUrl
WebUrl string

Powell.Teams.API.Models.Tag.ApiTagSettingModel

Nome Caminho Tipo Description
ID
Id uuid
ValorPadrão
DefaultValue string
ChoiceValue
ChoiceValue string
Tipo
Type string
TagId
TagId uuid
IsMandatory
IsMandatory boolean
IsShownToUsers
IsShownToUsers boolean
ChoiceText
ChoiceText string
Nome
Name string
Value
Value string
IsMultiValueChoice
IsMultiValueChoice boolean

Powell.Teams.Common.Core.OperationResult_Powell.Teams.API.Models.Approval.ApiApprovalResult_

Nome Caminho Tipo Description
CorrelationId
CorrelationId uuid
ErrorCode
ErrorCode integer
Mensagem de Erro
ErrorMessage string
IsSucceed
IsSucceed boolean
Resultado
Result Powell.Teams.API.Models.Approval.ApiApprovalResult

Powell.Teams.API.Models.Approval.ApiApprovalResult

Nome Caminho Tipo Description
JobTaskId
JobTaskId uuid
ApprovalId
ApprovalId uuid
Situação
Status string

Powell.Teams.Common.Core.OperationResult_System.Collections.Generic.IEnumerable_Powell.Teams.API.Models.Batch.APIBatchResponseModel__

Nome Caminho Tipo Description
CorrelationId
CorrelationId uuid
ErrorCode
ErrorCode integer
Mensagem de Erro
ErrorMessage string
IsSucceed
IsSucceed boolean
Resultado
Result array of Powell.Teams.API.Models.Batch.APIBatchResponseModel

Powell.Teams.API.Models.Batch.APIBatchResponseModel

Nome Caminho Tipo Description
ID
Id string
status
status integer
body
body Powell.Teams.API.Models.Batch.APIBatchResponseBodyModel
headers
headers array of string

Powell.Teams.API.Models.Batch.APIBatchResponseBodyModel

Nome Caminho Tipo Description
value
value object
erro
error Powell.Teams.API.Models.Batch.APIBatchResponseErrorModel

Powell.Teams.API.Models.Batch.APIBatchResponseErrorModel

Nome Caminho Tipo Description
codificar
code string
mensagem
message string

Powell.Teams.Common.Core.OperationResult_System.String_

Nome Caminho Tipo Description
CorrelationId
CorrelationId uuid
ErrorCode
ErrorCode integer
Mensagem de Erro
ErrorMessage string
IsSucceed
IsSucceed boolean
Resultado
Result string

Powell.Teams.Common.Core.OperationResult_Powell.Teams.API.Models.NamingConvention.ApiNamingConventionModel_

Nome Caminho Tipo Description
CorrelationId
CorrelationId uuid
ErrorCode
ErrorCode integer
Mensagem de Erro
ErrorMessage string
IsSucceed
IsSucceed boolean
Resultado
Result Powell.Teams.API.Models.NamingConvention.ApiNamingConventionModel

Powell.Teams.API.Models.NamingConvention.ApiNamingConventionModel

Nome Caminho Tipo Description
ID
Id uuid
Configuração
Configuration array of Powell.Teams.API.Models.NamingConvention.ApiNamingConventionConfigurationModel
IsMetaNamingRule
IsMetaNamingRule boolean
Nome
Name string
NumberIncrement
NumberIncrement integer

Powell.Teams.API.Models.NamingConvention.ApiNamingConventionConfigurationModel

Nome Caminho Tipo Description
Tipo
Type string
Value
Value string

Powell.Teams.Common.Core.OperationResult_System.Collections.Generic.List_Powell.Teams.API.Models.NamingConvention.ApiNamingConventionModel__

Nome Caminho Tipo Description
CorrelationId
CorrelationId uuid
ErrorCode
ErrorCode integer
Mensagem de Erro
ErrorMessage string
IsSucceed
IsSucceed boolean
Resultado
Result array of Powell.Teams.API.Models.NamingConvention.ApiNamingConventionModel

Powell.Teams.Common.Core.OperationResult_System.Collections.Generic.List_Powell.Teams.API.Models.Report.ApiTeamReport__

Nome Caminho Tipo Description
CorrelationId
CorrelationId uuid
ErrorCode
ErrorCode integer
Mensagem de Erro
ErrorMessage string
IsSucceed
IsSucceed boolean
Resultado
Result array of Powell.Teams.API.Models.Report.ApiTeamReport

Powell.Teams.API.Models.Report.ApiTeamReport

Nome Caminho Tipo Description
GroupId
GroupId uuid
CreationDate
CreationDate date-time
LastUpdateDate
LastUpdateDate date-time
Title
Title string
Description
Description string
Foto
Photo string
IsArchived
IsArchived boolean
IsInactive
IsInactive boolean
Link
Link string
PowellTemplateId
PowellTemplateId uuid
PowellTemplateName
PowellTemplateName string
OwnersIds
OwnersIds array of string
NbOwners
NbOwners integer
MembersIds
MembersIds array of string
NbMembers
NbMembers integer
ExternalUsersIds
ExternalUsersIds array of string
NbExternals
NbExternals integer
LastChatActivity
LastChatActivity date-time
NbChatMessages
NbChatMessages integer
NbChatReplies
NbChatReplies integer
ChatMessageDeltaParameters
ChatMessageDeltaParameters array of Powell.Teams.Model.Unmapped.ChatMessageDeltaParameters
LastDocActivity
LastDocActivity date-time
NbDocuments
NbDocuments integer
DriveItemDeltaParameters
DriveItemDeltaParameters Powell.Teams.Model.Unmapped.DriveItemDeltaParameters
MinimumNumberOfOwners
MinimumNumberOfOwners integer
MinimumNumberOfMembers
MinimumNumberOfMembers integer
Visibilidade
Visibility string
ExpirationDate
ExpirationDate date-time
ExpirationStart
ExpirationStart date-time

Powell.Teams.Model.Unmapped.ChatMessageDeltaParameters

Nome Caminho Tipo Description
TeamId
TeamId string
ChannelId
ChannelId string
DeltaLink
DeltaLink string

Powell.Teams.Model.Unmapped.DriveItemDeltaParameters

Nome Caminho Tipo Description
GroupId
GroupId string
DeltaLink
DeltaLink string

Powell.Teams.Common.Core.OperationResult_System.Collections.Generic.IEnumerable_Powell.Teams.API.Models.Tag.ApiTagSimpleModel__

Nome Caminho Tipo Description
CorrelationId
CorrelationId uuid
ErrorCode
ErrorCode integer
Mensagem de Erro
ErrorMessage string
IsSucceed
IsSucceed boolean
Resultado
Result array of Powell.Teams.API.Models.Tag.ApiTagSimpleModel

Powell.Teams.API.Models.Tag.ApiTagSimpleModel

Nome Caminho Tipo Description
ID
Id uuid
Nome
Name string
Tipo
Type string
IsMultiValueChoice
IsMultiValueChoice boolean
Choices
Choices array of Powell.Teams.API.Models.Tag.ApiTagChoiceModel

Powell.Teams.API.Models.Tag.ApiTagChoiceModel

Nome Caminho Tipo Description
ID
Id uuid
Value
Value string

Powell.Teams.Common.Core.OperationResult_System.Collections.Generic.List_Powell.Teams.API.Models.Tag.ApiTagModel__

Nome Caminho Tipo Description
CorrelationId
CorrelationId uuid
ErrorCode
ErrorCode integer
Mensagem de Erro
ErrorMessage string
IsSucceed
IsSucceed boolean
Resultado
Result array of Powell.Teams.API.Models.Tag.ApiTagModel

Powell.Teams.API.Models.Tag.ApiTagModel

Nome Caminho Tipo Description
ChoicesJson
ChoicesJson string
ID
Id uuid
IsRefiner
IsRefiner boolean
Nome
Name string
Tipo
Type string

Powell.Teams.Common.Core.OperationResult_System.Guid_

Nome Caminho Tipo Description
CorrelationId
CorrelationId uuid
ErrorCode
ErrorCode integer
Mensagem de Erro
ErrorMessage string
IsSucceed
IsSucceed boolean
Resultado
Result uuid

Powell.Teams.Common.Core.OperationResult_Powell.Teams.API.Models.PublicAPIResponses.PaginatedAPIResponseModel_Powell.Teams.API.Models.Team.ApiTeamModel__

Nome Caminho Tipo Description
CorrelationId
CorrelationId uuid
ErrorCode
ErrorCode integer
Mensagem de Erro
ErrorMessage string
IsSucceed
IsSucceed boolean
Resultado
Result Powell.Teams.API.Models.PublicAPIResponses.PaginatedAPIResponseModel_Powell.Teams.API.Models.Team.ApiTeamModel_

Powell.Teams.API.Models.PublicAPIResponses.PaginatedAPIResponseModel_Powell.Teams.API.Models.Team.ApiTeamModel_

Nome Caminho Tipo Description
Itens
Items array of Powell.Teams.API.Models.Team.ApiTeamModel
NextPage
NextPage string

Powell.Teams.API.Models.Team.ApiTeamModel

Nome Caminho Tipo Description
ID
Id uuid
OfficeGroupId
OfficeGroupId uuid
ID do Inquilino (TenantId)
TenantId uuid
DisplayName
DisplayName string
Description
Description string
OriginalTitle
OriginalTitle string
OriginalIncrementOfNamingRule
OriginalIncrementOfNamingRule integer
TeamTemplateId
TeamTemplateId uuid
TagSettings
TagSettings array of Powell.Teams.API.Models.Tag.ApiTagSettingModel
Visibilidade
Visibility string
AdditionalMembers
AdditionalMembers array of string
AdditionalGroupOwners
AdditionalGroupOwners array of string
AdditionalGroupMembers
AdditionalGroupMembers array of string
AdditionalOwners
AdditionalOwners array of string
IsArchived
IsArchived boolean
Classification
Classification string
CurrentUserIsOwner
CurrentUserIsOwner boolean
Criado
Created date-time
ExpirationStart
ExpirationStart date-time
ExpirationDate
ExpirationDate date-time
IsFavorite
IsFavorite boolean
WebUrl
WebUrl string

Powell.Teams.Common.Core.OperationResult_System.Collections.Generic.List_Powell.Teams.API.Models.Tag.ApiTagSettingModel__

Nome Caminho Tipo Description
CorrelationId
CorrelationId uuid
ErrorCode
ErrorCode integer
Mensagem de Erro
ErrorMessage string
IsSucceed
IsSucceed boolean
Resultado
Result array of Powell.Teams.API.Models.Tag.ApiTagSettingModel

Powell.Teams.Common.Core.OperationResult_System.Collections.Generic.List_Powell.Teams.API.Models.TeamTemplate.ApiTeamTemplateSimpleModel__

Nome Caminho Tipo Description
CorrelationId
CorrelationId uuid
ErrorCode
ErrorCode integer
Mensagem de Erro
ErrorMessage string
IsSucceed
IsSucceed boolean
Resultado
Result array of Powell.Teams.API.Models.TeamTemplate.ApiTeamTemplateSimpleModel

Powell.Teams.API.Models.TeamTemplate.ApiTeamTemplateSimpleModel

Nome Caminho Tipo Description
ID
Id uuid
AdditionalMembers
AdditionalMembers array of string
AdditionalOwners
AdditionalOwners array of string
Aprovadores
Approvers array of string
Categorias
Categories array of uuid
Description
Description string
DisplayName
DisplayName string
IsPublished
IsPublished boolean
LastSchemaSynchronisation
LastSchemaSynchronisation string
MinimumMembers
MinimumMembers integer
MinimumOwners
MinimumOwners integer
NamingConventionId
NamingConventionId uuid
TagSettings
TagSettings array of Powell.Teams.API.Models.Tag.ApiTagSettingModel
TeamIdToClone
TeamIdToClone uuid
TeamsCount
TeamsCount integer
Visibilidade
Visibility string

cadeia

Esse é o tipo de dados básico 'string'.