Introduction

​

Welcome to Oration AI

​

Key Features

• Create conversations: Easily initiate single or multiple AI-driven conversations with a single API call.
• Get conversation details: Get the latest conversation status and details for any conversation.
• Tickets: Create, search, and update tickets; change status, assign teammates, and react to webhooks.

​

Getting Started

1. An API key (x-api-key)
2. A workspace identifier: either x-workspace-slug or x-workspace-id (one is required; you do not need both)

{
  "x-api-key": "your-api-key-here",
  "x-workspace-id": "your-workspace-id-here"
}

{
  "x-api-key": "your-api-key-here",
  "x-workspace-slug": "your-workspace-slug-here"
}

​

Base URL

https://www.oration.ai/api/v2

​

Example Request

curl --request POST \
  --url https://www.oration.ai/api/v2/conversations \
  --header 'x-api-key: your-api-key-here' \
  --header 'x-workspace-id: your-workspace-id-here' \
  --data '{
  "conversations": [
    {
      "agentId": "<agent-uuid>",
      "conversationType": "telephony",
      "toPhoneNumber": "+1234567890",
      "dynamicVariables": {
        "name": "John Doe"
      }
    }
  ]
}'

​

What’s Next?

• Create and manage conversations
• Work with different conversation types
• Automate tickets and subscribe to ticket webhooks
• Handle API responses and errors