Sign in

v1

latestOpenAPI 3.0.1Apache 2.02026-07-1398228598.3 KB
Conversation

Import Conversation

Import a conversation from a media file. This endpoint creates a new conversation from an external source (e.g., Gong, Salesforce) and processes it through the Attention platform's transcription and analysis pipeline.

post/conversations/import

Request body

mediaURLstring required

URL of the media file to import (audio or video)

userIDstring required

UUID of the user who owns this conversation

applicationNamestring

Name of the external application (e.g., 'zap:gong', 'salesforce')

applicationExternalIDstring

External ID from the source application

conversationTitlestring

Title or name of the conversation

conversationStartedAtstring date-time

When the conversation started (ISO 8601 format)

opportunityIDstring

ID of the associated opportunity or deal

skipScorecardCalculationboolean

Skip automatic scorecard calculation for this conversation

skipCRMFieldsCalculationboolean

Skip CRM fields calculation for this conversation

skipOpportunitiesExportboolean

Skip exporting opportunities for this conversation

Example request

{
  "mediaURL": "https://storage.example.com/recordings/call-abc123.mp4",
  "userID": "user-uuid-123",
  "conversationTitle": "Q1 Deal Review - Acme Corp",
  "conversationStartedAt": "2024-03-18T10:30:00Z",
  "applicationName": "zoom",
  "applicationExternalID": "zoom-meeting-987654",
  "opportunityID": "opp-uuid-456",
  "linkedCrmRecords": [
    {
      "id": "001ABC123",
      "code": "Account"
    }
  ],
  "externalMetadata": {
    "participants": [
      {
        "email": "jane@example.com",
        "name": "Jane Smith",
        "accessType": "Internal",
        "organizer": true
      },
      {
        "email": "john@customer.com",
        "name": "John Doe",
        "accessType": "External",
        "organizer": false
      }
    ],
    "extra": {
      "source": "zoom",
      "meetingDuration": 1800
    }
  },
  "transcriptionSettings": {
    "gladia": {
      "enableDiarization": true
    }
  },
  "headers": [
    {
      "key": "Authorization",
      "value": "Bearer token123"
    }
  ],
  "skipCRMFieldsCalculation": false,
  "skipOpportunitiesExport": false,
  "skipScorecardCalculation": false
}

Response

Conversation successfully imported

uuidstring required

UUID of the newly imported conversation

Example response

{
  "uuid": "conv-uuid-new-123"
}