# 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](https://docs.chatlayer.ai/chatlayer-documentation-pt-br/support/get-in-touch).
{% 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="https://181262846-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LLTwFwbOqJj4dDhg8Ju%2Fuploads%2FKx1I32uq00a2sqOV1b7J%2Fimage.png?alt=media&#x26;token=92abd713-b96d-467b-8b55-2155935100d4" 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="https://181262846-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LLTwFwbOqJj4dDhg8Ju%2Fuploads%2FPMnlMMI2XvvoRKDDP5YI%2Fimage.png?alt=media&#x26;token=0e825b5c-7169-45fa-9822-355cb1af97c9" alt=""><figcaption></figcaption></figure>

Uma vez feito isso, você poderá vê-la na lista de contas conectadas:

<figure><img src="https://181262846-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LLTwFwbOqJj4dDhg8Ju%2Fuploads%2FZdmhaQjwW3hPX7F4cG8A%2Fimage.png?alt=media&#x26;token=81543e50-1432-41db-8fb8-041e1fb767ba" alt=""><figcaption></figcaption></figure>

### Criando um incidente

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

<figure><img src="https://181262846-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LLTwFwbOqJj4dDhg8Ju%2Fuploads%2FWGEnsVAoNkjEC7bMJWA7%2Fimage.png?alt=media&#x26;token=d7ece7e2-a731-44ff-9276-a5fdbacd05e3" 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="https://181262846-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LLTwFwbOqJj4dDhg8Ju%2Fuploads%2FctSydR6yxGuzhCkXh6rX%2Fimage.png?alt=media&#x26;token=f3919e82-092e-4c5c-88bc-ea5a972ce205" 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="https://181262846-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LLTwFwbOqJj4dDhg8Ju%2Fuploads%2FPDf31TeplhjL4dd9Lh6K%2Fimage.png?alt=media&#x26;token=52fe53ab-7eac-484e-83c5-18edf7ffb5b5" 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="https://181262846-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LLTwFwbOqJj4dDhg8Ju%2Fuploads%2FSCZAOR3meJn4nxWUSbyw%2Fimage.png?alt=media&#x26;token=234fdb46-d08d-489d-a3f5-22753c3b6d8b" 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="https://181262846-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LLTwFwbOqJj4dDhg8Ju%2Fuploads%2FfzKTC65wxVLNJW2ahbBJ%2Fimage.png?alt=media&#x26;token=3fe66c4a-183a-4e25-b9b2-0f2a468a0f44" 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="https://181262846-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LLTwFwbOqJj4dDhg8Ju%2Fuploads%2FpA3FhyK14y95euBA2ZWd%2Fimage.png?alt=media&#x26;token=591a1f5f-55cb-4cdd-8bd0-822a5944b529" 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="https://181262846-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LLTwFwbOqJj4dDhg8Ju%2Fuploads%2FTa4ycveSuMk0mGHmoiBP%2Fimage.png?alt=media&#x26;token=534f2db2-97e5-4587-abb0-5669bf152d11" alt=""><figcaption></figcaption></figure>

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