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

# Ada Handoff

Add Birdie to your Ada conversations

To add Birdie into your Ada Handoffs, follow these steps.

## **Installation**

Go to [Settings => Helpdesk](https://app.birdie.so/settings/helpdesk) to enable Ada. Once enabled, you'll get access to the informations you will need in order to wire Birdie Recordings into the bot conversations.

### 1. Extract the current Conversation ID

That's something you can do early in your Handoff, the idea is to save it into a custom variable, as it will be used to run Birdie:

{% stepper %}
{% step %}

###  Add a new Request Block

Drag and Drop a new REQUEST block in the flow.
{% endstep %}

{% step %}

### URL Field

Let the default GET method on the right.\
In the Request Block URL field, use \
`https://<your-ada-subdomain>.ada.support/api/conversations/recent/chat/`\
`<chatter_token>`\
Replace `<your-ada-subdomain>` by your current subdomain (you can find it in the url of any of your Ada pages).\
And replace `<chatter_token>` by the red  <mark style="color:$danger;background-color:red;">chatter\_token</mark> placeholder proposed by Ada as illustrated in this screenshot:\
\
![](https://3843507234-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FECPgvsGwy5oMz4WIZw3a%2Fuploads%2FSU0XHfqWSBn329ryzg55%2FScreenshot%202026-06-11%20at%2018.08.05.png?alt=media\&token=508cad1e-644a-498a-903b-4b0294060df8)
{% endstep %}

{% step %}

### Headers

Add a Header field, name it `Session-Auth` and pull the red  <mark style="color:$danger;background-color:red;">chatter\_session\_token</mark> placeholder into the value (see screenshot above).
{% endstep %}

{% step %}

### Save the result as variable

Create a new variable named <mark style="color:$success;background-color:green;">conversation\_id</mark> and paste exactly this text in the Data Key field: `conversations[0]._id` (see screenshot above).
{% endstep %}
{% endstepper %}

### 2. Ask the user for his email (optional)

If you want to add the user email to your recordings, add a step to save the user email into a variable, in our example we will name it <mark style="color:$success;background-color:green;">end\_user\_email</mark>

### 3. Request a Screen Recording from the user

When you decide to ask the user to make a Screen Recording, use this:

{% stepper %}
{% step %}

### Add a Link Message Block

Drag and Drop a Link Message Block in your flow.
{% endstep %}

{% step %}

### Paste your Birdie workspace Template in the URL

When you enabled Ada in your Birdie Workspace a few fieds are ready to copy and paste in Ada, here you must use the first link: copy it, and paste into the Ada's URL block.

Your link will look like:\
`https://your-birdie-domain.birdie.so/recorder?ada=<conversation_id>&email=<customer_email>&tag=<tag>`&#x20;

Replace `<conversation_id>` with the <mark style="color:$success;background-color:green;">conversation\_id</mark> variable we retrieved at step 1.\
Replace \<customer\_email> with the <mark style="color:$success;background-color:green;">end\_user\_email</mark> variable if you stored it here.\
And optionally you can also add a tag value of your choice (you can remove this parameter if not relevant).

<figure><img src="https://3843507234-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FECPgvsGwy5oMz4WIZw3a%2Fuploads%2FbDP2PNI7JFEyog188xqq%2FScreenshot%202026-06-11%20at%2018.27.01.png?alt=media&amp;token=bd4f6bc7-e0f4-4b47-8684-5dd7a2ead472" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

### 4. Retrieve the recording

Right after sending the request link, you must ask the user to confirm if the recording is finished, then fetch Birdie for the recording link.

{% stepper %}
{% step %}

### Add a List Option Block

As illustrated in this screenshot, present a list of options - in this example we just present one option "Ok I finished the recording" and save the user's answer into a variable, here we saved it into <mark style="color:$success;background-color:green;">recording\_response\_result</mark>

<figure><img src="https://3843507234-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FECPgvsGwy5oMz4WIZw3a%2Fuploads%2FmzjjYsgwNBZ283usJRNF%2FScreenshot%202026-06-11%20at%2018.36.43.png?alt=media&amp;token=83251ec8-f310-4f14-a853-3efe351f05fe" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Add a Request Block

Drag and Drop a Request Block, and fill-in the URL and 2 Headers wiht the informations you will get in your Birdie Workspace as illustrated in this screenshot:

<figure><img src="https://3843507234-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FECPgvsGwy5oMz4WIZw3a%2Fuploads%2FceODgJdvh35Jqszp5eHH%2FScreenshot%202026-06-11%20at%2018.44.17.png?alt=media&amp;token=83c82262-8a01-4a18-a35a-54b1b9c28c43" alt=""><figcaption></figcaption></figure>

For the URL make sure to replace `<conversation_id>` by your Ada variable <mark style="color:$success;background-color:green;">conversation\_id</mark>

Make sure you save the Response as a variable, we named it <mark style="color:$success;background-color:green;">recording\_link</mark>, and as Data Key just paste this value: `recording_link`
{% endstep %}

{% step %}

### Add a Link Message Block

As illustrated, drag and drop a new Link Message block, containing as URL: <mark style="color:$success;background-color:green;">recording\_link</mark> and the Link Text of your choice - we chose to display *"New recording available"*.

<figure><img src="https://3843507234-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FECPgvsGwy5oMz4WIZw3a%2Fuploads%2FJ19dMqYcaKbXQrSy1UG4%2FScreenshot%202026-06-24%20at%2008.47.48.png?alt=media&amp;token=becddc74-435d-4d09-a5f9-a9a21d8aae05" alt=""><figcaption></figcaption></figure>

Make sure to check "Open in New Tab" option to avoid the user losing the current conversation. &#x20;

{% endstep %}
{% endstepper %}