POST/api/v1/calls/upload

Subir Llamada

Sube una llamada. Puede proporcionar una mediaUrl en el cuerpo o subir un archivo directamente.

Autenticación

Envía tu API key en el header x-api-key header.

x-api-keybearer

Cuerpo de la petición

obligatorio

Datos de la llamada y subida de archivo opcional

PublicApiCallUploadRequestDto

namerequired

string

Name of the call for uploading

mediaUrl

string

URL of the media file to upload (alternative to file upload)

startDateTimerequired

string (date-time)

Scheduled start date and time of the call

description

string

Description of the call

fromNumber

string

Phone number of the caller

toNumber

string

Phone number of the callee

file

string (binary)

Audio file to upload (alternative to mediaUrl). It must be a valid mp3 / wav file

ownerId

string

ID of the user who owns this call

personIds

array<string>

Array of person IDs for call participants. Use comma to separate values. Recommendation: include the owner's personId here to guarantee feedback generation.

Ejemplo de petición

json

{
  "name": "Sales Call Recording",
  "mediaUrl": "https://example.com/upload/call_recording.mp3",
  "startDateTime": "2024-07-18T14:00:00.000Z",
  "description": "Recording of the sales call with Acme Corp.",
  "fromNumber": "+1234567890",
  "toNumber": "+0987654321",
  "file": "",
  "ownerId": "5516cd47-2bd0-4f4f-adc2-22524e54ba4d",
  "personIds": [
    "5516cd47-2bd0-4f4f-adc2-22524e54ba4d"
  ]
}

Respuestas

201

PublicApiPostCallUploadResponseDto

statusCoderequired

number

countrequired

number

errorrequired

string

datarequired

PublicApiCallUploadResponseDto

Ejemplo de respuesta

json

{
  "statusCode": 200,
  "count": 0,
  "error": null,
  "data": {
    "callId": "5516cd47-2bd0-4f4f-adc2-22524e54ba4d"
  }
}

401No autorizado - clave API o token Bearer faltante o inválido