> For the complete documentation index, see [llms.txt](https://docs.screendesk.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.screendesk.io/helpdesk-integrations/gist.md).

# Gist

How to request and send screen recordings with Gist

There's no app to install for Gist. You put Screendesk's Gist link in Gist snippets, chat messages or bots. The customer records, then pastes the recording's link back in the chat. Recordings arrive in Screendesk as **Gist Ticket** recordings, with the customer's email.

{% embed url="<https://app.screendesk.io/recordings/21392d0d-9a48-4f18-98b2-43f5e3e611d2>" %}

## Get the link

1. In Screendesk, go to **Settings → Integrations** and click **Get link** on the **Gist** card, under **Messaging**.

   <figure><img src="https://3820804400-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfW6XSzJSKsNyZnOkSJPt%2Fuploads%2FQRzOvTkkHsQRXzY6MPwv%2Fgist-card.png?alt=media" alt="The Gist card in Settings → Integrations, with Get link"><figcaption></figcaption></figure>
2. If your workspace has websites with the Screendesk snippet, choose under **Where customers record** where customers record. Changing it changes the link, so copy it again after.
3. Click **Copy** next to **Snippets, chats and bots**.

   <figure><img src="https://3820804400-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfW6XSzJSKsNyZnOkSJPt%2Fuploads%2F2spPAbLwFk4qsFzA12Rr%2Fgist-sheet.png?alt=media" alt="The Gist sheet with the link for snippets, chats and bots"><figcaption></figcaption></figure>

It's one link for your whole team. It ends with `ce={{ contact.email | default: ' ' }}`, which Gist fills in with the customer's email: paste it as it is.

## Create a snippet

1. In Gist, go to **Settings → Inbox → Conversation snippets** and create a snippet with a sentence and the link. For example: *Could you show us what happens on your screen? Record it here, then paste the link it gives you in the chat.*
2. Use the snippet in any conversation: type **/** in the reply and pick it.

<figure><img src="https://3820804400-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfW6XSzJSKsNyZnOkSJPt%2Fuploads%2FagstM6IN7BAdbQ1TxlMZ%2Fgist-snippet.png?alt=media" alt="A Gist conversation snippet with the Screendesk link"><figcaption></figcaption></figure>

## In a chat

{% embed url="<https://app.screendesk.io/recordings/8e88263f-377d-40a4-b8f8-6bdbcbf14697>" %}

When the customer finishes recording, Screendesk shows them the recording's link and asks them to paste it in the chat.

<figure><img src="https://3820804400-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfW6XSzJSKsNyZnOkSJPt%2Fuploads%2F8ZRGjhmP8K3kwMiwkXBJ%2Fgist-conversation.png?alt=media" alt="A Gist conversation with the snippet sent and the recording&#x27;s link pasted back"><figcaption></figcaption></figure>

You can also paste the same link into a Gist chat message or a bot message.

{% hint style="info" %}
The link names no agent, so a Gist recording isn't assigned to anyone: find it under **Received** in Screendesk, or open it from the link the customer pastes.
{% endhint %}


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.screendesk.io/helpdesk-integrations/gist.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
