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

# Genesys Cloud canned responses as OpenCX macros

> Bring your Genesys Cloud canned responses into OpenCX as read-only macros, so teammates reply with the same wording. Use when your team answers in both places.

Turn on **Canned responses as macros** on the **Directory** tab, and your Genesys canned responses appear in OpenCX as macros, so teammates answering sessions in OpenCX use the same wording as your Genesys agents. It's off by default. They arrive right away, and every directory refresh after that brings in new responses, follows edits and removes the ones deleted in Genesys. A refresh that couldn't read every response removes nothing.

| Topic | How it works |
| - | - |
| **What comes in** | Each canned response becomes a macro every agent can use: its name is the title, its library the category (the first by name when it's in several), its text the body. Links, lists and line breaks are kept; scripts, styles and images are left out. WhatsApp templates stay in **Send template**, and footers, forms and campaign templates aren't brought in. |
| **Edit them in Genesys** | These macros show **From Genesys** and their title, category and text can't be changed or deleted in OpenCX, including through the API. What Genesys doesn't have stays yours: whether a macro is suggested, and which teams see it, and a refresh never changes them. An agent can still keep a personal version of one. Translations and suggested macros work as for any macro. |
| **Placeholders** | A `{{name}}` placeholder becomes your macro variable of the same name when your workspace has one under **Settings → Macros**. Otherwise it reads `{name}`, for the agent to fill in. |
| **Turning it off** | Turning it off asks you to confirm. Turning it off, disconnecting, or connecting a different Genesys org removes these macros, and only these. If one is ever left behind, turn the setting on and off again, or delete it with the [API](https://docs.open.cx/api-reference/macros/delete.md). |

It needs `responses:response:view`, the same permission as WhatsApp templates. Without it, nothing changes and Health shows a **Canned responses** warning: reconnect Genesys to grant it.

## Related

> [card] [Macros API](https://docs.open.cx/api-reference/macros/index.md)
>
> `genesys_response_id` names the canned response a macro comes from.

> [card] [Permissions](https://docs.open.cx/integrations/genesys/permissions.md)
>
> What the role needs to read canned responses.


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