> ## Documentation Index
> Fetch the complete documentation index at: https://docs.salesask.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Deep Links

> Start, stop, or restart a Sales Ask recording from a button or link in any CRM, calendar, or app.

A deep link is a web address that controls a rep's Sales Ask recording. Put it behind a button or link field in your CRM, and a rep can start recording the moment they walk into an appointment, without switching apps and finding the record button.

Deep links work with any CRM, calendar, or app that can open a link. They don't need a CRM integration.

## What you need

* A Sales Ask **team admin** or **organization admin** account to create links
* Reps signed in to Sales Ask on the phone or computer they record with
* Optional: a place in your CRM to add a custom button or a clickable link field

## Create a link

1. Go to **Settings → Integrations** and select **Deep links** in the list.
2. Under **What the link does**, choose **Start**, **Stop**, or **Restart**.
3. For Start and Restart links, you can also:
   * Add a **Recording title**. Paste your CRM's merge field for the customer's name so every recording is named after the customer.
   * Pick an **AI Process** for these recordings. Leave it on **Rep's default AI Process** to use each rep's default.
4. Click **Copy link**.

Most teams add a Start link and a Stop link side by side, so reps can control the whole meeting from the CRM.

## Add the link to your CRM

Paste the copied link wherever your CRM lets you add a custom button, a URL field, or a link in an appointment or job template. If your CRM fills in merge fields when it shows the link, the recording title gets the real customer name.

Merge field syntax differs between CRMs. Use the one your CRM documents for the customer or contact name, for example:

| Syntax style | Example |
| - | - |
| Double braces | `{{client_name}}` or `{{client.name}}` |
| Square brackets | `[Name]` |
| Percent signs | `%name%` |
| Salesforce formula | `{!Contact.Name}` |

The **Deep links** page leaves these placeholders as they are when it builds the link, so your CRM can still replace them.

> [!TIP]
>
> Test a new link once before rolling it out: open it from a real record in your CRM, check that the recording starts with the customer's name as its title, then stop it.

## Link format

You can also write links by hand. Every link starts with:

```text theme={null}
https://app.salesask.com/record?action=start
```

| Parameter | Required | What it does |
| - | - | - |
| `action` | No | `start`, `stop`, or `restart`. Leaving it out means `start`. Any other value shows an error and changes nothing. |
| `title` | No | The recording's title, up to 200 characters. Used by Start and Restart links. |
| `aiProcessId` | No | The ID of the AI Process to grade these recordings with. Used by Start and Restart links. The **Deep links** page fills this in when you pick an AI Process. |

For example, this link starts a recording named after the customer:

```text theme={null}
https://app.salesask.com/record?action=start&title={{client_name}}
```

And this one stops it:

```text theme={null}
https://app.salesask.com/record?action=stop
```

If a rep can't use the AI Process in a link, their recording is graded with their default AI Process instead.

## What each action does

| Action | When nothing is recording | When a recording is already running |
| - | - | - |
| **Start** | Starts a new recording with the link's title and AI Process. | Opens the recording that's running. Nothing is replaced or lost. |
| **Stop** | Does nothing. | Stops the recording and saves it on the device. |
| **Restart** | Starts a new recording. | Saves the running recording on the device, then starts a new one with the link's title and AI Process. |

> [!WARNING]
>
> A stop link saves the recording on the rep's device, but doesn't upload it. The rep still presses and holds **Save** to upload the recording. Until then, it doesn't appear in **Meetings**.

## On phones and computers

**On a phone**, the link opens the Sales Ask app and runs the action there. If the rep isn't signed in, Sales Ask asks them to sign in first and then runs the link.

**On a computer**, the link opens in a new browser tab. If the rep is already recording in another Sales Ask tab, the new tab passes Stop and Restart links to that tab, so the right recording stops. This only works within the same browser, signed in as the same rep.

> [!NOTE]
>
> If a rep records on their phone and taps a link on their computer, or records in a different browser, the link can't reach that recording. A stop link does nothing, and a restart link starts a second recording on the computer while the first keeps going. Reps should open deep links on the device they record with.

## Troubleshooting

| Problem | What to check |
| - | - |
| "This recording link is not valid" | The `action` value is misspelled or not one of `start`, `stop`, or `restart`. Copy a fresh link from **Settings → Integrations → Deep links**. |
| The stop link did nothing | Check that the rep opened it on the same device, and in the same browser, as the recording. If nothing was recording, a stop link has nothing to stop. |
| The recording stopped but isn't in Meetings | The recording is saved on the device. The rep presses and holds **Save** to upload it. |
| "The recording did not start" or "did not stop" | Sales Ask couldn't control the recorder in time. Open the recorder in Sales Ask and start or stop the recording there. |
| The title shows the merge field instead of the customer's name | Your CRM didn't fill in the placeholder. Check the merge field syntax in your CRM's documentation, and that the field has a value on that record. |
| Two recordings are running | A restart link was opened on a different device or browser from the one recording. Stop the extra recording in Sales Ask. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.