> 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-playbook.md).

# Ada Playbook

To add Birdie into your Ada Playbooks, 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. Get the Conversation ID 

{% stepper %}
{% step %}

### Create a New Action 

Go to the Actions in the left menu and create a New Action.\
Give it a name, here we will use <mark style="color:$warning;background-color:yellow;">\[Birdie] Get conversation\_id</mark>
{% endstep %}

{% step %}

### Setup Connect to API

Scroll down to *Connect to API* section and fill-in the fields as described:\
\
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 the following screenshot.\
\
Switch to the Headers tab and 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).

<figure><img src="/files/OGoRj9v4VzaniWlhLmqV" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Use API outputs in chat

Scroll down to *Use API outputs in chat* section and fill-in the fields as described: \
Output name: Conversation ID\
Path: `conversations[0]._id`\
Check the 2 options *Give my AI Agent access to this information*, and *Save output as a variable*.\
Create a new variable named <mark style="color:$success;background-color:green;">conversation\_id</mark> and add it following the example in this screeshot:

<figure><img src="/files/lynvuxoiJWttn1WITNMg" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Save

Don't forget to Save (upper right button)
{% endstep %}
{% endstepper %}

### 2. Retrieve the Recording Link

{% stepper %}
{% step %}

### Create a New Action&#x20;

Go to the Actions in the left menu and create a New Action.\
Give it a name, here we will use <mark style="color:$warning;background-color:yellow;">\[Birdie] Retrieve Recording Link</mark>
{% endstep %}

{% step %}

### Setup Connect to API

Scroll down to *Connect to API* section and fill-in the fields as described:\
\
Let the default GET method on the right.\
In the Request Block URL field, use this URL:\
`https://app.birdie.so/api/v1/ada/get_recording_link?conversation_id=<conversation_id>`\
&#x20;and make sure to replace `<conversation_id>` by your Ada variable <mark style="color:$success;background-color:green;">conversation\_id</mark>

Also add the 2 headers provided in your Birdie Ada Setup page, as you can see in the floowinf screenshot.

<figure><img src="/files/ftpK8pgvqYyxhPzyTtDx" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Use API outputs in chat&#x20;

Scroll down to *Use API outputs in chat* and save the Response as a variable, <mark style="color:$success;background-color:green;">recording\_link</mark> as illustrated into this screeshot:

<figure><img src="/files/D2wJw3gXgMfC3JsZL3EI" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

### 3. Create the Playbook (v2) &#x20;

Now the 2 actions are ready, you can instruct Ada to request recordings: use the first action to get the conversation id, optionnally get the user email, provide a request link, and wait for the user to finish the recording. Once the recording is done, use the second action to fetch the recording and present it into the conversation.

Here is a full example as a screenshot. For the first clickable link, go to your Birdie Ada's integration settings to get your link, essentially replacing `your-domain.birdie.so` in that playbook with your own domain.

<figure><img src="/files/dK6QypzywFwIY6SKiKzQ" alt=""><figcaption></figcaption></figure>

### 4. Done

Don't forget to Save your Playbook!