Freshdesk
O Freshdesk é uma solução de suporte ao cliente baseada em nuvem que ajudará você a simplificar o atendimento ao cliente e garantir que seus clientes recebam o suporte que merecem! O conector freshdesk destina-se aos agentes do Freshdesk para gerenciar tíquetes e contatos.
Esse conector está disponível nos seguintes produtos e regiões:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Standard | Todas as regiões do Power Automate , exceto as seguintes: – 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 China - Departamento de Defesa dos EUA (DoD) |
| Power Apps | 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) |
| Power Automate | Standard | Todas as regiões do Power Automate , exceto as seguintes: – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Contato | |
|---|---|
| Nome | Microsoft |
| URL |
Suporte do Microsoft LogicApps Suporte do Microsoft Power Automate Suporte do Microsoft Power Apps |
| Metadados do conector | |
|---|---|
| Publicador | Microsoft |
| Site | https://freshdesk.com/ |
| Política de privacidade | https://www.freshworks.com/privacy/ |
Problemas e limitações conhecidos
- Para gatilhos "Quando um tíquete é criado", "Quando um tíquete atribuído a um agente é atualizado", a descrição "Quando um tíquete é atualizado" do tíquete não é retornada por padrão na resposta. Você pode especificar como incluí-lo na resposta do gatilho definindo o parâmetro "Incluir descrição" como "Sim". No entanto, observe que isso está associado a custos extras para sua conta no lado do Freshdesk, já que a inserção é usada nesse caso. Se você precisar da descrição do tíquete, recomendamos usar o gatilho em combinação com a ação "Obter tíquete", pois a resposta dessa ação inclui a descrição por padrão.
- No momento, não há suporte para a criação do tipo de tíquete "Tarefa de Serviço".
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 |
|---|---|---|---|
| URL da Conta | cadeia | Por exemplo: https://company.freshdesk.com | Verdade |
| Email ou chave de API (https://aka.ms/ii9u75) | cadeia | Seu endereço de email | Verdade |
| Senha | secureString | Senha (se estiver usando a chave de API, qualquer valor poderá ser especificado) | Verdade |
Limitações
| Nome | Chamadas | Período de renovação |
|---|---|---|
| Chamadas à API por conexão | 100 | 60 segundos |
| Frequência das pesquisas de gatilho | 1 | 15 s |
Ações
| Adicionar uma anotação a um tíquete |
Adicione uma nota privada ou pública a um tíquete. |
| Atualizar um tíquete |
Atualize um tíquete (somente valores especificados serão atualizados). |
| Criar um tíquete |
Crie um tíquete. |
| Obter tíquete |
Obtenha um tíquete por ID. |
Adicionar uma anotação a um tíquete
Adicione uma nota privada ou pública a um tíquete.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do tíquete
|
ticketId | True | integer |
A ID do tíquete à qual adicionar uma anotação. |
|
Content
|
body | True | string |
O conteúdo da anotação. |
|
Privado
|
private | boolean |
Indica se essa é uma nota privada (o padrão é verdadeiro). |
Retornos
- Corpo
- AddNote200Response
Atualizar um tíquete
Atualize um tíquete (somente valores especificados serão atualizados).
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do tíquete
|
ticketId | True | integer |
A ID do tíquete a ser atualizada. |
|
Description
|
description | string |
A descrição do tíquete. |
|
|
Assunto
|
subject | string |
O assunto do tíquete. |
|
|
Priority
|
priority | string |
A prioridade do tíquete. |
|
|
Situação
|
status | string |
O status do tíquete. |
|
|
Tipo
|
type | string |
Ajuda a categorizar o tíquete de acordo com os diferentes tipos de problemas que sua equipe de suporte lida. |
|
|
Data de Conclusão
|
due_by | date-time |
Carimbo de data/hora que indica quando o tíquete deve ser resolvido (no formato yyyy-MM-ddTHH:mm:ssZ). |
|
|
Agente
|
responder_id | integer |
O agente do tíquete. |
Retornos
- Corpo
- CreateTicket200Response
Criar um tíquete
Crie um tíquete.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Assunto
|
subject | True | string |
O assunto do tíquete. |
|
Description
|
description | True | string |
A descrição do tíquete. |
|
Email
|
True | string |
O email do solicitante. |
|
|
Priority
|
priority | True | string |
A prioridade do tíquete. |
|
Situação
|
status | True | string |
O status do tíquete. |
|
Tipo
|
type | string |
Ajuda a categorizar o tíquete de acordo com os diferentes tipos de problemas que sua equipe de suporte lida. |
|
|
Data de Conclusão
|
due_by | date-time |
Carimbo de data/hora que indica quando o tíquete deve ser resolvido (no formato yyyy-MM-ddTHH:mm:ssZ). |
|
|
Primeira resposta vencida por
|
fr_due_by | date-time |
Carimbo de data/hora que indica quando a primeira resposta é devida (no formato yyyy-MM-ddTHH:mm:ssZ). |
|
|
Agente
|
responder_id | integer |
O agente do tíquete. |
|
|
Product
|
product_id | integer |
O produto do qual o tíquete deve fazer parte (somente para uso do administrador). |
Retornos
- Corpo
- CreateTicket200Response
Obter tíquete
Obtenha um tíquete por ID.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do tíquete
|
ticketId | True | string |
A ID do tíquete. |
Retornos
- Corpo
- CreateTicket200Response
Gatilhos
| Quando um agente é adicionado |
Quando um agente é adicionado (somente para uso de administrador). Esse gatilho só funcionará se a conta do Freshdesk tiver menos de 100 agentes. |
| Quando um contato é adicionado |
Quando um contato é adicionado. Esse gatilho só funcionará se a conta do Freshdesk tiver menos de 100 contatos. |
| Quando um status de tíquete é alterado |
Quando o status do tíquete é alterado. |
| Quando um tíquete atribuído a um agente é atualizado |
Quando qualquer tíquete atribuído ao agente selecionado é atualizado. |
| Quando um tíquete é atualizado |
Quando um tíquete é atualizado. |
| Quando um tíquete é criado |
Quando qualquer tíquete é criado. |
Quando um agente é adicionado
Quando um agente é adicionado (somente para uso de administrador). Esse gatilho só funcionará se a conta do Freshdesk tiver menos de 100 agentes.
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
id
|
id | integer |
id |
|
Escopo do tíquete
|
ticket_scope | integer |
Permissão de tíquete do agente. |
|
Criado em
|
created_at | date-time |
Carimbo de data/hora de criação do agente (no formato yyyy-MM-ddTHH:mm:ssZ). |
|
Atualizado em
|
updated_at | date-time |
Carimbo de data/hora atualizado do agente (no formato yyyy-MM-ddTHH:mm:ssZ). |
|
Active
|
contact.active | boolean |
Defina como true se o agente for verificado. |
|
Email
|
contact.email | string |
Endereço de email do agente. |
|
Cargo
|
contact.job_title | string |
Cargo do agente. |
|
Linguagem
|
contact.language | string |
Idioma do agente. |
|
Último logon em
|
contact.last_login_at | date-time |
Carimbo de data/hora do último logon bem-sucedido do agente (no formato yyyy-MM-ddTHH:mm:ssZ). |
|
Telemóvel
|
contact.mobile | string |
Número de celular do agente. |
|
Nome
|
contact.name | string |
Nome do agente. |
|
Telefone
|
contact.phone | string |
Número de telefone do agente. |
|
Fuso horário
|
contact.time_zone | string |
Fuso horário do agente. |
|
Criado em
|
contact.created_at | date-time |
Carimbo de data/hora de Criação do Agente (no formato yyyy-MM-ddTHH:mm:ssZ). |
|
Atualizado em
|
contact.updated_at | date-time |
Carimbo de data/hora da última atualização para o agente (no formato yyyy-MM-ddTHH:mm:ssZ). |
Quando um contato é adicionado
Quando um contato é adicionado. Esse gatilho só funcionará se a conta do Freshdesk tiver menos de 100 contatos.
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Active
|
active | boolean |
Defina como true se o contato tiver sido verificado. |
|
Endereço
|
address | string |
Endereço do contato. |
|
ID da empresa
|
company_id | integer |
ID da empresa à qual este contato pertence. |
|
Description
|
description | string |
Uma breve descrição do contato. |
|
Email
|
string |
Endereço de email primário do contato. |
|
|
ID
|
id | integer |
Id do contato. |
|
Cargo
|
job_title | string |
Cargo do contato. |
|
Linguagem
|
language | string |
Idioma do contato. |
|
Telemóvel
|
mobile | string |
Número de celular do contato. |
|
Nome
|
name | string |
Nome do contato. |
|
Telefone
|
phone | string |
Número de telefone do contato. |
|
Fuso horário
|
time_zone | string |
Fuso horário no qual o contato reside. |
|
Twitter Id
|
twitter_id | string |
Identificador do Twitter do contato. |
|
Criado em
|
created_at | date-time |
Contate o carimbo de data/hora de criação (no formato yyyy-MM-ddTHH:mm:ssZ). |
|
Atualizado em
|
updated_at | date-time |
Contate o carimbo de data/hora atualizado (no formato yyyy-MM-ddTHH:mm:ssZ). |
Quando um status de tíquete é alterado
Quando o status do tíquete é alterado.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do tíquete
|
ticketId | True | integer |
A ID do tíquete. |
|
Novo Status
|
status | string |
O novo status do tíquete. |
Retornos
- Corpo
- CreateTicket200Response
Quando um tíquete atribuído a um agente é atualizado
Quando qualquer tíquete atribuído ao agente selecionado é atualizado.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do agente
|
agentId | True | integer |
A ID do agente. |
|
Incluir descrição
|
includeDescription | boolean |
Se a resposta do gatilho incluir a descrição. |
Retornos
- Corpo
- CreateTicket200Response
Quando um tíquete é atualizado
Quando um tíquete é atualizado.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do tíquete
|
ticketId | integer |
A ID do tíquete. |
|
|
Incluir descrição
|
includeDescription | boolean |
Se a resposta do gatilho incluir a descrição. |
Retornos
- Corpo
- CreateTicket200Response
Quando um tíquete é criado
Quando qualquer tíquete é criado.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Incluir descrição
|
includeDescription | boolean |
Se a resposta do gatilho incluir a descrição. |
Retornos
- Corpo
- CreateTicket200Response
Definições
CreateTicket200Response
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Spam
|
spam | boolean |
Defina como true se o tíquete tiver sido marcado como spam. |
|
Priority
|
priority | string |
Prioridade do tíquete. |
|
ID do solicitante
|
requester_id | integer |
ID do usuário do solicitante. |
|
ID do agente
|
responder_id | integer |
ID do agente a quem o tíquete foi atribuído. |
|
Source
|
source | string |
O canal pelo qual o tíquete foi criado. |
|
Situação
|
status | string |
Status do tíquete. |
|
Assunto
|
subject | string |
Assunto do tíquete. |
|
ID do tíquete
|
id | integer |
A ID exclusiva do tíquete. |
|
Tipo
|
type | string |
Ajuda a categorizar o tíquete de acordo com os diferentes tipos de problemas que sua equipe de suporte lida. |
|
Data de Conclusão
|
due_by | date-time |
Carimbo de data/hora que indica quando o tíquete deve ser resolvido (no formato yyyy-MM-ddTHH:mm:ssZ). |
|
Foi Escalonado
|
is_escalated | boolean |
Definido como true se o tíquete tiver sido escalonado por qualquer motivo. |
|
Description
|
description | string |
Conteúdo HTML do tíquete. |
|
Texto de descrição
|
description_text | string |
Conteúdo do tíquete em texto sem formatação. |
|
Criado em
|
created_at | date-time |
Carimbo de data/hora de criação de tíquete (no formato yyyy-MM-ddTHH:mm:ssZ). |
|
Atualizado em
|
updated_at | date-time |
Carimbo de data/hora atualizado do tíquete (no formato yyyy-MM-ddTHH:mm:ssZ). |
|
Excluído(a)
|
deleted | boolean |
Defina como true se o tíquete tiver sido excluído. |
AddNote200Response
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Privado
|
private | boolean |
Defina como true se a nota for privada. |
|
Content
|
body | string |
Conteúdo da anotação em HTML. |
|
Texto de conteúdo
|
body_text | string |
Conteúdo da anotação em texto sem formatação. |
|
ID do tíquete
|
ticket_id | integer |
ID do tíquete ao qual esta anotação está sendo adicionada. |
|
Criado em
|
created_at | date-time |
Observe o carimbo de data/hora de criação (no formato yyyy-MM-ddTHH:mm:ssZ). |
|
Atualizar em
|
updated_at | date-time |
Observe o carimbo de data/hora atualizado (no formato yyyy-MM-ddTHH:mm:ssZ). |