Compartilhar via

Teamflect (versão prévia)

Aprimore a eficiência do fluxo de trabalho com o Teamflect. Integre perfeitamente os recursos robustos de gerenciamento de desempenho da Teamflect, incluindo metas, comentários e revisões, em seu ecossistema existente. Automatize tarefas rotineiras, sincronize dados entre plataformas e crie fluxos de trabalho dinâmicos e controlados por dados para aumentar a produtividade e o engajamento em toda a sua organização.

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 Bora Unlu
URL https://teamflect.com/contact-us
Email support@teamflect.com
Metadados do conector
Publicador Teamflect
Site https://teamflect.com
Política de privacidade https://teamflect.com/privacy
Categorias Gestão de empresas

Conector do Teamflect Power Automate

Observação: esse é um conector personalizado fornecido para integrar as APIs extensas do Teamflect em seus fluxos de trabalho automatizados no Power Automate e no Power Apps.

O Teamflect Power Automate Connector permite que você gerencie e interaja com metas, comentários, reconhecimentos e tarefas diretamente de seus fluxos de trabalho automatizados. Aproveitando 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:

  1. Um Plano do Microsoft Power Apps ou do Power Automate que inclui suporte para conectores personalizados.

  2. Uma conta teamflect com as permissões de API necessárias para acessar os dados relevantes.

  3. Ferramentas da CLI do Power Platform para criar e implantar o conector.

Compilando o conector

As APIs de 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 teamflect e configurá-la com segurança no Power Automate.

Etapas para criar e configurar o conector:

  1. Obter uma chave de API:

    • Faça logon em sua conta do 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.

  2. Baixar arquivos do conector:

    • Verifique se você tem a definição de API (arquivo OpenAPI/Swagger) para a API teamflect. Esse arquivo define as operações e a estrutura de dados compatíveis com o conector.

  3. Implante o Conector:

    • Use a CLI do 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>

  4. Teste o Conector:

    • Depois de implantado, teste o conector criando um fluxo do Power Automate usando qualquer uma das operações com suporte.

Operações com suporte

O Teamflect Connector dá suporte às seguintes operações:

Gerenciamento de Comentários

  • Enviar solicitação de comentários: inicie uma solicitação de comentários para um usuário especificado.

  • Enviar solicitação de comentários externos: envie uma solicitação de comentários para um endereço de email externo.

Gerenciamento de metas

  • Obter Meta por ID: recuperar detalhes de uma meta específica.

  • Obter Metas: listar várias metas com base nos critérios de pesquisa.

  • Criar Nova Meta: criar 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 ID: recuperar detalhes de um reconhecimento específico.

  • Obter reconhecimentos: listar vários reconhecimentos.

Gerenciamento de Tarefas

  • Obter Tarefa por ID: recuperar uma tarefa por seu identificador exclusivo.

  • Obter Tarefas: listar tarefas com base nos critérios de pesquisa.

Notas de implantação

  • Verifique se a chave de API é armazenada com segurança e não é compartilhada publicamente.

  • Use o conector com responsabilidade para evitar atingir os limites de taxa de API.

  • Consulte a Documentação da API teamflect para obter informações detalhadas sobre a API, incluindo códigos de erro e parâmetros adicionais.

Informações adicionais

Para obter mais detalhes sobre a plataforma Teamflect, visite nosso site. Se você encontrar problemas ou precisar de assistência, entre em contato com nossa equipe de suporte.support@teamflect.com

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
Chave de API secureString A chave de API para esta api Verdade

Limitações

Nome Chamadas Período de renovação
Chamadas à 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 reconhecimento

Cria um novo reconhecimento
Cria uma nova meta

Cria uma nova meta
Envia uma nova solicitação de comentários

Envia uma nova solicitação de comentários.
Envia uma nova solicitação de comentários externos

Envia uma nova solicitação de comentários externos
Obtém um reconhecimento por ID

Obtém um reconhecimento por ID
Obtém um usuário por email

Obtém um usuário por email
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 os reconhecimentos com base nos filtros aplicados

Retorna os reconhecimentos 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

ID da operação:
Add_comment_goal

Adiciona um novo comentário a uma meta

Parâmetros

Nome Chave Obrigatório Tipo Description
ID da meta
 goalId True string

ID da meta
ID do objeto ou nome de entidade de usuário do comentarista
 commenterIdOrUPN True string

ID do objeto ou nome de entidade de usuário do comentarista
Comentário em si
 commentText True string

Comentário em si

Retornos

Corpo
Goal

Atualiza um usuário com atributos selecionados

ID da operação:
Update_user

Atualiza os atributos de um usuário

Parâmetros

Nome Chave Obrigatório Tipo Description
Email do Usuário
 userMail string

O endereço de email 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

ID da operação:
Update_goal

Atualizar o progresso de uma meta

Parâmetros

Nome Chave Obrigatório Tipo Description
ID da meta
 goalId True string

Identificador exclusivo da meta de atualização
Novo valor de progresso
 newValue True string

Novo valor de progresso para a meta
Atualizar Comentário
 comment string

Comentar sobre a atualização de progresso
Novo Status
 status string

Novo status para a meta
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

Retornos

Corpo
Goal

Cria um novo reconhecimento

ID da operação:
Create_recognition

Cria um novo reconhecimento

Parâmetros

Nome Chave Obrigatório Tipo Description
Remetente de Reconhecimento
 senderIdOrUPN True string

Email ou ID da pessoa que está enviando o reconhecimento
Destinatários de reconhecimento
 recipientsIdsOrUPNS True array of string

Lista de emails ou IDs de pessoas que recebem o reconhecimento
Título do selo
 badgeTitle True string

Título do selo de reconhecimento
É privado
 isPrivate True boolean

Se o reconhecimento é privado
Mensagem de reconhecimento
 description True string

Mensagem incluída com o reconhecimento

Retornos

Corpo
RecognitionCreateResponse

Cria uma nova meta

ID da operação:
Create_goal

Cria uma nova meta

Parâmetros

Nome Chave Obrigatório Tipo Description
Título da Meta
 title True string

Título da nova meta
Description
 description True string

Descrição detalhada da nova meta
Data de Início
 startDate True string

Data em que a meta deve ser iniciada
Data de vencimento
 dueDate True string

Data em que a meta deve ser concluída
Tipo de meta
 goalType True string

Tipo da meta
Proprietário da meta
 goalOwnerUPNorId True

Email ou ID do proprietário da meta
Criador de metas
 goalCreatorUPNorId True string

Email ou ID do criador de metas
É privado
 isPrivate True boolean

Se a meta deve ser privada
Formato de progresso
 progressFormatType True string

Tipo de formato para acompanhar o progresso
Código de moeda
 currencyCode True string

Código de moeda para metas monetárias
Valor Inicial
 initialValue True number

Valor de progresso inicial
Valor de destino
 targetValue True number

Valor de progresso de destino
ID da meta pai
 parentGoalId True string

ID da meta pai se essa for uma sub-meta
Notificar Proprietário
 sendNotificationToOwner True boolean

Se deve notificar o proprietário da meta

Retornos

Corpo
Goal

Envia uma nova solicitação de comentários

ID da operação:
Send_feedback_request

Envia uma nova solicitação de comentários.

Parâmetros

Nome Chave Obrigatório Tipo Description
Assunto de comentários
 feedbackAboutUPNorId True string

Email ou ID da pessoa que está recebendo comentários
Provedor de comentários
 feedbackRequestReceiverUPNorId True string

Email ou ID da pessoa que fornecerá comentários
Anotação de solicitação
 feedbackNote True string

Observação para incluir com a solicitação de comentários
Título do modelo
 templateTitle True string

Título do modelo de comentários a ser usado
Dias de conclusão
 dueDateInDays True number

Número de dias até que os comentários sejam devidos
É privado
 isPrivate True boolean

Se os comentários devem ser privados

Retornos

Corpo
Feedback

Envia uma nova solicitação de comentários externos

ID da operação:
Send_external_feedback_Request

Envia uma nova solicitação de comentários externos

Parâmetros

Nome Chave Obrigatório Tipo Description
Assunto de comentários
 feedbackAboutUPNorId True string

Email ou ID da pessoa que está recebendo comentários
Email Externo
 externalEmail True string

Endereço de email do provedor de comentários externos
Nome do provedor
 onBehalfName True string

Nome a ser exibido para o provedor de comentários externos
Anotação de solicitação
 feedbackNote True string

Observação para incluir com a solicitação de comentários
Título do modelo
 templateTitle True string

Título do modelo de comentários a ser usado
Dias de conclusão
 dueDateInDays True number

Número de dias até que os comentários sejam devidos
É privado
 isPrivate True boolean

Se os comentários devem ser privados
É Anônimo
 isAnonymous True boolean

Se os comentários devem ser anônimos

Retornos

Corpo
Feedback

Obtém um reconhecimento por ID

ID da operação:
Get_recognition

Obtém um reconhecimento por ID

Parâmetros

Nome Chave Obrigatório Tipo Description
ID de reconhecimento
 recognitionId True string

Identificador exclusivo do reconhecimento a ser recuperado

Retornos

Corpo
RecognitionResponse

Obtém um usuário por email

ID da operação:
Get_user

Obtém um usuário por email

Parâmetros

Nome Chave Obrigatório Tipo Description
Email do Usuário
 userMail True string

Endereço de email do usuário a ser recuperado

Retornos

Corpo
User

Obtém uma meta por ID

ID da operação:
Get_goal

Obtém uma meta por ID

Parâmetros

Nome Chave Obrigatório Tipo Description
ID da meta
 goalId True string

Identificador exclusivo da meta a ser recuperada

Retornos

Corpo
Goal

Obtém uma tarefa por ID

ID da operação:
Get_task

Obtém uma tarefa por ID

Parâmetros

Nome Chave Obrigatório Tipo Description
ID da Tarefa
 taskId True string

Identificador exclusivo da tarefa a ser recuperada

Retornos

Corpo
Task

Retorna metas com base nos filtros aplicados

ID da operação:
Get_goals

Retorna metas com base nos filtros aplicados

Parâmetros

Nome Chave Obrigatório Tipo Description
ID do objeto do usuário
 userOID string

ID do objeto do usuário cujas metas recuperar
Email do Usuário
 userUPN string

Nome da Entidade de Usuário (email) do usuário cujas metas recuperar
Pesquisar Texto
 search string

Texto a ser pesquisado em títulos e descrições de metas
Rótulos de meta
 selectedLabels string

Rótulos para filtrar metas por
Limite de resultados
 limit string

Número máximo de metas a serem retornadas
Ignorar 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 Término
 endDate string

Data de término para metas de filtragem

Retornos

Itens
Goals

Retorna os reconhecimentos com base nos filtros aplicados

ID da operação:
Get_recognitions

Retorna os reconhecimentos com base nos filtros aplicados

Parâmetros

Nome Chave Obrigatório Tipo Description
Destinatários a serem pesquisados
 recipientsIdsOrUPNS True array of string

Lista de emails ou IDs do destinatário a serem pesquisados
Título de Reconhecimento
 title True string

Título de reconhecimento a ser pesquisado
Data de Atualização
 updated True string

Última data de atualização a ser filtrada por
Data de Criação
 created True string

Data de criação a ser filtrada por

Retornos

Itens
RecognitionResponses

Retorna tarefas com base nos filtros aplicados

ID da operação:
Get_tasks

Retorna tarefas com base nos filtros aplicados

Parâmetros

Nome Chave Obrigatório Tipo Description
ID do objeto do usuário
 userOID string

ID do objeto do usuário cujas tarefas recuperar
Email do Usuário
 userUPN string

Nome da Entidade de Usuário (email) do usuário cujas tarefas recuperar
Pesquisar Texto
 search string

Texto a ser pesquisado em títulos e descrições de tarefas
Limite de resultados
 limit number

Número máximo de tarefas a serem retornadas
Ignorar 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 Término
 endDate string

Data de término para filtragem de tarefas

Retornos

Itens
Tasks

Definições

Comentários

Nome Caminho Tipo Description
ID de comentários
 id string

Identificador exclusivo dos comentários
Data de Criação
 createdAt string

Data e hora em que os comentários foram criados
Sem contexto adicional, mantém-se como "oid".
 createdBy.oid string
nome de exibição
 createdBy.displayName string
userPrincipalName
 createdBy.userPrincipalName string
Sem contexto adicional, mantém-se como "oid".
 feedbackAboutUser.oid string
nome de exibição
 feedbackAboutUser.displayName string
userPrincipalName
 feedbackAboutUser.userPrincipalName string
Sem contexto adicional, mantém-se como "oid".
 feedbackRequestRecipient.oid string
nome de exibição
 feedbackRequestRecipient.displayName string
userPrincipalName
 feedbackRequestRecipient.userPrincipalName string
nota
 note string
éPrivado
 isPrivate boolean

Goal

Nome Caminho Tipo Description
Sem contexto adicional, mantém-se como "oid".
 createdBy.oid string
nome de exibição
 createdBy.displayName string
userPrincipalName
 createdBy.userPrincipalName string
startDate
 startDate string
data de vencimento
 dueDate string
owners
 owners array of object
email
 owners.mail string
nome de exibição
 owners.displayName string
userPrincipalName
 owners.userPrincipalName string
departamento
 owners.department string
título do cargo
 owners.jobTitle string
Sem contexto adicional, mantém-se como "oid".
 owners.oid string
title
 title string
goalType
 goalType string
éPrivado
 isPrivate boolean
createdAt
 createdAt string
relatedGroups
 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
tipo de formato
 progress.formatType string
initialValue
 progress.initialValue number
targetValue
 progress.targetValue number
currentValue
 progress.currentValue number
status
 status string
resultado
 outcome string

Objetivos

Nome Caminho Tipo Description
Itens
 Goal

RecognitionCreateResponse

Nome Caminho Tipo Description
SuccessfullyTransactions
 successfullyTransactions array of object
ID da transação
 successfullyTransactions.transactionId string
destinatários
 successfullyTransactions.recipients array of object
email
 successfullyTransactions.recipients.mail string
nome de exibição
 successfullyTransactions.recipients.displayName string
userPrincipalName
 successfullyTransactions.recipients.userPrincipalName string
Sem contexto adicional, mantém-se como "oid".
 successfullyTransactions.recipients.oid string
descrição
 successfullyTransactions.badge.description string
title
 successfullyTransactions.badge.title string
imageUrl
 successfullyTransactions.badge.imageUrl string
bgImage
 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
FailedTransactions
 failedTransactions array of string

RecognitionResponse

Nome Caminho Tipo Description
destinatários
 recipients array of object
email
 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
bgImage
 badge.bgImage string
Sem contexto adicional, mantém-se como "oid".
 badge.updatedBy.oid string
nome de exibição
 badge.updatedBy.displayName string
userPrincipalName
 badge.updatedBy.userPrincipalName string
email
 badge.updatedBy.mail string
descrição
 description string
comments
 comments array of object
businessPhones
 comments.user.businessPhones array of string
nome de exibição
 comments.user.displayName string
nome dado
 comments.user.givenName string
título do cargo
 comments.user.jobTitle string
email
 comments.user.mail string
officeLocation
 comments.user.officeLocation string
preferredLanguage
 comments.user.preferredLanguage string
surname
 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

RecognitionResponses

Nome Caminho Tipo Description
Itens
 RecognitionResponse

Tarefa

Nome Caminho Tipo Description
title
 title string
descrição
 description string
assignedTo
 assignedTo array of object
userPrincipalName
 assignedTo.user.userPrincipalName string
nome de exibição
 assignedTo.user.displayName string
individualComments
 assignedTo.individualComments array of object
items
 assignedTo.individualComments object
attachments
 attachments array of object
items
 attachments object
labels
 labels array of string
descriptionAttachments
 descriptionAttachments array of object
items
 descriptionAttachments object

Tasks

Nome Caminho Tipo Description
Itens
 Task

Utilizador

Nome Caminho Tipo Description
userPrincipalName
 userPrincipalName string
createdAt
 createdAt string
lastLoginDate
 lastLoginDate string
departamento
 department string
dataContratacaoFuncionario
 employeeHireDate string
função
 role string
country
 country string
hasManager
 hasManager boolean
isManager
 isManager boolean
título do cargo
 jobTitle string
officeLocation
 officeLocation string
preferredLanguage
 preferredLanguage string
nome
 name string
attachments
 attachments array of object
items
 attachments object