Skip to main content

​
What can you do with it?

Record, transcribe, and analyze sales calls and meetings with Chorus.ai, including retrieving current user information, listing conversations, getting conversation details with transcripts, creating comments on conversations, and managing playlists for comprehensive conversation intelligence and sales analytics.

​
How to use it?

​
Basic Command Structure

/your-chorusai-connection [action] [required-parameters] [optional-parameters]

​
Parameters

Required:
  • action - The operation to perform (get-current-user, list-conversations, get-conversation, create-comment, list-playlists)
Optional:
  • conversation-id - Chorus.ai conversation ID
  • comment-text - Comment text content
  • comment-timestamp - Timestamp for comment placement
  • comment-visibility - Comment visibility (team, private)
  • page-size - Number of items per page
  • page-number - Page number for pagination

​
Tools

​
Get Current User

Retrieve the current user’s Chorus.ai information Parameters:
  • No parameters required
Example: 
/your-chorusai-connection
action: get-current-user
Response: 
{
  "id": "user_123abc",
  "email": "[email protected]",
  "firstName": "John",
  "lastName": "Doe",
  "role": "admin",
  "createdAt": "2023-01-15T08:30:00Z",
  "updatedAt": "2024-01-20T14:25:33Z"
}

​
List Conversations

Retrieve a list of conversations with pagination Parameters:
  • page-size (optional) - Number of conversations per page (default: 25)
  • page-number (optional) - Page number (default: 1)
Example: 
/your-chorusai-connection
action: list-conversations
page-size: 25
page-number: 1
Response: 
{
  "conversations": [
    {
      "id": "conv_xyz789",
      "title": "Sales Call with Acme Corp",
      "startTime": "2024-02-01T15:00:00Z",
      "duration": 3600,
      "status": "completed",
      "participants": [
        {
          "id": "user_123abc",
          "name": "John Doe",
          "email": "[email protected]",
          "role": "host"
        }
      ],
      "metadata": {
        "dealSize": "$50000",
        "stage": "discovery"
      }
    }
  ],
  "pagination": {
    "totalCount": 150,
    "pageSize": 25,
    "currentPage": 1
  }
}

​
Get Conversation

Retrieve detailed information for a specific conversation including transcript and insights Parameters:
  • conversation-id (required) - Chorus.ai conversation ID
Example: 
/your-chorusai-connection
action: get-conversation
conversation-id: conv_xyz789
Response: 
{
  "id": "conv_xyz789",
  "title": "Sales Call with Acme Corp",
  "startTime": "2024-02-01T15:00:00Z",
  "endTime": "2024-02-01T16:00:00Z",
  "duration": 3600,
  "status": "completed",
  "transcript": {
    "segments": [
      {
        "id": "seg_001",
        "speakerId": "user_123abc",
        "speakerName": "John Doe",
        "startTime": 0,
        "endTime": 15,
        "text": "Hi everyone, thanks for joining today's call."
      }
    ]
  },
  "insights": {
    "talkRatio": {
      "rep": 0.4,
      "customer": 0.6
    },
    "keywords": [
      "pricing",
      "implementation",
      "timeline"
    ]
  }
}

​
Create Comment

Add a comment to a specific conversation at a given timestamp Parameters:
  • conversation-id (required) - Chorus.ai conversation ID
  • comment-text (required) - Comment text content
  • comment-timestamp (required) - Timestamp in seconds for comment placement
  • comment-visibility (optional) - Comment visibility (team, private, default: team)
Example: 
/your-chorusai-connection
action: create-comment
conversation-id: conv_xyz789
comment-text: Great discovery of pain points at 15:30
comment-timestamp: 930
comment-visibility: team
Response: 
{
  "id": "comment_456def",
  "text": "Great discovery of pain points at 15:30",
  "timestamp": 930,
  "visibility": "team",
  "createdBy": "user_123abc",
  "createdAt": "2024-02-01T16:30:00Z"
}

​
List Playlists

Retrieve a list of playlists for organizing conversations Parameters:
  • page-size (optional) - Number of playlists per page (default: 10)
  • page-number (optional) - Page number (default: 1)
Example: 
/your-chorusai-connection
action: list-playlists
page-size: 10
page-number: 1
Response: 
{
  "playlists": [
    {
      "id": "playlist_789ghi",
      "name": "Best Discovery Calls Q1 2024",
      "description": "Top performing discovery calls from Q1",
      "createdBy": "user_123abc",
      "createdAt": "2024-01-05T09:00:00Z",
      "conversationCount": 12
    }
  ],
  "pagination": {
    "totalCount": 5,
    "pageSize": 10,
    "currentPage": 1
  }
}

​
Notes

Chorus.ai uses custom proxy integration through Paragon. Conversation IDs are alphanumeric identifiers for specific calls or meetings. Transcripts include speaker identification and timing information. Comments can be placed at specific timestamps within conversations. Talk ratio insights show speaking time distribution between participants. Keywords are automatically extracted from conversation content. Playlists help organize conversations by themes or criteria.