Freshdesk | ElevenLabs Documentation

Com uma ferramenta de webhook, sua recepcionista pode abrir um ticket no Freshdesk sempre que alguém relatar um problema ou pedir ajuda, para que sua equipe possa atendê-lo. Nos planos Growth, Pro e Enterprise, você também pode conectar o servidor MCP do Freshdesk para consultar tickets existentes.

Criar tickets

Obtenha sua chave de API

No Freshdesk, selecione sua foto de perfil, abra Configurações do perfil e selecione Ver chave de API. Copie a chave. Ela funciona como sua conta de agente, portanto os tickets são criados com suas permissões.

Crie o cabeçalho de autorização

O Freshdesk usa a chave de API como nome de usuário e X como senha. Codifique-a em um terminal, substituindo YOUR_API_KEY pela sua chave:

printf 'YOUR_API_KEY:X' | base64

O valor do cabeçalho é Basic seguido pela saída.

Não cole sua chave de API em um codificador online. Qualquer pessoa com a chave ou o cabeçalho codificado pode ler e alterar seus tickets.

Crie a ferramenta de webhook

Acesse Integrações, selecione Adicionar integração e escolha Ferramenta de webhook.

Campo	Valor
Nome	`create_freshdesk_ticket`
Descrição	”Abra um ticket de suporte quando alguém relatar um problema ou precisar de ajuda da equipe.”
Método	POST
URL	`https://YOURDOMAIN.freshdesk.com/api/v2/tickets`
Cabeçalhos da solicitação	`Authorization`: `Basic` seguido pela chave codificada
Parâmetros do corpo	`name` (string, obrigatório): “O nome completo da pessoa que ligou.” `phone` (string): “O número de telefone da pessoa que ligou.” `email` (string): “O endereço de e-mail da pessoa que ligou, se ela o informou.” `subject` (string, obrigatório): “Um breve resumo do problema.” `description` (string, obrigatório): “O que a pessoa que ligou relatou, com suas próprias palavras, incluindo os detalhes fornecidos.” `status` (number, obrigatório): “Sempre o valor exato `2`.” `priority` (number, obrigatório): “Sempre o valor exato `1`.” `source` (number, obrigatório): “Sempre o valor exato `3`.”
Atribuir a agentes	Recepcionista

Substitua YOURDOMAIN pelo seu subdomínio do Freshdesk. Selecione Ativar.

Teste

Teste sua recepcionista relatando um problema. O ticket aparecerá no Freshdesk.

Os valores fixos criam o ticket como Aberto (status 2), com prioridade Baixa (prioridade 1), e o marcam como vindo de Telefone (origem 3). Para permitir que a recepcionista defina a prioridade, descreva os valores, por exemplo: “1 para baixa, 2 para média, 3 para alta, 4 para urgente.”

O Freshdesk precisa de um número de telefone ou e-mail para encontrar ou criar a solicitação. Diga à sua recepcionista para sempre coletar o número de telefone de quem liga.

Consultar tickets com o servidor MCP

O servidor MCP do Freshdesk está disponível nos planos Growth, Pro e Enterprise. Use-o para permitir que sua recepcionista consulte os tickets existentes de quem liga. As ações MCP contam para uma franquia anual que depende do seu plano.

No Reception.ai, acesse Integrações, selecione Adicionar integração e escolha Servidor MCP.

Campo	Valor
Nome	Freshdesk
Tipo de servidor	HTTP com streaming
URL do servidor	`https://YOURDOMAIN.freshdesk.com/mcp`
Cabeçalhos HTTP	`Authorization`: sua chave de API, sem prefixo

Deixe Token secreto vazio para que o Reception.ai envie seu cabeçalho Authorization exatamente como foi inserido. Use seu subdomínio freshdesk.com, mesmo que tenha um domínio personalizado. Selecione Ativar.

Abra a guia Ferramentas e atribua as ferramentas de consulta de tickets, como fetchSearchTickets e fetchTicket, ao Cliente (recepcionista). Deixe sem atribuição as ferramentas que atualizam tickets, agentes, grupos ou artigos.

Solução de problemas

Problema	O que verificar
401 do Freshdesk	Codifique a chave com `:X` depois dela e inicie o valor do cabeçalho com `Basic` e um espaço.
400 sobre a solicitação	O ticket precisa de um número de telefone ou e-mail, além do nome. Verifique se a recepcionista os coleta.
400 sobre status ou prioridade	`status`, `priority` e `source` devem ser parâmetros do tipo number, não strings.
O servidor MCP não lista ferramentas	Use seu subdomínio `freshdesk.com` e coloque a chave de API bruta no cabeçalho `Authorization`, sem `Basic` nem `Bearer`.