# Zendesk Macros

This is how it looks like:

<figure><img src="https://3843507234-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FECPgvsGwy5oMz4WIZw3a%2Fuploads%2F4N7kS1yrr5EwU60yJz1R%2FBirdie%20x%20Zendesk%20-%20Macros%20pour%20Github.png?alt=media&#x26;token=6cb619d6-bfea-4595-973f-1e912516196d" alt=""><figcaption></figcaption></figure>

To create a macro that includes a Birdie Link, watch the video and follow these steps:

{% embed url="<https://youtu.be/PVth0F9lUPQ>" %}
How to add a Birdie link to your Zendesk macros
{% endembed %}

1. Create a new macro on Admin Center > Workspace > Macro > Create a Macro
2. Click on "*Add Action*" and select "*Comment/description*"
3. Go to your Birdie settings and copy "*<mark style="color:green;">Your Birdie link to paste in Triggers, Automations and Macros</mark>*"
4. Write the text you want in your Macro and paste your Birdie link into it
5. Save it. You're all set!

<details>

<summary>Using the Macro Suite app or HTML scenarios?</summary>

If you're using the [Macro Suite app](https://www.zendesk.com/marketplace/apps/support/213512/macro-suite/?queryID=e2b4fc13c27128af2f6e06b71f1ccc76) or working with URL-encoded HTML scenarios, Zendesk may break the Birdie link if it includes raw placeholders like `{{ticket.id}}`.

To prevent this, **URL-encode the link** so that special characters like `{` and `}` are safely interpreted.

For example, instead of:

```
https://your-subdomain.birdie.so/recorder?zar={{ticket.id}}&zce={{ticket.requester.email}}&via={{ticket.via}}
```

Use the URL-encoded version:

```
https://your-subdomain.birdie.so/recorder?zar=%7B%7Bticket.id%7D%7D&zce=%7B%7Bticket.requester.email%7D%7D&via=%7B%7Bticket.via%7D%7D
```

This ensures your macro works reliably in all scenarios.

</details>