> For the complete documentation index, see [llms.txt](https://docs.chatlayer.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.chatlayer.ai/chatlayer-documentation-pt-br/integrateandcode/app-integrations/topdesk.md).

# Topdesk

{% hint style="danger" %}
Esta integração está descontinuada desde 16/09/2025. Se você gostaria de usar a integração do Topdesk, por favor [entre em contato conosco](/chatlayer-documentation-pt-br/support/get-in-touch.md).
{% endhint %}

### Conectar uma conta

Para conectar uma conta, vá para a página inicial e para Integrações no menu do lado esquerdo. Escolha a integração Topdesk e clique em '+Add account':

<figure><img src="/files/460a66b95372cce4f334e44510e27dd13f141453" alt=""><figcaption></figcaption></figure>

Este pop-up aparecerá. Preencha-o com sua conta de usuário do Topdesk e os detalhes do usuário:

<figure><img src="/files/38eac3737a3e3d4354ebc73159d21ff273bb18ae" alt=""><figcaption></figcaption></figure>

Depois de concluído, você poderá vê-la na lista de contas conectadas:

<figure><img src="/files/f42901b35d12098df62d9d2bce6ced2d80cbc2b1" alt=""><figcaption></figcaption></figure>

### Criando um incidente

Adicione um bloco de Ação e pesquise por Topdesk no menu de Aplicativos

<figure><img src="/files/b33ece44be356669d2733db7c6028922c4f3dcea" alt=""><figcaption></figcaption></figure>

Se você seguiu os passos anteriores, sua conta deve estar conectada. Caso contrário, você pode criar a conta a partir deste passo:

<figure><img src="/files/69f0918837bf40d50947a598ae3cb4524184c82c" alt=""><figcaption></figcaption></figure>

Nos campos da ação, você pode preencher as variáveis que contêm os dados sobre a pessoa que está criando o incidente e sobre o que é a solicitação dela.

<figure><img src="/files/53fc989dac6ebeea1cff9d2f634a0da4c62f6b86" alt=""><figcaption></figcaption></figure>

Os campos 'type', 'category', 'subcategory' e 'operator group' têm listas suspensas que estão disponíveis na sua conta. Como alternativa, você pode obter essas entradas diretamente do usuário e salvá-las como variáveis ou escolher quais campos são realmente obrigatórios para o seu bot:

<figure><img src="/files/44dd727598521b72bb5263d234d1b643734b4291" alt=""><figcaption></figcaption></figure>

Para mostrar ao usuário o número do incidente que foi criado, você pode usar a variável interna `{apps.topdesk.create_incident.number}` como mostrado abaixo:

<figure><img src="/files/01134baa1e8db5b45d12f584781e8e5b9354803b" alt=""><figcaption></figcaption></figure>

### Atualizar incidente

Para atualizar um incidente, você só precisa seguir as instruções anteriores e escolher a ação 'update incident'.

<figure><img src="/files/734b45a70d83fce522ee202a5de25a16015c1c05" alt=""><figcaption></figcaption></figure>

Você pode mostrar ao usuário o incidente e o status dele usando as variáveis internas:`{apps.topdesk.create_incident.number}`, `{apps.topdesk.update_incident.processingStatus.name}`

<figure><img src="/files/6d8d438e12beaa14c4589385864f34354e2fd3ac" alt=""><figcaption></figcaption></figure>

Agora você está pronto para criar um ótimo bot de suporte ao cliente, integrado ao TopDesk!


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.chatlayer.ai/chatlayer-documentation-pt-br/integrateandcode/app-integrations/topdesk.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.