Skip to main content
POST
/
conversations
/
import
Import Conversation
curl --request POST \
  --url https://api.attention.tech/v2/conversations/import \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '{
  "mediaURL": "<string>",
  "userID": "<string>",
  "applicationName": "<string>",
  "applicationExternalID": "<string>",
  "conversationTitle": "<string>",
  "conversationStartedAt": "2023-11-07T05:31:56Z",
  "headers": [
    {
      "key": "<string>",
      "value": "<string>"
    }
  ],
  "opportunityID": "<string>",
  "linkedCrmRecords": [
    {
      "id": "<string>",
      "code": "<string>"
    }
  ],
  "skipScorecardCalculation": true,
  "skipCRMFieldsCalculation": true,
  "skipOpportunitiesExport": true,
  "transcriptionSettings": {
    "gladia": {
      "enableDiarization": true
    }
  },
  "transcript": {
    "v1": {
      "pieceInFlux": "<string>",
      "final": [
        {
          "speaker": "<string>",
          "sentence": "<string>",
          "startTimestamp": 123,
          "endTimestamp": 123
        }
      ]
    },
    "v2": {
      "pieceInFlux": "<string>",
      "final": [
        {
          "speaker": "<string>",
          "words": [
            {
              "text": "<string>",
              "startTimestamp": 123,
              "endTimestamp": 123
            }
          ]
        }
      ]
    }
  },
  "externalMetadata": {
    "participants": [
      {
        "email": "<string>",
        "name": "<string>",
        "accessType": "Internal",
        "organizer": true
      }
    ],
    "extra": {}
  }
}'
{
  "uuid": "<string>"
}

Authorizations

Authorization
string
header
required

Body

Conversation import data including media URL, user information, and optional metadata

mediaURL
string
required

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

userID
string
required

UUID of the user who owns this conversation

applicationName
string

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

applicationExternalID
string

External ID from the source application

conversationTitle
string

Title or name of the conversation

conversationStartedAt
string<date-time>

When the conversation started (ISO 8601 format)

headers
object[]

HTTP headers to use when fetching the media file

opportunityID
string

ID of the associated opportunity or deal

linkedCrmRecords
object[]

CRM records linked to this conversation (accounts, contacts, etc.)

skipScorecardCalculation
boolean

Skip automatic scorecard calculation for this conversation

skipCRMFieldsCalculation
boolean

Skip CRM fields calculation for this conversation

skipOpportunitiesExport
boolean

Skip exporting opportunities for this conversation

transcriptionSettings
object
transcript
object
externalMetadata
object

Response

Conversation successfully imported

uuid
string
required

UUID of the newly imported conversation