> ## 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 workflow actions in OpenCX

> What each OpenCX workflow action does on a Genesys Cloud session, and how to book callbacks and run your Genesys Data Actions and data tables from workflows.

OpenCX workflows act on Genesys Cloud sessions too: the usual actions reach the Genesys conversation, and a few actions are Genesys's own. Read this when you build a workflow, or an AI-trigger workflow the AI can call, for a Genesys workspace.

| Action | On Genesys sessions |
| - | - |
| **Reply to ticket** | Replies on the customer's channel. With **Send to Third Party Ticketing Integration** on, also sets `opencx_last_workflow_reply`. |
| **Close Ticket** | With **Close in Third Party Ticketing Integration** on, also ends the conversation. |
| **Append note** | With **Send to Third Party Ticketing Integration** on, adds to `opencx_notes`. |
| **Update Session Attributes** | Sets `genesys_attr_` and `genesys_workitem_` attributes. |
| **Make authenticated ticketing request** | Calls any Genesys Cloud API in your region. |
| **Get Ticket External IDs** | Returns the conversation and workitem IDs. |
| **Create Genesys Workitem** | Creates or returns the session's [workitem](https://docs.open.cx/integrations/genesys/workitems.md), in the synced queue picked under **Queue** (empty uses the worktype's default). A worktype must be set. |
| **Update Genesys Workitem** | Changes the fields you fill in. Fails with no workitem. |
| **Transfer To Genesys Queue** | Transfers the conversation to the synced queue picked under **Queue**. |
| **Merge Genesys Session** | Merges a session into another. The merged session's conversation ends. |
| **Create Genesys Callback** | Books a [callback](#callbacks): **Queue** (a synced queue picked from the list; empty uses the queue the session was offered a callback on, else your default queue), **Phone Number** in international format, optional **Scheduled Time** in the future and **Customer Name**. Returns the callback's conversation ID. Running the same step again returns the same callback. |
| **Run Genesys Data Action** | Runs one of your [Data Actions](#data-actions-and-data-tables) with its inputs, checked first against the action's input contract. Returns what the action returned as **Output**. |
| **Lookup Genesys Data Table Row** | Reads a [data table](#data-actions-and-data-tables) row by **Key**. Returns **Found** and the row's columns as **Fields**. |
| **Assign Ticket to AI** | Ends the conversation. A later handoff opens a new one. |
| **Unassign AI** | Opens a conversation, as a handoff does. |
| **Update Contact** | Updates the linked external contact too. |
| **Handoff** | Opens one conversation. |
| **Reopen Ticket** | Stays in OpenCX. The customer's next message opens a new conversation. |

To import one past Genesys conversation in a workflow, see [Import past conversations](https://docs.open.cx/integrations/genesys/every-conversation.md#import-past-conversations).

## Callbacks

**Create Genesys Callback** asks Genesys to call the customer back from a queue, now or at a set time. The callback carries the session's summary and its link as `opencx_summary`, `opencx_inbox_url` and `opencx_session_id`, an internal note on the session records it, and the session keeps the callback's conversation ID as `genesys_callback_conversation_id`. With [every Genesys conversation](https://docs.open.cx/integrations/genesys/every-conversation.md) shown, the call appears as a sub-session of that session. A number not in international format, a time in the past or a queue that isn't synced is refused before anything reaches Genesys. If Genesys refuses the callback, the step fails, and **Health** asks you to reconnect when the permission is missing.

To let the AI book callbacks, create an AI-trigger workflow, for example "Book a callback when the customer gives a phone number", with a phone number in its payload and the **Create Genesys Callback** action using the session ID and that number. **Offer a callback** under [When no agents are available](https://docs.open.cx/integrations/genesys/handoff.md#when-no-agents-are-available) uses that workflow.

## Data Actions and data tables

The Data Actions and data tables your Genesys flows already use work in OpenCX workflows too, so the AI can look up an order, a balance or a delivery zone the same way your IVR does.

* **Run Genesys Data Action**: pick the action from your Genesys org (listed as name · category), then fill in its inputs, typed or mapped from earlier steps, named exactly as in the action's input contract (in Genesys: **Admin › Integrations › Actions**, the action, **Setup › Contracts**). Inputs that don't match the action's input contract stop the step before the action runs. Later steps use the fields of **Output**. Secure Data Actions aren't listed or run, so data Genesys keeps secure stays in Genesys. An action that fails or takes longer than 30 seconds fails the step and is never run a second time.
* **Lookup Genesys Data Table Row**: pick the table (the list shows its key column), then give the key. **Found** is false when the table has no row with that key, so a later step can branch on it.

The queue, Data Action and data table lists show only what your own Genesys org has, and stay empty until Genesys is connected. Instead of picking, any of them can take a variable from an earlier step.

To let the AI use them, add them to an AI-trigger workflow, for example "Check the customer's balance when they ask for it", with what the action needs in its payload. The AI gets the workflow's result.

Both work only once your organization is on Genesys, and only with actions and tables in your own Genesys org. They need `integrations:action:view` and `integrations:action:execute` for Data Actions, and `architect:datatable:view` for data tables. When Genesys refuses one a workflow runs, the step fails and **Health** asks you to reconnect Genesys to grant it.

## Related

> [card] [Handoff settings](https://docs.open.cx/integrations/genesys/handoff.md)
>
> Offer a callback when nobody is on the queue.

> [card] [Permissions](https://docs.open.cx/integrations/genesys/permissions.md)
>
> Callbacks, Data Actions and data tables need their own permissions.


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