Partilhar via

Plumsail HelpDesk

A API permite interagir com o sistema de tíquetes Plumsail HelpDesk. Visite https://plumsail.com/docs/help-desk-o365/v1.x/API/ms-flow.html para mais informações.

Este conector está disponível nos seguintes produtos e regiões:

Serviço Class Regiões
Estúdio Copiloto Standard Todas as regiões do Power Automatic , exceto as seguintes:
     - 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 China
     - Departamento de Defesa dos EUA (DoD)
Aplicações Power Standard Todas as regiões do Power Apps , exceto as seguintes:
     - Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Automatize o poder Standard Todas as regiões do Power Automatic , exceto as seguintes:
     - Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Contato
Nome Vela de ameixa
URL https://plumsail.com/sharepoint-helpdesk
Email support@plumsail.com
Metadados do conector
Editora Plumsail Inc.
Sítio Web https://plumsail.com
Política de privacidade https://plumsail.com/privacy-policy/
Categorias Colaboração; Gestão Empresarial

Este conector ajuda-o a manipular dados no seu HelpDesk com a ajuda do Power Automate.

Visite https://plumsail.com/helpdesk para mais informações.

Plumsail HelpDesk Power Automate Vídeo

Pré-requisitos

Para começar a usá-lo, você precisa preencher os seguintes pré-requisitos:

Em seguida, depois de criar uma chave de API, você estará pronto para criar seu primeiro Flow.

Basta procurar por "Plumsail HelpDesk" no seu Flow e adicionar uma ação apropriada:

Lista de ações do HelpDesk

Quando adiciona uma ação pela primeira vez, ser-lhe-á pedido Connection Name e para Access Key. Você pode digitar qualquer nome para a conexão. Por exemplo, Plumsail HelpDesk.

Em seguida, cole a chave de API que você criou na primeira etapa para Access Key inserir.

Criar conexão de fluxo

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 Compartilhável

Padrão

Aplicável: Todas as regiões

Parâmetros para criar conexão.

Esta é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, a conexão também será compartilhada. Para obter mais informações, consulte a Visão geral de conectores para aplicativos de tela - Power Apps | Documentos Microsoft

Nome Tipo Description Obrigatório
Chave de API securestring A chave de API para esta api Verdade
Região do data center cadeia (de caracteres) Verdade

Limites de Limitação

Name Chamadas Período de Renovação
Chamadas de API por conexão 100 60 segundos

Ações

Atualizar um contacto

Localiza um contato por Id e o atualiza. Retorna contato atualizado.
Atualizar um contato por e-mail

Encontra um contato por e-mail e o atualiza. Retorna contato atualizado.
Atualizar um ticket

Recebe um ticket por Id e o atualiza. Devolve bilhete atualizado.
Atualizar uma organização

Obtém uma organização por Id e a retorna.
Atualizar uma organização por título

Obtém uma organização por título e a atualiza. Retorna a organização atualizada.
Criar um comentário

Cria um novo comentário para um ticket com ID especificado e o devolve.
Criar um contacto

Cria um novo contacto e devolve-o.
Criar um ticket

Cria novo ticket e retorna ticket criado.
Criar uma nova organização

Cria novo item na lista Organizações e o devolve
Descarregar anexo

Retorna o arquivo de anexo para tíquete específico por seu nome ou retorna o código de erro
Excluir um contato

Exclui contato por Id
Excluir um ticket

Exclui ticket por Id.
Excluir uma organização

Exclui a organização por Id.
Excluir uma organização por título

Exclui organização por título
Obtenha uma única organização

Obtém a organização por Id e a retorna
Obter bilhetes

Retorna a lista de objetos TicketRead, cada objeto TicketRead tem os seguintes campos: Category, Created, TicketID, Status, Requester etc. Verifique a definição do objeto TicketRead para obter mais detalhes
Obter contactos

Obter lista de contactos
Obter organizações

Obter lista de organizações
Obter todos os comentários para um bilhete

Obtém todos os comentários para um ticket com ID especificado.
Obter um único contato por e-mail

Recebe um contato por e-mail e o devolve.
Obter um único contato por Id

Obtém um contato por Id e o returs.
Obter uma única organização por título

Obtém uma organização por título e a devolve.
Receba um bilhete único

Recebe um bilhete por Id e devolve-o
Receba um único comentário

Obtém um comentário por ID e o devolve.

Atualizar um contacto

ID da Operação:
_flowV4ContactsByIdPut

Localiza um contato por Id e o atualiza. Retorna contato atualizado.

Parâmetros

Name Chave Necessário Tipo Description
ID de contato
 id True integer

ID de contato
Campos personalizados de contato
 customFields object

Cadeia de caracteres JSON contendo valores de campo personalizados
E-mail de contato
 email True string
E-mail alternativo de contato
 emailAlternate string
Função de contato
 role string
Entre em contato com SPUserId
 spUserId integer
Nome do contato
 title True string

Devoluções

Body
ContactRead

Atualizar um contato por e-mail

ID da Operação:
_flowV4ContactsByEmailByEmailPut

Encontra um contato por e-mail e o atualiza. Retorna contato atualizado.

Parâmetros

Name Chave Necessário Tipo Description
E-mail de contato
 email True string

E-mail de contacto
Campos personalizados de contato
 customFields object

Cadeia de caracteres JSON contendo valores de campo personalizados
E-mail de contato
 email True string
E-mail alternativo de contato
 emailAlternate string
Função de contato
 role string
Entre em contato com SPUserId
 spUserId integer
Nome do contato
 title True string

Devoluções

Body
ContactRead

Atualizar um ticket

ID da Operação:
_flowV4TicketsByIdPut

Recebe um ticket por Id e o atualiza. Devolve bilhete atualizado.

Parâmetros

Name Chave Necessário Tipo Description
ID do bilhete
 id True integer

ID do bilhete
Email do Cessionário de Tíquete ou Nome do Grupo do SharePoint
 assignedToEmail string
AnexoConteúdo
 AttachmentContent True binary

Conteúdo do Ficheiro
Nome do arquivo de anexo
 Name True string
Corpo do Bilhete
 body True string
Categoria do bilhete
 category string
E-mails Ticket Cc
 ccEmails array of string
Campos personalizados de ticket
 customFields object

Cadeia de caracteres JSON contendo valores de campo personalizados
Data de vencimento do bilhete
 dueDate date-time
Prioridade do bilhete
 priority string
E-mail do solicitante de ingresso
 requesterEmail True string
Estado do Bilhete
 status string
Assunto do bilhete
 subject True string
Ticket SupportChannel
 supportChannel string
Ticket Tags Títulos
 tagTitles array of string

Devoluções

Body
TicketRead

Atualizar uma organização

ID da Operação:
_flowV4OrganizationsByIdPut

Obtém uma organização por Id e a retorna.

Parâmetros

Name Chave Necessário Tipo Description
ID da Organização
 id True integer

ID da Organização
Campos personalizados da organização
 customFields object

Cadeia de caracteres JSON contendo valores de campo personalizados
Título da Organização
 title True string

Devoluções

Body
OrganizationRead

Atualizar uma organização por título

ID da Operação:
_flowV4OrganizationsByTitleByTitlePut

Obtém uma organização por título e a atualiza. Retorna a organização atualizada.

Parâmetros

Name Chave Necessário Tipo Description
Título da organização
 title True string

Título da organização
Campos personalizados da organização
 customFields object

Cadeia de caracteres JSON contendo valores de campo personalizados
Título da Organização
 title True string

Devoluções

Body
OrganizationRead

Criar um comentário

ID da Operação:
_flowV4TicketsByTicketIdCommentsPost

Cria um novo comentário para um ticket com ID especificado e o devolve.

Parâmetros

Name Chave Necessário Tipo Description
AnexoConteúdo
 AttachmentContent True binary

Conteúdo do Ficheiro
Nome do arquivo de anexo
 Name True string
Corpo do comentário
 body True string
Comentar campos personalizados
 customFields object

Cadeia de caracteres JSON contendo valores de campo personalizados
Comentário E-mail do autor
 fromEmail True string
Comentário MessageId
 messageId string
ID do bilhete
 ticketId True integer

ID do bilhete

Devoluções

Body
CommentRead

Criar um contacto

ID da Operação:
_flowV4ContactsPost

Cria um novo contacto e devolve-o.

Parâmetros

Name Chave Necessário Tipo Description
Campos personalizados de contato
 customFields object

Cadeia de caracteres JSON contendo valores de campo personalizados
E-mail de contato
 email True string
E-mail alternativo de contato
 emailAlternate string
Função de contato
 role string
Entre em contato com SPUserId
 spUserId integer
Nome do contato
 title True string
Atualizar Contato, se existir
 updateIfExists boolean

Atualizar contato se ele já existir

Devoluções

Body
ContactRead

Criar um ticket

ID da Operação:
_flowV4TicketsPost

Cria novo ticket e retorna ticket criado.

Parâmetros

Name Chave Necessário Tipo Description
Email do Cessionário de Tíquete ou Nome do Grupo do SharePoint
 assignedToEmail string
AnexoConteúdo
 AttachmentContent True binary

Conteúdo do Ficheiro
Nome do arquivo de anexo
 Name True string
Corpo do Bilhete
 body True string
Categoria do bilhete
 category string
E-mails Ticket Cc
 ccEmails array of string
Campos personalizados de ticket
 customFields object

Cadeia de caracteres JSON contendo valores de campo personalizados
Data de vencimento do bilhete
 dueDate date-time
Prioridade do bilhete
 priority string
E-mail do solicitante de ingresso
 requesterEmail True string
Estado do Bilhete
 status string
Assunto do bilhete
 subject True string
Ticket SupportChannel
 supportChannel string
Ticket Tags Títulos
 tagTitles array of string

Devoluções

Body
TicketRead

Criar uma nova organização

ID da Operação:
_flowV4OrganizationsPost

Cria novo item na lista Organizações e o devolve

Parâmetros

Name Chave Necessário Tipo Description
Campos personalizados da organização
 customFields object

Cadeia de caracteres JSON contendo valores de campo personalizados
Título da Organização
 title True string

Devoluções

Body
OrganizationRead

Descarregar anexo

ID da Operação:
_flowV4TicketsByIdAttachmentsByFilenameGet

Retorna o arquivo de anexo para tíquete específico por seu nome ou retorna o código de erro

Parâmetros

Name Chave Necessário Tipo Description
ID do bilhete
 id True integer

ID do bilhete
Nome do arquivo do anexo
 filename True string

Nome do arquivo do anexo

Devoluções

Arquivo de resultados
binary

Excluir um contato

ID da Operação:
_flowV4ContactsByIdDelete

Exclui contato por Id

Parâmetros

Name Chave Necessário Tipo Description
ID de contato
 id True integer

ID de contato

Excluir um ticket

ID da Operação:
_flowV4TicketsByIdDelete

Exclui ticket por Id.

Parâmetros

Name Chave Necessário Tipo Description
ID do bilhete
 id True integer

ID do bilhete

Excluir uma organização

ID da Operação:
_flowV4OrganizationsByIdDelete

Exclui a organização por Id.

Parâmetros

Name Chave Necessário Tipo Description
ID da Organização
 id True integer

ID da Organização

Excluir uma organização por título

ID da Operação:
_flowV4OrganizationsByTitleByTitleDelete

Exclui organização por título

Parâmetros

Name Chave Necessário Tipo Description
Título da organização
 title True string

Título da organização

Obtenha uma única organização

ID da Operação:
_flowV4OrganizationsByIdGet

Obtém a organização por Id e a retorna

Parâmetros

Name Chave Necessário Tipo Description
ID da Organização
 id True integer

ID da Organização
$select
 $select string

Uma opção de consulta $select ODATA para especificar quais campos retornar para um item de lista. Você pode usar * para retornar todos os campos disponíveis.
$expand
 $expand string

Uma opção de consulta ODATA $expand para especificar que a solicitação retorna os valores das pesquisas.

Devoluções

Body
OrganizationRead

Obter bilhetes

ID da Operação:
_flowV4TicketsGet

Retorna a lista de objetos TicketRead, cada objeto TicketRead tem os seguintes campos: Category, Created, TicketID, Status, Requester etc. Verifique a definição do objeto TicketRead para obter mais detalhes

Parâmetros

Name Chave Necessário Tipo Description
$select
 $select string

Uma opção de consulta $select ODATA para especificar quais campos retornar para um item de lista. Você pode usar * para retornar todos os campos disponíveis.
$expand
 $expand string

Uma opção de consulta ODATA $expand para especificar que a solicitação retorna os valores das pesquisas.
$filtro
 $filter string

Uma opção de consulta $filter ODATA. Por exemplo, use $filter=Status/Title eq STATUS ou $filter=Status/Title ne STATUS (STATUS pode ser 'Pendente', 'Novo', 'Em andamento', 'Resolvido' etc) para obter ingressos com status específico, ou $filter=Status/Title ne Solved para obter ingressos ativos, ou $filter=Criado gt '2023-08-18' para obter tickets criados após uma data específica. Use o campo Categoria para filtrar por categoria, AssignedTo/Email para filtrar por e-mail do cessionário, AssignedTo/Title para filtrar por nome do cessionário. Use $filter=substringof('@DOMAIN', Requester/Email) para encontrar uma pessoa com e-mail do domínio (DOMAIN). Bilhetes vencidos são apenas bilhetes ativos onde o DueDate é menor do que hoje.
$orderBy
 $orderBy string

Uma opção de consulta $orderBy ODATA para especificar a ordem das entradas.
$top
 $top integer

Uma opção de consulta $top ODATA para selecionar os primeiros n itens do conjunto de retorno para retorno (padrão = 50, máximo = 100).
$skiptoken
 $skiptoken string

Uma opção de consulta $skiptoken ODATA para ignorar itens até que o item especificado seja alcançado e retornar o restante.

Devoluções

response
array of TicketRead

Obter contactos

ID da Operação:
_flowV4ContactsGet

Obter lista de contactos

Parâmetros

Name Chave Necessário Tipo Description
$select
 $select string

Uma opção de consulta $select ODATA para especificar quais campos retornar para um item de lista. Você pode usar * para retornar todos os campos disponíveis. Use $select=PhoneNumber,Title,Email,ID para incluir o número de telefone.
$expand
 $expand string

Uma opção de consulta ODATA $expand para especificar que a solicitação retorna os valores das pesquisas.
$filtro
 $filter string

Use a opção ODATA $filter para encontrar o contato necessário. Por exemplo, use $filter=Title eq 'Bill Gates' para encontrar a pessoa pelo nome completo. Use $filter=substringof('@DOMAIN', Email) para encontrar uma pessoa com e-mail do domínio (DOMAIN)
$orderBy
 $orderBy string

Uma opção de consulta $orderBy ODATA para especificar a ordem das entradas.
$top
 $top integer

Uma opção de consulta $top ODATA para selecionar os primeiros n itens do conjunto de retorno para retorno (padrão = 50, máximo = 100).
$skiptoken
 $skiptoken string

Uma opção de consulta $skiptoken ODATA para ignorar itens até que o item especificado seja alcançado e retornar o restante.

Devoluções

response
array of ContactRead

Obter organizações

ID da Operação:
_flowV4OrganizationsGet

Obter lista de organizações

Parâmetros

Name Chave Necessário Tipo Description
$select
 $select string

Uma opção de consulta $select ODATA para especificar quais campos retornar para um item de lista. Você pode usar * para retornar todos os campos disponíveis.
$expand
 $expand string

Uma opção de consulta ODATA $expand para especificar que a solicitação retorna os valores das pesquisas.
$filtro
 $filter string

Uma opção de consulta $filter ODATA para restringir as entradas retornadas
$orderBy
 $orderBy string

Uma opção de consulta $orderBy ODATA para especificar a ordem das entradas.
$top
 $top integer

Uma opção de consulta $top ODATA para selecionar os primeiros n itens do conjunto de retorno para retorno (padrão = 50, máximo = 100).
$skiptoken
 $skiptoken string

Uma opção de consulta $skiptoken ODATA para ignorar itens até que o item especificado seja alcançado e retornar o restante.

Devoluções

response
array of OrganizationRead

Obter todos os comentários para um bilhete

ID da Operação:
_flowV4TicketsByTicketIdCommentsGet

Obtém todos os comentários para um ticket com ID especificado.

Parâmetros

Name Chave Necessário Tipo Description
ID do bilhete
 ticketId True integer

ID do bilhete
$select
 $select string

Uma opção de consulta $select ODATA para especificar quais campos retornar para um item de lista. Você pode usar * para retornar todos os campos disponíveis.
$expand
 $expand string

Uma opção de consulta ODATA $expand para especificar que a solicitação retorna os valores das pesquisas.
$filtro
 $filter string

Uma opção de consulta $filter ODATA para restringir as entradas retornadas
$orderBy
 $orderBy string

Uma opção de consulta $orderBy ODATA para especificar a ordem das entradas.

Devoluções

response
array of CommentRead

Obter um único contato por e-mail

ID da Operação:
_flowV4ContactsByEmailByEmailGet

Recebe um contato por e-mail e o devolve.

Parâmetros

Name Chave Necessário Tipo Description
E-mail de contato
 email True string

E-mail de contato
$select
 $select string

Uma opção de consulta $select ODATA para especificar quais campos retornar para um item de lista. Você pode usar * para retornar todos os campos disponíveis.
$expand
 $expand string

Uma opção de consulta ODATA $expand para especificar que a solicitação retorna os valores das pesquisas.

Devoluções

Body
ContactRead

Obter um único contato por Id

ID da Operação:
_flowV4ContactsByIdGet

Obtém um contato por Id e o returs.

Parâmetros

Name Chave Necessário Tipo Description
ID de contato
 id True integer

ID de contato
$select
 $select string

Uma opção de consulta $select ODATA para especificar quais campos retornar para um item de lista. Você pode usar * para retornar todos os campos disponíveis.
$expand
 $expand string

Uma opção de consulta ODATA $expand para especificar que a solicitação retorna os valores das pesquisas.

Devoluções

Body
ContactRead

Obter uma única organização por título

ID da Operação:
_flowV4OrganizationsByTitleByTitleGet

Obtém uma organização por título e a devolve.

Parâmetros

Name Chave Necessário Tipo Description
Título da organização
 title True string

Título da organização
$select
 $select string

Uma opção de consulta $select ODATA para especificar quais campos retornar para um item de lista. Você pode usar * para retornar todos os campos disponíveis.
$expand
 $expand string

Uma opção de consulta ODATA $expand para especificar que a solicitação retorna os valores das pesquisas.

Devoluções

Body
OrganizationRead

Receba um bilhete único

ID da Operação:
_flowV4TicketsByIdGet

Recebe um bilhete por Id e devolve-o

Parâmetros

Name Chave Necessário Tipo Description
ID do bilhete
 id True integer

ID do bilhete
$select
 $select string

Uma opção de consulta $select ODATA para especificar quais campos retornar para um item de lista. Você pode usar * para retornar todos os campos disponíveis.
$expand
 $expand string

Uma opção de consulta ODATA $expand para especificar que a solicitação retorna os valores das pesquisas.

Devoluções

Body
TicketRead

Receba um único comentário

ID da Operação:
_flowV4TicketsByTicketIdCommentsByIdGet

Obtém um comentário por ID e o devolve.

Parâmetros

Name Chave Necessário Tipo Description
ID do bilhete
 ticketId True integer

ID do bilhete
ID do comentário
 id True integer

ID do comentário
$select
 $select string

Uma opção de consulta $select ODATA para especificar quais campos retornar para um item de lista. Você pode usar * para retornar todos os campos disponíveis.
$expand
 $expand string

Uma opção de consulta ODATA $expand para especificar que a solicitação retorna os valores das pesquisas.

Devoluções

Body
CommentRead

Definições

Cessionário

Name Caminho Tipo Description
Cessionário CustomFields
 customFields object

Cadeia de caracteres JSON contendo valores de campo personalizados
Endereço eletrónico do cessionário
 email string
E-mail alternativo do cessionário
 emailAlternate string
ID do cessionário
 id integer
Função de cessionário
 role string
Cessionário SPUserId
 spUserId integer
Nome completo do cessionário
 title string

Cc

Name Caminho Tipo Description
Cc Campos Personalizados
 customFields object

Cadeia de caracteres JSON contendo valores de campo personalizados
Endereço eletrónico Cc
 email string
Cc E-mail alternativo
 emailAlternate string
Cc ID
 id integer
Função Cc
 role string
Cc SPUserId
 spUserId integer
Cc Nome Completo
 title string

ComentárioLer

Name Caminho Tipo Description
Corpo do comentário
 body string
Data de criação do comentário
 created date-time
Comentar campos personalizados
 customFields object

Cadeia de caracteres JSON contendo valores de campo personalizados
Comentário E-mail do autor
 fromEmail string
Comentário Nome do autor
 fromName string
ID do comentário
 id integer
Comentário MessageId
 messageId string

ContactoLer

Name Caminho Tipo Description
Campos personalizados de contato
 customFields object

Cadeia de caracteres JSON contendo valores de campo personalizados
E-mail de contato
 email string
E-mail alternativo de contato
 emailAlternate string
ID de contato
 id integer
Função de contato
 role string
Entre em contato com SPUserId
 spUserId integer
Nome completo do contato
 title string

OrganizaçãoLer

Name Caminho Tipo Description
Campos personalizados da organização
 customFields object

Cadeia de caracteres JSON contendo valores de campo personalizados
ID da Organização
 id integer
Título da Organização
 title string

Requerente

Name Caminho Tipo Description
Campos personalizados do solicitante
 customFields object

Cadeia de caracteres JSON contendo valores de campo personalizados
E-mail do solicitante
 email string
E-mail alternativo do solicitante
 emailAlternate string
ID do solicitante
 id integer
Função de solicitante
 role string
Solicitante SPUserId
 spUserId integer
Nome completo do solicitante
 title string

TagRead

Name Caminho Tipo Description
Marcar campos personalizados
 customFields object

Cadeia de caracteres JSON contendo valores de campo personalizados
ID da etiqueta
 id integer
Título da tag
 title string

BilheteLer

Name Caminho Tipo Description
Cessionário de Bilhetes
 assignedTo Assignee
Anexos de Bilhetes
 attachments array of string
Categoria do bilhete
 category string
Bilhete Cc
 cc array of Cc
Data de Criação do Ticket
 created date-time
Campos personalizados de ticket
 customFields object

Cadeia de caracteres JSON contendo valores de campo personalizados
Data de Vencimento do Bilhete
 dueDate date-time
ID do bilhete
 id integer
Prioridade do bilhete
 priority string
Solicitante de Ingresso
 requester Requester
Data de Resolução do Ticket
 resolutionDate date-time
Estado do Bilhete
 status string
Assunto do bilhete
 subject string
Etiquetas de Bilhete
 tags array of TagRead
ID do bilhete personalizado
 ticketID string

binário

Este é o tipo de dados básico 'binário'.