Compartir a través de

Plumsail HelpDesk

La API permite interactuar con el sistema de vales plumsail HelpDesk. Visite https://plumsail.com/docs/help-desk-o365/v1.x/API/ms-flow.html para obtener más información.

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

Service Class Regions
Copilot Studio Estándar Todas las regiones de Power Automate excepto las siguientes:
     - 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 China
     - Departamento de Defensa de EE. UU. (DoD)
Power Apps Estándar Todas las regiones de Power Apps excepto las siguientes:
     - Gobierno de EE. UU. (GCC High)
     - China Cloud operado por 21Vianet
     - Departamento de Defensa de EE. UU. (DoD)
Power Automate Estándar Todas las regiones de Power Automate excepto las siguientes:
     - Gobierno de EE. UU. (GCC High)
     - China Cloud operado por 21Vianet
     - Departamento de Defensa de EE. UU. (DoD)
Contacto
Nombre Plumsail
URL https://plumsail.com/sharepoint-helpdesk
Correo Electrónico support@plumsail.com
Metadatos del conector
Publicador Plumsail Inc.
Website https://plumsail.com
Directiva de privacidad https://plumsail.com/privacy-policy/
Categorías Colaboración; Gestión empresarial

Este conector le ayuda a manipular datos en el departamento de soporte técnico con la ayuda de Power Automate.

Visite https://plumsail.com/helpdesk para obtener más información.

Plumsail HelpDesk Power Automate

Prerrequisitos

Para empezar a usarlo, debe completar los siguientes requisitos previos:

Después, una vez creada una clave de API, estará listo para crear el primer flujo.

Solo tiene que buscar "Plumsail HelpDesk" en Flow y agregar una acción adecuada:

Lista de acciones de HelpDesk

Al agregar una acción por primera vez, se le pedirá Connection Name y para Access Key. Puede escribir cualquier nombre para la conexión. Por ejemplo: Plumsail HelpDesk.

A continuación, pegue la clave de API que creó en el primer paso para Access Key la entrada.

Creación de una conexión de flujo

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 Compartible

Predeterminado

Aplicable: Todas las regiones

Parámetros para crear una conexión.

Se trata de una conexión que se puede compartir. Si la aplicación de energía se comparte con otro usuario, también se comparte la conexión. Para más información, consulte introducción a los conectores para aplicaciones de lienzo: Power Apps | Microsoft Docs

Nombre Tipo Description Obligatorio
Clave de API securestring La clave de API de esta API Cierto
Región del centro de datos cuerda / cadena Cierto

Limitaciones

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

Acciones

Actualizar un contacto

Busca un contacto por id. y lo actualiza. Devuelve el contacto actualizado.
Actualizar un contacto por correo electrónico

Busca un contacto por correo electrónico y lo actualiza. Devuelve el contacto actualizado.
Actualizar un vale

Obtiene un vale por identificador y lo actualiza. Devuelve el vale actualizado.
Actualizar una organización

Obtiene una organización por identificador y la devuelve.
Actualizar una organización por título

Obtiene una organización por título y la actualiza. Devuelve la organización actualizada.
Creación de un contacto

Crea un nuevo contacto y lo devuelve.
Creación de un vale

Crea un nuevo vale y devuelve el vale creado.
Creación de una organización

Crea un nuevo elemento en la lista Organizaciones y lo devuelve.
Crear un comentario

Crea un nuevo comentario para un vale con el identificador especificado y lo devuelve.
Descargar datos adjuntos

Devuelve el archivo adjunto para un vale específico por su nombre o devuelve el código de error.
Eliminación de una organización por título

Elimina la organización por título
Eliminar un contacto

Elimina el contacto por identificador
Eliminar un vale

Elimina vale por identificador.
Eliminar una organización

Elimina la organización por identificador.
Obtención de organizaciones

Obtener la lista de organizaciones
Obtención de un solo vale

Obtiene un vale por identificador y lo devuelve.
Obtención de una sola organización

Obtiene la organización por identificador y la devuelve.
Obtención de una sola organización por título

Obtiene una organización por título y la devuelve.
Obtener contactos

Obtener lista de contactos
Obtener todos los comentarios de un vale

Obtiene todos los comentarios de un vale con el identificador especificado.
Obtener un único comentario

Obtiene un comentario por identificador y lo devuelve.
Obtener un único contacto por correo electrónico

Obtiene un contacto por correo electrónico y lo devuelve.
Obtener un único contacto por identificador

Obtiene un contacto por id. y lo vuelve a cambiar.
Obtener vales

Devuelve la lista de objetos TicketRead, cada objeto TicketRead tiene los siguientes campos: Category, Created, TicketID, Status, Requester, etc. Check TicketRead object definition para obtener más detalles.

Actualizar un contacto

Id. de la operación:
_flowV4ContactsByIdPut

Busca un contacto por id. y lo actualiza. Devuelve el contacto actualizado.

Parámetros

Nombre Clave Requerido Tipo Description
ID de contacto
 id True integer

ID de contacto
Ponerse en contacto con campos personalizados
 customFields object

Cadena JSON que contiene valores de campo personalizados
Correo electrónico de contacto
 email True string
Ponerse en contacto con correo electrónico alternativo
 emailAlternate string
Rol de contacto
 role string
Ponerse en contacto con SPUserId
 spUserId integer
Nombre de contacto
 title True string

Devoluciones

Body
ContactRead

Actualizar un contacto por correo electrónico

Id. de la operación:
_flowV4ContactsByEmailByEmailPut

Busca un contacto por correo electrónico y lo actualiza. Devuelve el contacto actualizado.

Parámetros

Nombre Clave Requerido Tipo Description
Correo electrónico de contacto
 email True string

Correo electrónico de contacto
Ponerse en contacto con campos personalizados
 customFields object

Cadena JSON que contiene valores de campo personalizados
Correo electrónico de contacto
 email True string
Ponerse en contacto con correo electrónico alternativo
 emailAlternate string
Rol de contacto
 role string
Ponerse en contacto con SPUserId
 spUserId integer
Nombre de contacto
 title True string

Devoluciones

Body
ContactRead

Actualizar un vale

Id. de la operación:
_flowV4TicketsByIdPut

Obtiene un vale por identificador y lo actualiza. Devuelve el vale actualizado.

Parámetros

Nombre Clave Requerido Tipo Description
Id. de vale
 id True integer

Id. de vale
Correo electrónico del destinatario de vales o nombre del grupo de SharePoint
 assignedToEmail string
AttachmentContent
 AttachmentContent True binary

Contenido del archivo
Nombre de archivo adjunto
 Name True string
Cuerpo del vale
 body True string
Categoría de vale
 category string
Correos electrónicos de Ticket Cc
 ccEmails array of string
Campos personalizados de vale
 customFields object

Cadena JSON que contiene valores de campo personalizados
Ticket DueDate
 dueDate date-time
Prioridad del vale
 priority string
Correo electrónico del solicitante de vales
 requesterEmail True string
Estado del vale
 status string
Asunto del vale
 subject True string
Ticket SupportChannel
 supportChannel string
Títulos de etiquetas de vale
 tagTitles array of string

Devoluciones

Body
TicketRead

Actualizar una organización

Id. de la operación:
_flowV4OrganizationsByIdPut

Obtiene una organización por identificador y la devuelve.

Parámetros

Nombre Clave Requerido Tipo Description
Identificador de organización
 id True integer

Identificador de organización
Campos personalizados de la organización
 customFields object

Cadena JSON que contiene valores de campo personalizados
Título de la organización
 title True string

Devoluciones

Body
OrganizationRead

Actualizar una organización por título

Id. de la operación:
_flowV4OrganizationsByTitleByTitlePut

Obtiene una organización por título y la actualiza. Devuelve la organización actualizada.

Parámetros

Nombre Clave Requerido Tipo Description
Título de la organización
 title True string

Título de la organización
Campos personalizados de la organización
 customFields object

Cadena JSON que contiene valores de campo personalizados
Título de la organización
 title True string

Devoluciones

Body
OrganizationRead

Creación de un contacto

Id. de la operación:
_flowV4ContactsPost

Crea un nuevo contacto y lo devuelve.

Parámetros

Nombre Clave Requerido Tipo Description
Ponerse en contacto con campos personalizados
 customFields object

Cadena JSON que contiene valores de campo personalizados
Correo electrónico de contacto
 email True string
Ponerse en contacto con correo electrónico alternativo
 emailAlternate string
Rol de contacto
 role string
Ponerse en contacto con SPUserId
 spUserId integer
Nombre de contacto
 title True string
Actualizar contacto si existe
 updateIfExists boolean

Actualizar contacto si ya existe

Devoluciones

Body
ContactRead

Creación de un vale

Id. de la operación:
_flowV4TicketsPost

Crea un nuevo vale y devuelve el vale creado.

Parámetros

Nombre Clave Requerido Tipo Description
Correo electrónico del destinatario de vales o nombre del grupo de SharePoint
 assignedToEmail string
AttachmentContent
 AttachmentContent True binary

Contenido del archivo
Nombre de archivo adjunto
 Name True string
Cuerpo del vale
 body True string
Categoría de vale
 category string
Correos electrónicos de Ticket Cc
 ccEmails array of string
Campos personalizados de vale
 customFields object

Cadena JSON que contiene valores de campo personalizados
Ticket DueDate
 dueDate date-time
Prioridad del vale
 priority string
Correo electrónico del solicitante de vales
 requesterEmail True string
Estado del vale
 status string
Asunto del vale
 subject True string
Ticket SupportChannel
 supportChannel string
Títulos de etiquetas de vale
 tagTitles array of string

Devoluciones

Body
TicketRead

Creación de una organización

Id. de la operación:
_flowV4OrganizationsPost

Crea un nuevo elemento en la lista Organizaciones y lo devuelve.

Parámetros

Nombre Clave Requerido Tipo Description
Campos personalizados de la organización
 customFields object

Cadena JSON que contiene valores de campo personalizados
Título de la organización
 title True string

Devoluciones

Body
OrganizationRead

Crear un comentario

Id. de la operación:
_flowV4TicketsByTicketIdCommentsPost

Crea un nuevo comentario para un vale con el identificador especificado y lo devuelve.

Parámetros

Nombre Clave Requerido Tipo Description
AttachmentContent
 AttachmentContent True binary

Contenido del archivo
Nombre de archivo adjunto
 Name True string
Cuerpo del comentario
 body True string
Comentar campos personalizados
 customFields object

Cadena JSON que contiene valores de campo personalizados
Correo electrónico del autor de comentarios
 fromEmail True string
Comment MessageId
 messageId string
Id. de vale
 ticketId True integer

Id. de vale

Devoluciones

Body
CommentRead

Descargar datos adjuntos

Id. de la operación:
_flowV4TicketsByIdAttachmentsByFilenameGet

Devuelve el archivo adjunto para un vale específico por su nombre o devuelve el código de error.

Parámetros

Nombre Clave Requerido Tipo Description
Id. de vale
 id True integer

Id. de vale
Nombre de archivo adjunto
 filename True string

Nombre de archivo adjunto

Devoluciones

Archivo de resultados
binary

Eliminación de una organización por título

Id. de la operación:
_flowV4OrganizationsByTitleByTitleDelete

Elimina la organización por título

Parámetros

Nombre Clave Requerido Tipo Description
Título de la organización
 title True string

Título de la organización

Eliminar un contacto

Id. de la operación:
_flowV4ContactsByIdDelete

Elimina el contacto por identificador

Parámetros

Nombre Clave Requerido Tipo Description
ID de contacto
 id True integer

ID de contacto

Eliminar un vale

Id. de la operación:
_flowV4TicketsByIdDelete

Elimina vale por identificador.

Parámetros

Nombre Clave Requerido Tipo Description
Id. de vale
 id True integer

Id. de vale

Eliminar una organización

Id. de la operación:
_flowV4OrganizationsByIdDelete

Elimina la organización por identificador.

Parámetros

Nombre Clave Requerido Tipo Description
Identificador de organización
 id True integer

Identificador de organización

Obtención de organizaciones

Id. de la operación:
_flowV4OrganizationsGet

Obtener la lista de organizaciones

Parámetros

Nombre Clave Requerido Tipo Description
$select
 $select string

Una opción de consulta de ODATA $select para especificar qué campos se van a devolver para un elemento de lista. Puede usar * para devolver todos los campos disponibles.
$expand
 $expand string

Una opción de consulta de ODATA $expand para especificar que la solicitud devuelve los valores de las búsquedas.
$filtro
 $filter string

Una opción de consulta de ODATA $filter para restringir las entradas devueltas
$orderBy
 $orderBy string

Una opción de consulta de ODATA $orderBy para especificar el orden de las entradas.
$top
 $top integer

Una opción de consulta de ODATA $top para seleccionar los primeros n elementos del conjunto de valor devuelto para la devolución (valor predeterminado = 50, máximo = 100).
$skiptoken
 $skiptoken string

Una opción de consulta de ODATA $skiptoken omitir los elementos hasta que se alcance el elemento especificado y devuelva el resto.

Devoluciones

response
array of OrganizationRead

Obtención de un solo vale

Id. de la operación:
_flowV4TicketsByIdGet

Obtiene un vale por identificador y lo devuelve.

Parámetros

Nombre Clave Requerido Tipo Description
Id. de vale
 id True integer

Id. de vale
$select
 $select string

Una opción de consulta de ODATA $select para especificar qué campos se van a devolver para un elemento de lista. Puede usar * para devolver todos los campos disponibles.
$expand
 $expand string

Una opción de consulta de ODATA $expand para especificar que la solicitud devuelve los valores de las búsquedas.

Devoluciones

Body
TicketRead

Obtención de una sola organización

Id. de la operación:
_flowV4OrganizationsByIdGet

Obtiene la organización por identificador y la devuelve.

Parámetros

Nombre Clave Requerido Tipo Description
Identificador de organización
 id True integer

Identificador de organización
$select
 $select string

Una opción de consulta de ODATA $select para especificar qué campos se van a devolver para un elemento de lista. Puede usar * para devolver todos los campos disponibles.
$expand
 $expand string

Una opción de consulta de ODATA $expand para especificar que la solicitud devuelve los valores de las búsquedas.

Devoluciones

Body
OrganizationRead

Obtención de una sola organización por título

Id. de la operación:
_flowV4OrganizationsByTitleByTitleGet

Obtiene una organización por título y la devuelve.

Parámetros

Nombre Clave Requerido Tipo Description
Título de la organización
 title True string

Título de la organización
$select
 $select string

Una opción de consulta de ODATA $select para especificar qué campos se van a devolver para un elemento de lista. Puede usar * para devolver todos los campos disponibles.
$expand
 $expand string

Una opción de consulta de ODATA $expand para especificar que la solicitud devuelve los valores de las búsquedas.

Devoluciones

Body
OrganizationRead

Obtener contactos

Id. de la operación:
_flowV4ContactsGet

Obtener lista de contactos

Parámetros

Nombre Clave Requerido Tipo Description
$select
 $select string

Una opción de consulta de ODATA $select para especificar qué campos se van a devolver para un elemento de lista. Puede usar * para devolver todos los campos disponibles. Use $select=PhoneNumber,Title,Email,ID para incluir el número de teléfono.
$expand
 $expand string

Una opción de consulta de ODATA $expand para especificar que la solicitud devuelve los valores de las búsquedas.
$filtro
 $filter string

Use la opción ODATA $filter para buscar el contacto necesario. Por ejemplo, use $filter=Title eq "Bill Gates" para buscar a la persona por nombre completo. Use $filter=substringof('@DOMAIN', Email) para buscar a la persona con correo electrónico del dominio (DOMINIO)
$orderBy
 $orderBy string

Una opción de consulta de ODATA $orderBy para especificar el orden de las entradas.
$top
 $top integer

Una opción de consulta de ODATA $top para seleccionar los primeros n elementos del conjunto de valor devuelto para la devolución (valor predeterminado = 50, máximo = 100).
$skiptoken
 $skiptoken string

Una opción de consulta de ODATA $skiptoken omitir los elementos hasta que se alcance el elemento especificado y devuelva el resto.

Devoluciones

response
array of ContactRead

Obtener todos los comentarios de un vale

Id. de la operación:
_flowV4TicketsByTicketIdCommentsGet

Obtiene todos los comentarios de un vale con el identificador especificado.

Parámetros

Nombre Clave Requerido Tipo Description
Id. de vale
 ticketId True integer

Id. de vale
$select
 $select string

Una opción de consulta de ODATA $select para especificar qué campos se van a devolver para un elemento de lista. Puede usar * para devolver todos los campos disponibles.
$expand
 $expand string

Una opción de consulta de ODATA $expand para especificar que la solicitud devuelve los valores de las búsquedas.
$filtro
 $filter string

Una opción de consulta de ODATA $filter para restringir las entradas devueltas
$orderBy
 $orderBy string

Una opción de consulta de ODATA $orderBy para especificar el orden de las entradas.

Devoluciones

response
array of CommentRead

Obtener un único comentario

Id. de la operación:
_flowV4TicketsByTicketIdCommentsByIdGet

Obtiene un comentario por identificador y lo devuelve.

Parámetros

Nombre Clave Requerido Tipo Description
Id. de vale
 ticketId True integer

Id. de vale
Id. de comentario
 id True integer

Id. de comentario
$select
 $select string

Una opción de consulta de ODATA $select para especificar qué campos se van a devolver para un elemento de lista. Puede usar * para devolver todos los campos disponibles.
$expand
 $expand string

Una opción de consulta de ODATA $expand para especificar que la solicitud devuelve los valores de las búsquedas.

Devoluciones

Body
CommentRead

Obtener un único contacto por correo electrónico

Id. de la operación:
_flowV4ContactsByEmailByEmailGet

Obtiene un contacto por correo electrónico y lo devuelve.

Parámetros

Nombre Clave Requerido Tipo Description
Correo electrónico de contacto
 email True string

Correo electrónico de contacto
$select
 $select string

Una opción de consulta de ODATA $select para especificar qué campos se van a devolver para un elemento de lista. Puede usar * para devolver todos los campos disponibles.
$expand
 $expand string

Una opción de consulta de ODATA $expand para especificar que la solicitud devuelve los valores de las búsquedas.

Devoluciones

Body
ContactRead

Obtener un único contacto por identificador

Id. de la operación:
_flowV4ContactsByIdGet

Obtiene un contacto por id. y lo vuelve a cambiar.

Parámetros

Nombre Clave Requerido Tipo Description
ID de contacto
 id True integer

ID de contacto
$select
 $select string

Una opción de consulta de ODATA $select para especificar qué campos se van a devolver para un elemento de lista. Puede usar * para devolver todos los campos disponibles.
$expand
 $expand string

Una opción de consulta de ODATA $expand para especificar que la solicitud devuelve los valores de las búsquedas.

Devoluciones

Body
ContactRead

Obtener vales

Id. de la operación:
_flowV4TicketsGet

Devuelve la lista de objetos TicketRead, cada objeto TicketRead tiene los siguientes campos: Category, Created, TicketID, Status, Requester, etc. Check TicketRead object definition para obtener más detalles.

Parámetros

Nombre Clave Requerido Tipo Description
$select
 $select string

Una opción de consulta de ODATA $select para especificar qué campos se van a devolver para un elemento de lista. Puede usar * para devolver todos los campos disponibles.
$expand
 $expand string

Una opción de consulta de ODATA $expand para especificar que la solicitud devuelve los valores de las búsquedas.
$filtro
 $filter string

Una opción de consulta $filter ODATA. Por ejemplo, use $filter=Status/Title eq STATUS o $filter=Status/Title ne STATUS (STATUS puede ser 'Pending', 'New', 'In Progress', 'Resolve' etc) para obtener vales por con un estado específico, o $filter=Status/Title ne Resuelto para obtener vales activos, o $filter=Created gt '2023-08-18' para obtener vales creados después de una fecha específica. Use el campo Categoría para filtrar por categoría, AssignedTo/Email para filtrar por correo electrónico asignado, AssignedTo/Title para filtrar por nombre asignado. Use $filter=substringof('@DOMAIN', Solicitante/Correo electrónico) para buscar a la persona con correo electrónico del dominio (DOMINIO). Las entradas vencidas son solo entradas activas en las que DueDate es menor que hoy.
$orderBy
 $orderBy string

Una opción de consulta de ODATA $orderBy para especificar el orden de las entradas.
$top
 $top integer

Una opción de consulta de ODATA $top para seleccionar los primeros n elementos del conjunto de valor devuelto para la devolución (valor predeterminado = 50, máximo = 100).
$skiptoken
 $skiptoken string

Una opción de consulta de ODATA $skiptoken omitir los elementos hasta que se alcance el elemento especificado y devuelva el resto.

Devoluciones

response
array of TicketRead

Definiciones

Persona asignada

Nombre Ruta de acceso Tipo Description
CustomFields asignado
 customFields object

Cadena JSON que contiene valores de campo personalizados
Correo electrónico asignado
 email string
Correo electrónico alternativo asignado
 emailAlternate string
Id. de asignado
 id integer
Rol asignado
 role string
Assignee SPUserId
 spUserId integer
Nombre completo del receptor
 title string

CC

Nombre Ruta de acceso Tipo Description
Cc CustomFields
 customFields object

Cadena JSON que contiene valores de campo personalizados
Correo electrónico cc
 email string
Cc Alternate Email
 emailAlternate string
Id. cc
 id integer
Rol Cc
 role string
Cc SPUserId
 spUserId integer
Nombre completo cc
 title string

CommentRead

Nombre Ruta de acceso Tipo Description
Cuerpo del comentario
 body string
Fecha de creación de comentarios
 created date-time
Comentar campos personalizados
 customFields object

Cadena JSON que contiene valores de campo personalizados
Correo electrónico del autor de comentarios
 fromEmail string
Nombre del autor del comentario
 fromName string
Id. de comentario
 id integer
Comment MessageId
 messageId string

ContactRead

Nombre Ruta de acceso Tipo Description
Ponerse en contacto con campos personalizados
 customFields object

Cadena JSON que contiene valores de campo personalizados
Correo electrónico de contacto
 email string
Ponerse en contacto con correo electrónico alternativo
 emailAlternate string
ID de contacto
 id integer
Rol de contacto
 role string
Ponerse en contacto con SPUserId
 spUserId integer
Nombre completo de contacto
 title string

OrganizationRead

Nombre Ruta de acceso Tipo Description
Campos personalizados de la organización
 customFields object

Cadena JSON que contiene valores de campo personalizados
Id. de organización
 id integer
Título de la organización
 title string

Solicitante

Nombre Ruta de acceso Tipo Description
CustomFields del solicitante
 customFields object

Cadena JSON que contiene valores de campo personalizados
Correo electrónico del solicitante
 email string
Correo electrónico alternativo del solicitante
 emailAlternate string
Id. del solicitante
 id integer
Rol del solicitante
 role string
SpUserId del solicitante
 spUserId integer
Nombre completo del solicitante
 title string

TagRead

Nombre Ruta de acceso Tipo Description
Etiquetar campos personalizados
 customFields object

Cadena JSON que contiene valores de campo personalizados
Identificador de etiqueta
 id integer
Título de etiqueta
 title string

TicketRead

Nombre Ruta de acceso Tipo Description
Asignador de vales
 assignedTo Assignee
Datos adjuntos de vales
 attachments array of string
Categoría de vale
 category string
Ticket Cc
 cc array of Cc
Fecha de creación de vales
 created date-time
Campos personalizados de vale
 customFields object

Cadena JSON que contiene valores de campo personalizados
Fecha de vencimiento del vale
 dueDate date-time
Id. de vale
 id integer
Prioridad del vale
 priority string
Solicitante de vales
 requester Requester
Fecha de resolución de vales
 resolutionDate date-time
Estado del vale
 status string
Asunto del vale
 subject string
Etiquetas de vale
 tags array of TagRead
Identificador de vale personalizado
 ticketID string

binary

Este es el tipo de datos básico "binary".