Send transcript batch

Submits a batch of transcript messages for a given interaction or workflow session.

The {id} path parameter accepts either an interactionId or a workflow session ID.

Each message in the batch is processed sequentially. The response contains a summary of successful and failed messages. Partial success is possible — some messages may succeed while others fail.

Finding Your Customer Subdomain

Your subdomain is found in your Avaya Infinity portal URL and is required for all API calls.

Example: If your portal URL is:

https://core.avaya1234.ec.avayacloud.com/app/core-config-ui/

Your subdomain is: avaya1234

To use this API:

  1. Find your subdomain from your Infinity portal URL (as shown above)
  2. Get your Bearer token using your provisioned client credential (see Authentication below)
  3. In the API explorer on the right:
    • Click on {customerId} in the URL field and replace it with your actual subdomain
    • Paste your Bearer token in the Credentials section
    • Fill out the request body with your message batch

Authentication

This endpoint requires a valid OAuth 2.0 Bearer token. To get started, contact Avaya Support to request a client_id and client_secret provisioned with the TRANSCRIPT scope.

Once you have your credentials, generate an access token and include it in the Authorization: Bearer <token> header of each request.

Working with Interaction IDs

The {id} path parameter accepts:

  • An interactionId for standard voice or digital interactions (format: 004d01...)
  • A workflow session ID for WORKFLOW_SESSION type sessions

Use whichever ID corresponds to the interaction context you are writing transcripts for.

Important Notes

  • Both messages array and author.type are required. All other fields are optional.
  • Omitting direction defaults to in (inbound). Omitting createdAt defaults to server time.
  • Partial success is normal — inspect failed and errors in the response even on a 200.
  • Validation errors return 422 Unprocessable Entity, not 400. Each error object includes type, value, msg, path, and location.

DOS Protection & Rate Limiting

  • Implement retry logic with exponential backoff if you encounter rate limit errors.
  • Avoid sending large batches in tight loops — space requests appropriately.

Security Implementation Guidelines

  • Never expose your client_secret or Bearer token to client-side applications.
  • Implement proper error handling — avoid surfacing internal error details to end users.
Language
Credentials
Bearer
URL
Response
Click Try It! to start a request and see the response here!