> 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

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:\
\
![](/files/DSX3J8auyONeLEDKa86b)
{% 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="/files/ZRuhW2Yx2vtRQ4iYgLPl" 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="/files/Sm3pio9PNPJp2rgFHSMR" 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="/files/xeBgHxVnoAK5WlJTAQSt" 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="/files/4AuTaPL66KyeYjIOa5OP" alt=""><figcaption></figcaption></figure>

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

{% endstep %}
{% endstepper %}