Compartir a través de


Teamflect (versión preliminar)

Mejore la eficacia del flujo de trabajo con teamflect. Integre perfectamente las características sólidas de administración del rendimiento de Teamflect, incluidos los objetivos, los comentarios y las revisiones, en el ecosistema existente. Automatice tareas rutinarias, sincronice los datos entre plataformas y cree flujos de trabajo dinámicos controlados por datos para aumentar la productividad y la participación en toda la organización.

Este conector está disponible en los siguientes productos y regiones:

Service Class Regions
Copilot Studio Premium Todas las regiones de Power Automate excepto las siguientes:
     - Gobierno de EE. UU. (GCC)
     - Gobierno de EE. UU. (GCC High)
     - China Cloud operado por 21Vianet
     - Departamento de Defensa de EE. UU. (DoD)
Aplicaciones lógicas Estándar Todas las regiones de Logic Apps excepto las siguientes:
     - Regiones de Azure Government
     - Regiones de Azure China
     - Departamento de Defensa de EE. UU. (DoD)
Power Apps Premium Todas las regiones de Power Apps excepto las siguientes:
     - Gobierno de EE. UU. (GCC)
     - Gobierno de EE. UU. (GCC High)
     - China Cloud operado por 21Vianet
     - Departamento de Defensa de EE. UU. (DoD)
Power Automate Premium Todas las regiones de Power Automate excepto las siguientes:
     - Gobierno de EE. UU. (GCC)
     - Gobierno de EE. UU. (GCC High)
     - China Cloud operado por 21Vianet
     - Departamento de Defensa de EE. UU. (DoD)
Contacto
Nombre Bora Unlu
URL https://teamflect.com/contact-us
Correo Electrónico support@teamflect.com
Metadatos del conector
Publicador Teamflect
Sitio web https://teamflect.com
Directiva de privacidad https://teamflect.com/privacy
Categorías Gestión empresarial

Teamflect Power Automate Connector

Nota: Se trata de un conector personalizado que se proporciona para integrar las API extensas de Teamflect en los flujos de trabajo automatizados de Power Automate y Power Apps.

Teamflect Power Automate Connector permite administrar e interactuar con objetivos, comentarios, reconocimientos y tareas directamente desde los flujos de trabajo automatizados. Al aprovechar este conector, los usuarios pueden simplificar sus procesos de administración de rendimiento mediante la integración perfecta con Microsoft Power Automate.


Prerrequisitos

Para usar este conector, necesitará lo siguiente:

  1. Un plan de Microsoft Power Apps o Power Automate que incluye compatibilidad con conectores personalizados.

  2. Una cuenta de Teamflect con los permisos de API necesarios para acceder a los datos pertinentes.

  3. Herramientas de la CLI de Power Platform para compilar e implementar el conector.


Compilación del conector

Las API de Teamflect se protegen mediante claves de API. Para acceder a las API a través de este conector, deberá obtener la clave de API teamflect y configurarla de forma segura en Power Automate.

Pasos para compilar y configurar el conector:

  1. Obtenga una clave de API:

    • Inicie sesión en su cuenta de Teamflect y vaya a la página configuración de API.

    • Genere una clave de API y manténgala de forma segura. Tendrá que usar esta clave al configurar el conector.

  2. Descargar archivos del conector:

    • Asegúrese de que tiene la definición de API (archivo OpenAPI/Swagger) para teamflect API. Este archivo define las operaciones y la estructura de datos compatibles con el conector.
  3. Implemente el conector:

    • Use la CLI de Power Platform para implementar el conector.

    • Ejecute el comando siguiente para crear el conector:

      paconn create --api-def apiDefinition.swagger.json --api-prop apiProperties.json --secret <api_key>
      
  4. Pruebe el conector:

    • Una vez implementado, pruebe el conector mediante la creación de un flujo de Power Automate mediante cualquiera de las operaciones admitidas.

Operaciones admitidas

Teamflect Connector admite las siguientes operaciones:

Administración de comentarios

  • Enviar solicitud de comentarios: inicie una solicitud de comentarios para un usuario especificado.

  • Enviar solicitud de comentarios externos: envíe una solicitud de comentarios a una dirección de correo electrónico externa.

Administración de objetivos

  • Obtener objetivo por identificador: recupere los detalles de un objetivo específico.

  • Obtener objetivos: enumere varios objetivos en función de los criterios de búsqueda.

  • Crear nuevo objetivo: cree un nuevo objetivo para un usuario.

  • Progreso del objetivo de actualización: actualice el progreso o el estado de un objetivo.

  • Comentario en Objetivo: agregue un comentario a un objetivo.

Reconocimientos

  • Crear reconocimiento: cree un nuevo reconocimiento para uno o varios usuarios.

  • Obtener reconocimiento por identificador: recupere los detalles de un reconocimiento específico.

  • Obtener reconocimientos: enumera varios reconocimientos.

Administración de tareas

  • Obtener tarea por identificador: recupere una tarea por su identificador único.

  • Obtener tareas: enumera las tareas en función de los criterios de búsqueda.


Notas de implementación

  • Asegúrese de que la clave de API se almacena de forma segura y no se comparte públicamente.

  • Use el conector de forma responsable para evitar alcanzar los límites de velocidad de API.

  • Consulte la documentación de teamflect API para obtener información detallada sobre la API, incluidos los códigos de error y los parámetros adicionales.


Información adicional

Para obtener más información sobre la plataforma Teamflect, visite nuestro sitio web. Si tiene algún problema o necesita ayuda, póngase en contacto con nuestro equipo de soporte técnico en support@teamflect.com.

Creación de una conexión

El conector admite los siguientes tipos de autenticación:

Predeterminado Parámetros para crear una conexión. Todas las regiones No se puede compartir

Predeterminado

Aplicable: Todas las regiones

Parámetros para crear una conexión.

Esta conexión no se puede compartir. Si la aplicación de energía se comparte con otro usuario, se pedirá a otro usuario que cree explícitamente una nueva conexión.

Nombre Tipo Description Obligatorio
Clave de API securestring La clave de API de esta API Cierto

Limitaciones

Nombre Llamadas Período de renovación
Llamadas API por conexión 100 60 segundos

Acciones

Actualiza un usuario con atributos seleccionados

Actualiza los atributos de un usuario.

Actualizar el progreso de un objetivo

Actualizar el progreso de un objetivo

Agrega un comentario a un objetivo

Agrega un nuevo comentario a un objetivo

Crea un nuevo objetivo

Crea un nuevo objetivo

Crea un nuevo reconocimiento

Crea un nuevo reconocimiento

Devuelve los reconocimientos basados en los filtros aplicados.

Devuelve los reconocimientos basados en los filtros aplicados.

Devuelve objetivos basados en los filtros aplicados.

Devuelve objetivos basados en los filtros aplicados.

Devuelve tareas basadas en los filtros aplicados.

Devuelve tareas basadas en los filtros aplicados.

Envía una nueva solicitud de comentarios

Envía una nueva solicitud de comentarios.

Envía una nueva solicitud de comentarios externos

Envía una nueva solicitud de comentarios externos

Obtiene un objetivo por identificador.

Obtiene un objetivo por identificador.

Obtiene un reconocimiento por identificador

Obtiene un reconocimiento por identificador

Obtiene un usuario por correo electrónico

Obtiene un usuario por correo electrónico

Obtiene una tarea por identificador

Obtiene una tarea por identificador

Actualiza un usuario con atributos seleccionados

Actualiza los atributos de un usuario.

Parámetros

Nombre Clave Requerido Tipo Description
Email de usuario
userMail string

Dirección de correo electrónico del usuario que se va a actualizar.

Etiqueta de atributo
label string

Nombre del atributo que se va a actualizar.

Valor de atributo
value string

Valor del atributo que se va a actualizar.

Actualizar el progreso de un objetivo

Actualizar el progreso de un objetivo

Parámetros

Nombre Clave Requerido Tipo Description
Id. de objetivo
goalId True string

Identificador único del objetivo que se va a actualizar

Nuevo valor de progreso
newValue True string

Nuevo valor de progreso para el objetivo

Actualizar comentario
comment string

Comentario sobre la actualización de progreso

Nuevo estado
status string

Nuevo estado para el objetivo

Tipo de actualizador
goalUpdater True string

Quién actualiza el objetivo (propietario o sistema)

Nombre del sistema
goalUpdaterSystemName True string

Nombre del sistema que actualiza el objetivo

Devoluciones

Body
Goal

Agrega un comentario a un objetivo

Agrega un nuevo comentario a un objetivo

Parámetros

Nombre Clave Requerido Tipo Description
Identificador del objetivo
goalId True string

Identificador del objetivo

Id. de objeto o Nombre principal de usuario del comentario
commenterIdOrUPN True string

Id. de objeto o Nombre principal de usuario del comentario

Comentario propio
commentText True string

Comentario propio

Devoluciones

Body
Goal

Crea un nuevo objetivo

Crea un nuevo objetivo

Parámetros

Nombre Clave Requerido Tipo Description
Título del objetivo
title True string

Título del nuevo objetivo

Description
description True string

Descripción detallada del nuevo objetivo

Fecha de inicio
startDate True string

Fecha en la que se debe iniciar el objetivo

Fecha límite
dueDate True string

Fecha en la que se debe completar el objetivo

Tipo de objetivo
goalType True string

Tipo del objetivo

Propietario del objetivo
goalOwnerUPNorId True

Correo electrónico o identificador del propietario del objetivo

Creador de objetivos
goalCreatorUPNorId True string

Correo electrónico o identificador del creador del objetivo

Es privado
isPrivate True boolean

Si el objetivo debe ser privado

Formato de progreso
progressFormatType True string

Tipo de formato para el seguimiento del progreso

Código de moneda
currencyCode True string

Código de moneda para objetivos monetarios

Valor inicial
initialValue True number

Valor de progreso inicial

Valor de destino
targetValue True number

Valor de progreso de destino

Id. de objetivo primario
parentGoalId True string

Identificador del objetivo primario si se trata de un sub-objetivo

Notificar al propietario
sendNotificationToOwner True boolean

Indica si se debe notificar al propietario del objetivo

Devoluciones

Body
Goal

Crea un nuevo reconocimiento

Crea un nuevo reconocimiento

Parámetros

Nombre Clave Requerido Tipo Description
Remitente de reconocimiento
senderIdOrUPN True string

Correo electrónico o identificador de la persona que envía el reconocimiento

Destinatarios de reconocimiento
recipientsIdsOrUPNS True array of string

Lista de correos electrónicos o identificadores de personas que reciben el reconocimiento

Título del distintivo
badgeTitle True string

Título del distintivo de reconocimiento

Es privado
isPrivate True boolean

Si el reconocimiento es privado

Mensaje de reconocimiento
description True string

Mensaje incluido con el reconocimiento

Devoluciones

Devuelve los reconocimientos basados en los filtros aplicados.

Devuelve los reconocimientos basados en los filtros aplicados.

Parámetros

Nombre Clave Requerido Tipo Description
Destinatarios para buscar
recipientsIdsOrUPNS True array of string

Lista de correos electrónicos o identificadores de destinatario que se van a buscar

Título del reconocimiento
title True string

Título de reconocimiento que se va a buscar

Fecha de actualización
updated True string

Fecha de última actualización para filtrar por

Fecha de creación
created True string

Fecha de creación por la que se va a filtrar

Devoluciones

Devuelve objetivos basados en los filtros aplicados.

Devuelve objetivos basados en los filtros aplicados.

Parámetros

Nombre Clave Requerido Tipo Description
Id. de objeto de usuario
userOID string

Id. de objeto del usuario cuyos objetivos se van a recuperar

Email de usuario
userUPN string

Nombre principal de usuario (correo electrónico) del usuario cuyos objetivos se van a recuperar

Buscar texto
search string

Texto que se va a buscar en títulos y descripciones de objetivos

Etiquetas de objetivo
selectedLabels string

Etiquetas para filtrar objetivos por

Límite de resultados
limit string

Número máximo de objetivos que se van a devolver

Omitir recuento
skip string

Número de objetivos que se van a omitir para la paginación

Fecha de inicio
startDate string

Fecha de inicio de los objetivos de filtrado

Fecha de finalización
endDate string

Fecha de finalización de los objetivos de filtrado

Devoluciones

Productos
Goals

Devuelve tareas basadas en los filtros aplicados.

Devuelve tareas basadas en los filtros aplicados.

Parámetros

Nombre Clave Requerido Tipo Description
Id. de objeto de usuario
userOID string

Id. de objeto del usuario cuyas tareas se van a recuperar

Email de usuario
userUPN string

Nombre principal de usuario (correo electrónico) del usuario cuyas tareas recuperar

Buscar texto
search string

Texto que se va a buscar en los títulos y descripciones de las tareas

Límite de resultados
limit number

Número máximo de tareas que se van a devolver

Omitir recuento
skip number

Número de tareas que se van a omitir para la paginación

Fecha de inicio
startDate string

Fecha de inicio para filtrar tareas

Fecha de finalización
endDate string

Fecha de finalización de las tareas de filtrado

Devoluciones

Productos
Tasks

Envía una nueva solicitud de comentarios

Envía una nueva solicitud de comentarios.

Parámetros

Nombre Clave Requerido Tipo Description
Asunto de comentarios
feedbackAboutUPNorId True string

Correo electrónico o identificador de la persona que recibe comentarios

Proveedor de comentarios
feedbackRequestReceiverUPNorId True string

Correo electrónico o identificador de la persona que proporcionará comentarios

Nota de solicitud
feedbackNote True string

Nota para incluir con la solicitud de comentarios

Título de plantilla
templateTitle True string

Título de la plantilla de comentarios que se va a usar

Días de vencimiento
dueDateInDays True number

Número de días hasta que se deba enviar los comentarios

Es privado
isPrivate True boolean

Si los comentarios deben ser privados

Devoluciones

Body
Feedback

Envía una nueva solicitud de comentarios externos

Envía una nueva solicitud de comentarios externos

Parámetros

Nombre Clave Requerido Tipo Description
Asunto de comentarios
feedbackAboutUPNorId True string

Correo electrónico o identificador de la persona que recibe comentarios

Correo electrónico externo
externalEmail True string

Dirección de correo electrónico del proveedor de comentarios externos

Nombre del proveedor
onBehalfName True string

Nombre que se va a mostrar para el proveedor de comentarios externos

Nota de solicitud
feedbackNote True string

Nota para incluir con la solicitud de comentarios

Título de plantilla
templateTitle True string

Título de la plantilla de comentarios que se va a usar

Días de vencimiento
dueDateInDays True number

Número de días hasta que se deba enviar los comentarios

Es privado
isPrivate True boolean

Si los comentarios deben ser privados

Es anónimo
isAnonymous True boolean

Si los comentarios deben ser anónimos

Devoluciones

Body
Feedback

Obtiene un objetivo por identificador.

Obtiene un objetivo por identificador.

Parámetros

Nombre Clave Requerido Tipo Description
Id. de objetivo
goalId True string

Identificador único del objetivo que se va a recuperar

Devoluciones

Body
Goal

Obtiene un reconocimiento por identificador

Obtiene un reconocimiento por identificador

Parámetros

Nombre Clave Requerido Tipo Description
Id. de reconocimiento
recognitionId True string

Identificador único del reconocimiento que se va a recuperar

Devoluciones

Obtiene un usuario por correo electrónico

Obtiene un usuario por correo electrónico

Parámetros

Nombre Clave Requerido Tipo Description
Email de usuario
userMail True string

Dirección de correo electrónico del usuario que se va a recuperar

Devoluciones

Body
User

Obtiene una tarea por identificador

Obtiene una tarea por identificador

Parámetros

Nombre Clave Requerido Tipo Description
Id. de la tarea
taskId True string

Identificador único de la tarea que se va a recuperar

Devoluciones

Body
Task

Definiciones

Feedback

Nombre Ruta de acceso Tipo Description
Id. de comentarios
id string

Identificador único de los comentarios

Fecha de creación
createdAt string

Fecha y hora en que se crearon los comentarios

oid
createdBy.oid string
Nombre para mostrar
createdBy.displayName string
userPrincipalName
createdBy.userPrincipalName string
oid
feedbackAboutUser.oid string
Nombre para mostrar
feedbackAboutUser.displayName string
userPrincipalName
feedbackAboutUser.userPrincipalName string
oid
feedbackRequestRecipient.oid string
Nombre para mostrar
feedbackRequestRecipient.displayName string
userPrincipalName
feedbackRequestRecipient.userPrincipalName string
nota
note string
isPrivate
isPrivate boolean

Objetivo

Nombre Ruta de acceso Tipo Description
oid
createdBy.oid string
Nombre para mostrar
createdBy.displayName string
userPrincipalName
createdBy.userPrincipalName string
startDate
startDate string
dueDate
dueDate string
owners
owners array of object
correo
owners.mail string
Nombre para mostrar
owners.displayName string
userPrincipalName
owners.userPrincipalName string
departamento
owners.department string
título del trabajo
owners.jobTitle string
oid
owners.oid string
title
title string
goalType
goalType string
isPrivate
isPrivate boolean
createdAt
createdAt string
relatedGroups
relatedGroups array of object
items
relatedGroups object
labels
labels array of object
title
labels.title string
descripción
labels.description string
id
id string
descripción
description string
id
parentGoal.id string
title
parentGoal.title string
formatType
progress.formatType string
initialValue
progress.initialValue number
targetValue
progress.targetValue number
currentValue
progress.currentValue number
estado
status string
resultado
outcome string

Objetivos

Nombre Ruta de acceso Tipo Description
Productos
Goal

RecognitionCreateResponse

Nombre Ruta de acceso Tipo Description
successfullyTransactions
successfullyTransactions array of object
transactionId
successfullyTransactions.transactionId string
destinatarios
successfullyTransactions.recipients array of object
correo
successfullyTransactions.recipients.mail string
Nombre para mostrar
successfullyTransactions.recipients.displayName string
userPrincipalName
successfullyTransactions.recipients.userPrincipalName string
oid
successfullyTransactions.recipients.oid string
descripción
successfullyTransactions.badge.description string
title
successfullyTransactions.badge.title string
imageUrl
successfullyTransactions.badge.imageUrl string
bgImage
successfullyTransactions.badge.bgImage string
rango
successfullyTransactions.badge.rank number
descripción
successfullyTransactions.description string
comments
successfullyTransactions.comments array of object
items
successfullyTransactions.comments object
Le gusta
successfullyTransactions.likes array of object
items
successfullyTransactions.likes object
failedTransactions
failedTransactions array of string

RecognitionResponse

Nombre Ruta de acceso Tipo Description
destinatarios
recipients array of object
correo
recipients.mail string
Nombre para mostrar
recipients.displayName string
userPrincipalName
recipients.userPrincipalName string
descripción
badge.description string
title
badge.title string
imageUrl
badge.imageUrl string
bgImage
badge.bgImage string
oid
badge.updatedBy.oid string
Nombre para mostrar
badge.updatedBy.displayName string
userPrincipalName
badge.updatedBy.userPrincipalName string
correo
badge.updatedBy.mail string
descripción
description string
comments
comments array of object
businessPhones
comments.user.businessPhones array of string
Nombre para mostrar
comments.user.displayName string
givenName
comments.user.givenName string
título del trabajo
comments.user.jobTitle string
correo
comments.user.mail string
officeLocation
comments.user.officeLocation string
preferredLanguage
comments.user.preferredLanguage string
apellido
comments.user.surname string
userPrincipalName
comments.user.userPrincipalName string
id
comments.user.id string
comentario
comments.comment string
Le gusta
likes array of object
items
likes object

RecognitionResponses

Nombre Ruta de acceso Tipo Description
Productos
RecognitionResponse

Tarea

Nombre Ruta de acceso Tipo Description
title
title string
descripción
description string
assignedTo
assignedTo array of object
userPrincipalName
assignedTo.user.userPrincipalName string
Nombre para mostrar
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

Nombre Ruta de acceso Tipo Description
Productos
Task

Usuario

Nombre Ruta de acceso Tipo Description
userPrincipalName
userPrincipalName string
createdAt
createdAt string
lastLoginDate
lastLoginDate string
departamento
department string
fechaContrataciónEmpleado
employeeHireDate string
role
role string
country
country string
hasManager
hasManager boolean
isManager
isManager boolean
título del trabajo
jobTitle string
officeLocation
officeLocation string
preferredLanguage
preferredLanguage string
nombre
name string
attachments
attachments array of object
items
attachments object