Webhook Url To File (Transcripts)

POST{{your_url}}/your-path

This particular configuration is available in Transcript workspaces, which deal with transcribed text from audio or video files.

The notification sends all transcription data in JSON format, containing the URL that can be used to download the Word file.

The following options are available:

• Endpoint: a publicly available URL where SmartDocumentor can send notifications to. Notifications are sent as HTTP POST requests with the file content.

• Generated file format: Format of file to e uploaded. Currently only .docx is supported.

• Timestamps: Toggle to allow timestamps to be part of the file content.

• Speakers: Toggle to allow speaker labels to be part of the file content.

• Merge Paragraphs: Toggle to ensure that paragraphs with the same speaker are in the same block of text

• Hours until generated file expires: SmartDocumentor sends you a SAS Token protected URL, which must have an expiration date. This field allows you to set the time, in hours, that the sent URL will expire once the notification is set, with a maximum of 168 hours (one week). For the best security, set this value to the lowest value possible that allows your server to download and store the file.

Example Request

Normal Export

{
  "taskId": 0,
  "taskNumber": 0, // nullable
  "workspaceId": 0,
  "displayName": "string",
  "exportedFileUrl": "string",
  "exportedFileContentType": "string",
  "exportedFileExpiresOn": "0001-01-1T01:00:01Z",
  "lastCheckoutByUserName": "string",
  "lastCheckedOutBy": 0,
  "lastCheckedOutUntil": "0001-01-1T00:00:01Z",
  "lastIntegratedBy": 0,
  "lastIntegratedByUserName": "string",
  "metadata": { // has any number of key/value pairs
      "Key_1": "Value_1" // strings non nullable, key will be unique throughout the metafields
  }
}

The following JSON fields are set in the request body:

• taskId: the unique ID that identifies your document/task in SmartDocumentor. It is the same ID that is returned when you call the [POST] Create Task API endpoint.

• taskNumber: the unique ID that identifies this document within it's workspace.

• workspaceId: the unique ID that identifies the workspace this document belongs to.

• displayName: the display name of this document when shown within SmartDocumentor.

• exportedFileUrl: a SAS token protected URL that points to the generated file, in the selected format and with the configured expiration hours. Once this URL expires, the file will no longer be available, so make sure you download the file to your server/storage before the expiration date. Once the URL expires, requests will return 403 Forbidden.

• exportedFileContentType: the content-type/mime-type of the exported file, which matches the selected file format.

• exportedFileExpiresOn: the expiration date for the file, set according to your configuration. Make sure you download the file to your server/storage before the expiration date.

• lastCheckoutByUserName, lastCheckedOutBy, lastCheckedOutUntil: auditing information for the user that last reviewed the document.

• lastIntegratedBy, lastIntegratedByUserName: auditing information for the user that last finished reviewing the document.

• metadata key-value strings that store additional information for the document/task

When working with an automatically split document, all document properties, including taskId, exportedFileUrl, displayName and taskNumber will be set for the originally split document.