Freshdesk
O Freshdesk é uma solução de suporte ao cliente baseada em nuvem que irá ajudá-lo a simplificar seu atendimento ao cliente e garantir que seus clientes recebam o suporte que merecem! O conector do Freshdesk destina-se aos agentes do Freshdesk para gerenciar tíquetes e contatos.
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 | Microsoft |
| URL |
Suporte do Microsoft LogicApps Suporte do Microsoft Power Automate Suporte do Microsoft Power Apps |
| Metadados do conector | |
|---|---|
| Editora | Microsoft |
| Sítio Web | https://freshdesk.com/ |
| Política de privacidade | https://www.freshworks.com/privacy/ |
Problemas conhecidos e limitações
- Para gatilhos "Quando um ticket é criado", "Quando um ticket atribuído a um agente é atualizado", "Quando um ticket é atualizado" a descrição do ticket não é retornada por padrão na resposta. Você pode especificar 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 incorporação é usada neste caso. Se você precisar da descrição do ticket, recomendamos usar o gatilho em combinação com a ação "Obter ticket", porque a resposta dessa ação inclui a descrição por padrão.
- A criação do tipo de ticket "Tarefa de serviço" não é suportada no momento.
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 | Não compartilhável |
Padrão
Aplicável: Todas as regiões
Parâmetros para criar conexão.
Esta conexão não é compartilhável. Se o aplicativo avançado 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 (de caracteres) | Por exemplo: https://company.freshdesk.com | Verdade |
| E-mail ou chave de API (https://aka.ms/ii9u75) | cadeia (de caracteres) | O seu endereço de e-mail | Verdade |
| Palavra-passe | securestring | Senha (se estiver usando chave de API, qualquer valor pode ser especificado) | Verdade |
Limites de Limitação
| Name | Chamadas | Período de Renovação |
|---|---|---|
| Chamadas de API por conexão | 100 | 60 segundos |
| Frequência das sondagens de desencadeamento | 1 | 15 segundos |
Ações
| Adicionar uma nota a um bilhete |
Adicione uma nota pública ou privada a um bilhete. |
| Atualizar um ticket |
Atualize um ticket (apenas os valores especificados serão atualizados). |
| Criar um ticket |
Crie um ticket. |
| Obter bilhete |
Obtenha um bilhete por Id. |
Adicionar uma nota a um bilhete
Adicione uma nota pública ou privada a um bilhete.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
ID do bilhete
|
ticketId | True | integer |
O ID do bilhete ao qual adicionar uma nota. |
|
Content
|
body | True | string |
O conteúdo da nota. |
|
Privado
|
private | boolean |
Indica se esta é uma nota privada (o padrão é true). |
Devoluções
- Body
- AddNote200Response
Atualizar um ticket
Atualize um ticket (apenas os valores especificados serão atualizados).
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
ID do bilhete
|
ticketId | True | integer |
O ID do ticket a ser atualizado. |
|
Description
|
description | string |
A descrição do bilhete. |
|
|
Assunto
|
subject | string |
O assunto do bilhete. |
|
|
Priority
|
priority | string |
A prioridade do bilhete. |
|
|
Situação
|
status | string |
O status do bilhete. |
|
|
Tipo
|
type | string |
Ajuda a categorizar o ticket de acordo com os diferentes tipos de problemas com os quais sua equipe de suporte lida. |
|
|
Concluir Até
|
due_by | date-time |
Carimbo de data/hora que indica quando o ticket deve ser resolvido (no formato aaaa-MM-ddTHH:mm:ssZ). |
|
|
Agente
|
responder_id | integer |
O agente do bilhete. |
Devoluções
Criar um ticket
Crie um ticket.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Assunto
|
subject | True | string |
O assunto para o bilhete. |
|
Description
|
description | True | string |
A descrição do bilhete. |
|
Email
|
True | string |
O e-mail do solicitante. |
|
|
Priority
|
priority | True | string |
A prioridade para o bilhete. |
|
Situação
|
status | True | string |
O status do bilhete. |
|
Tipo
|
type | string |
Ajuda a categorizar o ticket de acordo com os diferentes tipos de problemas com os quais sua equipe de suporte lida. |
|
|
Concluir Até
|
due_by | date-time |
Carimbo de data/hora que indica quando o ticket deve ser resolvido (no formato aaaa-MM-ddTHH:mm:ssZ). |
|
|
Primeira resposta devida por
|
fr_due_by | date-time |
Carimbo de data/hora que indica quando a primeira resposta deve ser dada (no formato aaaa-MM-ddTHH:mm:ssZ). |
|
|
Agente
|
responder_id | integer |
O agente do bilhete. |
|
|
Produto
|
product_id | integer |
O produto do qual o ticket deve fazer parte (apenas para uso administrativo). |
Devoluções
Obter bilhete
Obtenha um bilhete por Id.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
ID do bilhete
|
ticketId | True | string |
O ID do bilhete. |
Devoluções
Acionadores
| Quando o status de um ticket é alterado |
Quando o status do bilhete muda. |
| Quando um agente é adicionado |
Quando um agente é adicionado (apenas para uso administrativo). Esse gatilho só funciona se a conta do Freshdesk tiver menos de 100 agentes. |
| Quando um bilhete é atualizado |
Quando um ticket é atualizado. |
| Quando um contato é adicionado |
Quando um contato é adicionado. Esse gatilho só funciona se a conta do Freshdesk tiver menos de 100 contatos. |
| Quando um ticket atribuído a um agente é atualizado |
Quando qualquer ticket atribuído ao agente selecionado é atualizado. |
| Quando um ticket é criado |
Quando qualquer ticket é criado. |
Quando o status de um ticket é alterado
Quando o status do bilhete muda.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
ID do bilhete
|
ticketId | True | integer |
O ID do bilhete. |
|
Novo status
|
status | string |
O novo status do bilhete. |
Devoluções
Quando um agente é adicionado
Quando um agente é adicionado (apenas para uso administrativo). Esse gatilho só funciona se a conta do Freshdesk tiver menos de 100 agentes.
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
id
|
id | integer |
id |
|
Âmbito do Bilhete
|
ticket_scope | integer |
Permissão de ingresso do agente. |
|
Criado em
|
created_at | date-time |
Carimbo de data/hora de criação do agente (no formato aaaa-MM-ddTHH:mm:ssZ). |
|
Atualizado em
|
updated_at | date-time |
Carimbo de data/hora atualizado pelo agente (no formato aaaa-MM-ddTHH:mm:ssZ). |
|
Active
|
contact.active | boolean |
Defina como true se o agente for verificado. |
|
Email
|
contact.email | string |
Endereço de e-mail do agente. |
|
Cargo
|
contact.job_title | string |
Cargo do agente. |
|
Linguagem
|
contact.language | string |
Língua do agente. |
|
Último login em
|
contact.last_login_at | date-time |
Carimbo de data/hora do último login bem-sucedido do agente (no formato aaaa-MM-ddTHH:mm:ssZ). |
|
Telemóvel
|
contact.mobile | string |
Número de telemóvel do agente. |
|
Nome
|
contact.name | string |
Nome do agente. |
|
Telemóvel
|
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 de Agente (no formato aaaa-MM-ddTHH:mm:ssZ). |
|
Atualizado em
|
contact.updated_at | date-time |
Carimbo de data/hora da última atualização para o agente (no formato aaaa-MM-ddTHH:mm:ssZ). |
Quando um bilhete é atualizado
Quando um ticket é atualizado.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
ID do bilhete
|
ticketId | integer |
O ID do bilhete. |
|
|
Incluir descrição
|
includeDescription | boolean |
Se a resposta do gatilho incluir a descrição. |
Devoluções
Quando um contato é adicionado
Quando um contato é adicionado. Esse gatilho só funciona se a conta do Freshdesk tiver menos de 100 contatos.
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Active
|
active | boolean |
Defina como true se o contato tiver sido verificado. |
|
Address
|
address | string |
Endereço do contacto. |
|
ID da Empresa
|
company_id | integer |
Id da empresa a que pertence este contacto. |
|
Description
|
description | string |
Uma breve descrição do contacto. |
|
Email
|
string |
Endereço de e-mail principal do contato. |
|
|
Id
|
id | integer |
ID do contacto. |
|
Cargo
|
job_title | string |
Cargo do contato. |
|
Linguagem
|
language | string |
Língua do contacto. |
|
Telemóvel
|
mobile | string |
Número de telemóvel do contacto. |
|
Nome
|
name | string |
Nome do contacto. |
|
Telemóvel
|
phone | string |
Número de telefone do contacto. |
|
Fuso Horário
|
time_zone | string |
Fuso horário em que o contato reside. |
|
Twitter Id
|
twitter_id | string |
Twitter identificador do contato. |
|
Criado em
|
created_at | date-time |
Carimbo de data/hora de criação de contato (no formato aaaa-MM-ddTHH:mm:ssZ). |
|
Atualizado em
|
updated_at | date-time |
Carimbo de data/hora atualizado do contato (no formato aaaa-MM-ddTHH:mm:ssZ). |
Quando um ticket atribuído a um agente é atualizado
Quando qualquer ticket atribuído ao agente selecionado é atualizado.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
ID do agente
|
agentId | True | integer |
O id do agente. |
|
Incluir descrição
|
includeDescription | boolean |
Se a resposta do gatilho incluir a descrição. |
Devoluções
Quando um ticket é criado
Quando qualquer ticket é criado.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Incluir descrição
|
includeDescription | boolean |
Se a resposta do gatilho incluir a descrição. |
Devoluções
Definições
CreateTicket200Response
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Spam (correio não solicitado)
|
spam | boolean |
Defina como true se o ticket tiver sido marcado como spam. |
|
Priority
|
priority | string |
Prioridade do bilhete. |
|
ID do solicitante
|
requester_id | integer |
ID de usuário do solicitante. |
|
ID do agente
|
responder_id | integer |
Identificação do agente a quem o bilhete foi atribuído. |
|
Fonte
|
source | string |
O canal através do qual o bilhete foi criado. |
|
Situação
|
status | string |
Estado do bilhete. |
|
Assunto
|
subject | string |
Assunto do bilhete. |
|
ID do bilhete
|
id | integer |
O ID único do bilhete. |
|
Tipo
|
type | string |
Ajuda a categorizar o ticket de acordo com os diferentes tipos de problemas com os quais sua equipe de suporte lida. |
|
Concluir Até
|
due_by | date-time |
Carimbo de data/hora que indica quando o ticket deve ser resolvido (no formato aaaa-MM-ddTHH:mm:ssZ). |
|
É Escalado
|
is_escalated | boolean |
Defina como true se o ticket tiver sido escalado por qualquer motivo. |
|
Description
|
description | string |
Conteúdo HTML do bilhete. |
|
Texto da descrição
|
description_text | string |
Conteúdo do bilhete em texto simples. |
|
Criado em
|
created_at | date-time |
Carimbo de data/hora de criação de ticket (no formato aaaa-MM-ddTHH:mm:ssZ). |
|
Atualizado em
|
updated_at | date-time |
Carimbo de data/hora atualizado do bilhete (no formato aaaa-MM-ddTHH:mm:ssZ). |
|
Suprimido
|
deleted | boolean |
Defina como true se o ticket tiver sido excluído. |
AddNote200Response
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Privado
|
private | boolean |
Defina como true se a nota for privada. |
|
Content
|
body | string |
Conteúdo da nota em HTML. |
|
Texto do conteúdo
|
body_text | string |
Conteúdo da nota em texto simples. |
|
ID do bilhete
|
ticket_id | integer |
Id do bilhete ao qual esta nota está sendo adicionada. |
|
Criado em
|
created_at | date-time |
Carimbo de data/hora de criação de notas (no formato aaaa-MM-ddTHH:mm:ssZ). |
|
Atualizar em
|
updated_at | date-time |
Observe o carimbo de data/hora atualizado (no formato aaaa-MM-ddTHH:mm:ssZ). |