Teamflect (Pré-visualização)
Melhore a eficiência do seu fluxo de trabalho com o Teamflect. Integre perfeitamente os recursos robustos de gerenciamento de desempenho do Teamflect, incluindo metas, feedback e avaliações, em seu ecossistema existente. Automatize tarefas de rotina, sincronize dados entre plataformas e crie fluxos de trabalho dinâmicos e orientados por dados para aumentar a produtividade e o envolvimento em toda a sua organização.
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) |
| Contato | |
|---|---|
| Nome | Bora Unlu |
| URL | https://teamflect.com/contact-us |
| support@teamflect.com |
| Metadados do conector | |
|---|---|
| Editora | Teamflect |
| Sítio Web | https://teamflect.com |
| Política de privacidade | https://teamflect.com/privacy |
| Categorias | Gestão de Empresas |
Teamflect Power Automate Conector
Nota: Este é um conector personalizado fornecido para integrar as extensas APIs do Teamfclect em seus fluxos de trabalho automatizados no Power Automate e Power Apps.
O Teamflect Power Automate Connector permite que você gerencie e interaja com metas, feedback, reconhecimentos e tarefas diretamente de seus fluxos de trabalho automatizados. Ao aproveitar esse conector, os usuários podem simplificar seus processos de gerenciamento de desempenho integrando-os perfeitamente ao Microsoft Power Automate.
Pré-requisitos
Para usar esse conector, você precisará do seguinte:
Um plano Microsoft Power Apps ou Power Automate que inclui suporte para conectores personalizados.
Uma Conta Teamflect com as permissões de API necessárias para acessar os dados relevantes.
Power Platform CLI Tools para criar e implantar o conector.
Construindo o conector
As APIs do Teamflect são protegidas por meio de chaves de API. Para acessar as APIs por meio desse conector, você precisará obter sua chave de API do Teamflect e configurá-la com segurança no Power Automate.
Etapas para criar e configurar o conector:
Obtenha uma chave de API:
Faça login na sua conta Teamflect e navegue até a página de configurações da API.
Gere uma chave de API e mantenha-a segura. Você precisará usar essa chave ao configurar o conector.
Baixar arquivos do conector:
- Certifique-se de ter a definição de API (arquivo OpenAPI/Swagger) para a API Teamflect. Este arquivo define as operações e a estrutura de dados suportada pelo conector.
Implante o conector:
Use a CLI da Power Platform para implantar o conector.
Execute o seguinte comando para criar o conector:
paconn create --api-def apiDefinition.swagger.json --api-prop apiProperties.json --secret <api_key>
Teste o conector:
- Uma vez implantado, teste o conector criando um fluxo Power Automate usando qualquer uma das operações suportadas.
Operações suportadas
O Teamflect Connector suporta as seguintes operações:
Gestão de Feedback
Enviar solicitação de feedback: inicie uma solicitação de feedback para um usuário especificado.
Enviar solicitação de feedback externo: envie uma solicitação de feedback para um endereço de e-mail externo.
Gestão de Metas
Obter meta por identificação: recupere detalhes de uma meta específica.
Obter metas: liste várias metas com base em critérios de pesquisa.
Criar nova meta: crie uma nova meta para um usuário.
Atualizar o progresso da meta: atualize o progresso ou o status de uma meta.
Comentário sobre meta: adicione um comentário a uma meta.
Reconhecimentos
Criar reconhecimento: crie um novo reconhecimento para um ou mais usuários.
Obter reconhecimento por identificação: recupere detalhes de um reconhecimento específico.
Obter reconhecimentos: liste vários reconhecimentos.
Gestão de Tarefas
Obter tarefa por ID: recupere uma tarefa por seu identificador exclusivo.
Obter tarefas: liste tarefas com base em critérios de pesquisa.
Notas de implantação
Certifique-se de que sua chave de API seja armazenada com segurança e não seja compartilhada publicamente.
Use o conector de forma responsável para evitar atingir os limites de taxa de API.
Consulte a documentação da API do Teamflect para obter informações detalhadas sobre a API, incluindo códigos de erro e parâmetros adicionais.
Informação Adicional
Para mais detalhes sobre a plataforma Teamflect, visite o nosso site. Se você encontrar algum problema ou precisar de assistência, entre em contato com nossa equipe de suporte em support@teamflect.com.
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 |
|---|---|---|---|
| Chave de API | securestring | A chave de API para esta api | Verdade |
Limites de Limitação
| Name | Chamadas | Período de Renovação |
|---|---|---|
| Chamadas de API por conexão | 100 | 60 segundos |
Ações
| Adiciona um comentário a uma meta |
Adiciona um novo comentário a uma meta |
| Atualiza um usuário com atributos selecionados |
Atualiza os atributos de um usuário |
| Atualizar o progresso de uma meta |
Atualizar o progresso de uma meta |
| Cria um novo objetivo |
Cria um novo objetivo |
| Cria um novo reconhecimento |
Cria um novo reconhecimento |
| Devolve os reconhecimentos com base nos filtros aplicados |
Devolve os reconhecimentos com base nos filtros aplicados |
| Envia um novo pedido de feedback |
Envia uma nova solicitação de feedback. |
| Envia um novo pedido de feedback externo |
Envia um novo pedido de feedback externo |
| Obtém um reconhecimento por ID |
Obtém um reconhecimento por ID |
| Obtém um usuário por e-mail |
Obtém um usuário por e-mail |
| Obtém uma meta por ID |
Obtém uma meta por ID |
| Obtém uma tarefa por ID |
Obtém uma tarefa por ID |
| Retorna metas com base nos filtros aplicados |
Retorna metas com base nos filtros aplicados |
| Retorna tarefas com base nos filtros aplicados |
Retorna tarefas com base nos filtros aplicados |
Adiciona um comentário a uma meta
Adiciona um novo comentário a uma meta
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Id do gol
|
goalId | True | string |
Id do gol |
|
ID do objeto ou nome principal do usuário do comentarista
|
commenterIdOrUPN | True | string |
ID do objeto ou nome principal do usuário do comentarista |
|
Comente em si
|
commentText | True | string |
Comente em si |
Devoluções
- Body
- Goal
Atualiza um usuário com atributos selecionados
Atualiza os atributos de um usuário
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
E-mail do usuário
|
userMail | string |
O endereço de e-mail do usuário a ser atualizado. |
|
|
Rótulo de atributo
|
label | string |
O nome do atributo a ser atualizado. |
|
|
Valor do Atributo
|
value | string |
O valor do atributo a ser atualizado. |
Atualizar o progresso de uma meta
Atualizar o progresso de uma meta
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
ID da meta
|
goalId | True | string |
Identificador exclusivo da meta a atualizar |
|
Novo valor de progresso
|
newValue | True | string |
Novo valor de progresso para o objetivo |
|
Atualizar comentário
|
comment | string |
Comentário sobre a atualização de progresso |
|
|
Novo status
|
status | string |
Novo status para o objetivo |
|
|
Tipo de atualizador
|
goalUpdater | True | string |
Quem está atualizando a meta (Proprietário ou Sistema) |
|
Nome do sistema
|
goalUpdaterSystemName | True | string |
Nome do sistema atualizando a meta |
Devoluções
- Body
- Goal
Cria um novo objetivo
Cria um novo objetivo
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Título do golo
|
title | True | string |
Título do novo golo |
|
Description
|
description | True | string |
Descrição detalhada do novo objetivo |
|
Data de início
|
startDate | True | string |
Data em que o objetivo deve começar |
|
Data Para Conclusão
|
dueDate | True | string |
Data em que a meta deve ser concluída |
|
Tipo de Objetivo
|
goalType | True | string |
Tipo de golo |
|
Dono do gol
|
goalOwnerUPNorId | True |
E-mail ou ID do proprietário da meta |
|
|
Criador de Metas
|
goalCreatorUPNorId | True | string |
E-mail ou ID do criador da meta |
|
É privado
|
isPrivate | True | boolean |
Se o objetivo deve ser privado |
|
Formato de progresso
|
progressFormatType | True | string |
Tipo de formato para acompanhar o progresso |
|
Código de Moeda
|
currencyCode | True | string |
Código da moeda para objetivos monetários |
|
Valor Inicial
|
initialValue | True | number |
Valor do progresso inicial |
|
Valor Alvo
|
targetValue | True | number |
Valor do progresso pretendido |
|
ID da meta do pai
|
parentGoalId | True | string |
ID da meta pai se esta for uma submeta |
|
Notificar Proprietário
|
sendNotificationToOwner | True | boolean |
Se o proprietário da meta deve ser notificado |
Devoluções
- Body
- Goal
Cria um novo reconhecimento
Cria um novo reconhecimento
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Remetente de reconhecimento
|
senderIdOrUPN | True | string |
E-mail ou ID da pessoa que envia o reconhecimento |
|
Destinatários do Reconhecimento
|
recipientsIdsOrUPNS | True | array of string |
Lista de e-mails ou IDs de pessoas que recebem o reconhecimento |
|
Título do selo
|
badgeTitle | True | string |
Título do emblema de reconhecimento |
|
É privado
|
isPrivate | True | boolean |
Se o reconhecimento é privado |
|
Mensagem de reconhecimento
|
description | True | string |
Mensagem incluída com o reconhecimento |
Devoluções
Devolve os reconhecimentos com base nos filtros aplicados
Devolve os reconhecimentos com base nos filtros aplicados
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Destinatários a pesquisar
|
recipientsIdsOrUPNS | True | array of string |
Lista de e-mails ou IDs de destinatários para pesquisar |
|
Título de Reconhecimento
|
title | True | string |
Título de reconhecimento a procurar |
|
Data de atualização
|
updated | True | string |
Data da última atualização para filtrar por |
|
Data de criação
|
created | True | string |
Data de criação para filtrar por |
Devoluções
- Itens
- RecognitionResponses
Envia um novo pedido de feedback
Envia uma nova solicitação de feedback.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Assunto do feedback
|
feedbackAboutUPNorId | True | string |
E-mail ou ID da pessoa que recebe feedback |
|
Provedor de feedback
|
feedbackRequestReceiverUPNorId | True | string |
E-mail ou ID da pessoa que fornecerá feedback |
|
Solicitar Nota
|
feedbackNote | True | string |
Nota a incluir no pedido de feedback |
|
Título do modelo
|
templateTitle | True | string |
Título do modelo de feedback a utilizar |
|
Prazos de vencimento
|
dueDateInDays | True | number |
Número de dias até que o feedback seja devido |
|
É privado
|
isPrivate | True | boolean |
Se o feedback deve ser privado |
Devoluções
- Body
- Feedback
Envia um novo pedido de feedback externo
Envia um novo pedido de feedback externo
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Assunto do feedback
|
feedbackAboutUPNorId | True | string |
E-mail ou ID da pessoa que recebe feedback |
|
E-mail externo
|
externalEmail | True | string |
Endereço de e-mail do fornecedor de feedback externo |
|
Nome do provedor
|
onBehalfName | True | string |
Nome a ser exibido para o provedor de feedback externo |
|
Solicitar Nota
|
feedbackNote | True | string |
Nota a incluir no pedido de feedback |
|
Título do modelo
|
templateTitle | True | string |
Título do modelo de feedback a utilizar |
|
Prazos de vencimento
|
dueDateInDays | True | number |
Número de dias até que o feedback seja devido |
|
É privado
|
isPrivate | True | boolean |
Se o feedback deve ser privado |
|
É anónimo
|
isAnonymous | True | boolean |
Se os comentários devem ser anónimos |
Devoluções
- Body
- Feedback
Obtém um reconhecimento por ID
Obtém um reconhecimento por ID
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
ID de reconhecimento
|
recognitionId | True | string |
Identificador exclusivo do reconhecimento a recuperar |
Devoluções
- Body
- RecognitionResponse
Obtém um usuário por e-mail
Obtém um usuário por e-mail
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
E-mail do usuário
|
userMail | True | string |
Endereço de e-mail do usuário a ser recuperado |
Devoluções
- Body
- User
Obtém uma meta por ID
Obtém uma meta por ID
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
ID da meta
|
goalId | True | string |
Identificador exclusivo da meta a ser recuperada |
Devoluções
- Body
- Goal
Obtém uma tarefa por ID
Obtém uma tarefa por ID
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
ID da tarefa
|
taskId | True | string |
Identificador exclusivo da tarefa a recuperar |
Devoluções
- Body
- Task
Retorna metas com base nos filtros aplicados
Retorna metas com base nos filtros aplicados
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
ID do objeto do usuário
|
userOID | string |
ID do objeto do usuário cujos objetivos recuperar |
|
|
E-mail do usuário
|
userUPN | string |
Nome Principal do Usuário (e-mail) do usuário cujos objetivos recuperar |
|
|
Pesquisar Texto
|
search | string |
Texto a pesquisar nos títulos e descrições das metas |
|
|
Rótulos de metas
|
selectedLabels | string |
Rótulos para filtrar metas por |
|
|
Limite de resultados
|
limit | string |
Número máximo de golos a fazer |
|
|
Pular contagem
|
skip | string |
Número de metas a serem ignoradas para paginação |
|
|
Data de início
|
startDate | string |
Data de início para filtragem de metas |
|
|
Data de fim
|
endDate | string |
Data de término das metas de filtragem |
Devoluções
- Itens
- Goals
Retorna tarefas com base nos filtros aplicados
Retorna tarefas com base nos filtros aplicados
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
ID do objeto do usuário
|
userOID | string |
ID do objeto do usuário cujas tarefas recuperar |
|
|
E-mail do usuário
|
userUPN | string |
Nome Principal do Usuário (e-mail) do usuário cujas tarefas recuperar |
|
|
Pesquisar Texto
|
search | string |
Texto a procurar nos títulos e descrições das tarefas |
|
|
Limite de resultados
|
limit | number |
Número máximo de tarefas a devolver |
|
|
Pular contagem
|
skip | number |
Número de tarefas a serem ignoradas para paginação |
|
|
Data de início
|
startDate | string |
Data de início das tarefas de filtragem |
|
|
Data de fim
|
endDate | string |
Data de fim das tarefas de filtragem |
Devoluções
- Itens
- Tasks
Definições
Feedback
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Feedback ID
|
id | string |
Identificador exclusivo do feedback |
|
Data de criação
|
createdAt | string |
Data e hora em que o feedback foi criado |
|
Oide
|
createdBy.oid | string | |
|
nome de exibição
|
createdBy.displayName | string | |
|
userPrincipalName
|
createdBy.userPrincipalName | string | |
|
Oide
|
feedbackAboutUser.oid | string | |
|
nome de exibição
|
feedbackAboutUser.displayName | string | |
|
userPrincipalName
|
feedbackAboutUser.userPrincipalName | string | |
|
Oide
|
feedbackRequestRecipient.oid | string | |
|
nome de exibição
|
feedbackRequestRecipient.displayName | string | |
|
userPrincipalName
|
feedbackRequestRecipient.userPrincipalName | string | |
|
Observação
|
note | string | |
|
isPrivate
|
isPrivate | boolean |
Objetivo
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Oide
|
createdBy.oid | string | |
|
nome de exibição
|
createdBy.displayName | string | |
|
userPrincipalName
|
createdBy.userPrincipalName | string | |
|
startDate
|
startDate | string | |
|
data de vencimento
|
dueDate | string | |
|
proprietários
|
owners | array of object | |
|
correio
|
owners.mail | string | |
|
nome de exibição
|
owners.displayName | string | |
|
userPrincipalName
|
owners.userPrincipalName | string | |
|
departamento
|
owners.department | string | |
|
título do trabalho
|
owners.jobTitle | string | |
|
Oide
|
owners.oid | string | |
|
title
|
title | string | |
|
Tipo de golo
|
goalType | string | |
|
isPrivate
|
isPrivate | boolean | |
|
criadosAt
|
createdAt | string | |
|
relacionadoGrupos
|
relatedGroups | array of object | |
|
items
|
relatedGroups | object | |
|
labels
|
labels | array of object | |
|
title
|
labels.title | string | |
|
descrição
|
labels.description | string | |
|
id
|
id | string | |
|
descrição
|
description | string | |
|
id
|
parentGoal.id | string | |
|
title
|
parentGoal.title | string | |
|
formatType
|
progress.formatType | string | |
|
initialValue
|
progress.initialValue | number | |
|
valor-alvo
|
progress.targetValue | number | |
|
currentValue
|
progress.currentValue | number | |
|
estado
|
status | string | |
|
Resultado
|
outcome | string |
Objetivos
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Itens
|
Goal |
RecognitionCreateResponse
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Transações bem-sucedidas
|
successfullyTransactions | array of object | |
|
transactionId
|
successfullyTransactions.transactionId | string | |
|
recipients
|
successfullyTransactions.recipients | array of object | |
|
correio
|
successfullyTransactions.recipients.mail | string | |
|
nome de exibição
|
successfullyTransactions.recipients.displayName | string | |
|
userPrincipalName
|
successfullyTransactions.recipients.userPrincipalName | string | |
|
Oide
|
successfullyTransactions.recipients.oid | string | |
|
descrição
|
successfullyTransactions.badge.description | string | |
|
title
|
successfullyTransactions.badge.title | string | |
|
imageUrl
|
successfullyTransactions.badge.imageUrl | string | |
|
bgImagem
|
successfullyTransactions.badge.bgImage | string | |
|
classificar
|
successfullyTransactions.badge.rank | number | |
|
descrição
|
successfullyTransactions.description | string | |
|
comments
|
successfullyTransactions.comments | array of object | |
|
items
|
successfullyTransactions.comments | object | |
|
gosta
|
successfullyTransactions.likes | array of object | |
|
items
|
successfullyTransactions.likes | object | |
|
failedTransações
|
failedTransactions | array of string |
ReconhecimentoResposta
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
recipients
|
recipients | array of object | |
|
correio
|
recipients.mail | string | |
|
nome de exibição
|
recipients.displayName | string | |
|
userPrincipalName
|
recipients.userPrincipalName | string | |
|
descrição
|
badge.description | string | |
|
title
|
badge.title | string | |
|
imageUrl
|
badge.imageUrl | string | |
|
bgImagem
|
badge.bgImage | string | |
|
Oide
|
badge.updatedBy.oid | string | |
|
nome de exibição
|
badge.updatedBy.displayName | string | |
|
userPrincipalName
|
badge.updatedBy.userPrincipalName | string | |
|
correio
|
badge.updatedBy.mail | string | |
|
descrição
|
description | string | |
|
comments
|
comments | array of object | |
|
businessTelefones
|
comments.user.businessPhones | array of string | |
|
nome de exibição
|
comments.user.displayName | string | |
|
Nome próprio
|
comments.user.givenName | string | |
|
título do trabalho
|
comments.user.jobTitle | string | |
|
correio
|
comments.user.mail | string | |
|
escritórioLocalização
|
comments.user.officeLocation | string | |
|
linguagemPreferida
|
comments.user.preferredLanguage | string | |
|
Apelido
|
comments.user.surname | string | |
|
userPrincipalName
|
comments.user.userPrincipalName | string | |
|
id
|
comments.user.id | string | |
|
comentário
|
comments.comment | string | |
|
gosta
|
likes | array of object | |
|
items
|
likes | object |
ReconhecimentoRespostas
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Itens
|
RecognitionResponse |
Tarefa
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
title
|
title | string | |
|
descrição
|
description | string | |
|
atribuído A
|
assignedTo | array of object | |
|
userPrincipalName
|
assignedTo.user.userPrincipalName | string | |
|
nome de exibição
|
assignedTo.user.displayName | string | |
|
Comentários individuais
|
assignedTo.individualComments | array of object | |
|
items
|
assignedTo.individualComments | object | |
|
attachments
|
attachments | array of object | |
|
items
|
attachments | object | |
|
labels
|
labels | array of string | |
|
descriçãoAnexos
|
descriptionAttachments | array of object | |
|
items
|
descriptionAttachments | object |
Tasks
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Itens
|
Task |
User
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
userPrincipalName
|
userPrincipalName | string | |
|
criadosAt
|
createdAt | string | |
|
lastLoginDate
|
lastLoginDate | string | |
|
departamento
|
department | string | |
|
funcionárioHireDate
|
employeeHireDate | string | |
|
função
|
role | string | |
|
country
|
country | string | |
|
hasManager
|
hasManager | boolean | |
|
isManager
|
isManager | boolean | |
|
título do trabalho
|
jobTitle | string | |
|
escritórioLocalização
|
officeLocation | string | |
|
linguagemPreferida
|
preferredLanguage | string | |
|
nome
|
name | string | |
|
attachments
|
attachments | array of object | |
|
items
|
attachments | object |