Genesys Cloud - Developer Community!

I'm looking for a way to track or retrieve Text-to-Speech (TTS) usage in Genesys Cloud. I've searched the documentation and APIs but couldn't find anything specific to TTS usage metrics (such as cost or billing).

• Is there a supported way to monitor TTS usage through API or reports?
• Has anyone implemented a workaround (e.g., logging TTS billing content in Architect)?

Any insights would be appreciated.

In Genesys Cloud, this type of monitoring is handled via Billing and Subscription APIs. Below is an example based on the Billing Overview endpoint, which is where these consolidated TTS units are reported.

1. Request

This is a GET request. It typically does not require a JSON body (payload) because the parameters (such as the Org ID) are passed in the URL.

Example URL:

https://api.mypurecloud.com/api/v2/billing/trusteebillingoverview/{trustorOrgId}

Headers:

Authorization: Bearer {token}

Content-Type: application/json

2. Response

The response will be a JSON object containing a list of all billable resources. You should look for the item related to Enhanced TTS.

Example Response JSON (Simplified):

{

  "id": "example-org-id",

  "name": "Your Org Name",

  "billingPeriod": {

    "startDate": "2024-05-01",

    "endDate": "2024-05-31"

  },

  "usages": [

    {

      "name": "Genesys Cloud Enhanced TTS",

      "unitType": "Millions of Characters",

      "quantity": 120.0,

      "amount": 600.00,

      "usageCategory": "Usage"

    },

    {

      "name": "Genesys Cloud CX 3",

      "unitType": "Users",

      "quantity": 50,

      "amount": 5500.00,

      "usageCategory": "Subscription"

    }

  ]

}

Key Fields to Observe:

quantity: 120.0 – This is the exact value you see on your dashboard (the 120 units you mentioned).

unitType: "Millions of Characters" – Confirms that each unit represents 1 million characters.

amount – If your account permissions allow viewing financial data via API, the total cost for these units will appear here (e.g., 120 units x $5.00 = $600.00).

------------------------------
Geraldo Sousa
NA
------------------------------