# 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: 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:

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

The question should be specific, self-contained, and written in natural language.
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.