> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt. # Freshdesk Com uma [ferramenta de webhook](/docs/pt/reception-ai/integrations/webhooks), 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](#look-up-tickets-with-the-mcp-server) 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: ```bash printf 'YOUR_API_KEY:X' | base64 ``` O valor do cabeçalho é `Basic ` seguido pela saída. > **Warning** > > 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](/docs/pt/reception-ai/receptionist/testing) 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](/docs/pt/reception-ai/integrations/mcp-server) 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`. |