> 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á obsoleta desde 16/09/2025. Se você deseja usar a integração com o 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 em Integrações no menu à esquerda. Escolha a integração Topdesk e clique em '+Adicionar conta':

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

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

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

Uma vez feito isso, 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 Apps

<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 desta etapa:

<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 qual é 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. Alternativamente, 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}` conforme 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'.&#x20;

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

Você pode mostrar ao usuário o incidente e seu status 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 com o 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.