Video

Makes a bot send a video message.

A video file can be sent by using a URL or a file ID.

  • Using a URL: Only HTTPS is allowed, and originalContentUrl and previewImageUrl are required.
  • Using a file ID: The file ID returned when the content is uploaded is used to send messages.

Note

  • Whenever a file ID is used to send a video message, the recipient's shared storage will be reduced by the size of the video.

Request content {#video-request}

ParameterTypeRequiredDescription
typestringYSet this parameter to "video".
previewImageUrlstringNURL of the preview image (PNG format, HTTPS only)
Maximum length: 1,000 characters
Either previewImageUrl/originalContentUrl or fileId, but not both, must be specified (required).
originalContentUrlstringNURL of the source file (HTTPS only).
Maximum length: 1,000 characters
Either previewImageUrl/originalContentUrl or fileId, but not both, must be specified (required).
fileIdstringNFile ID acquired when uploading content.
Either previewImageUrl/originalContentUrl or fileId, but not both, must be specified (required).

Request example {#video-request-example}

URL {#video-request-example-url}

{  "content": {    "type": "video",    "previewImageUrl": "https://www.worksmobile.com/preview.png",    "originalContentUrl": "https://www.worksmobile.com/video.mp4"  }}

fileId {#video-request-example-fileid}

{  "content": {    "type": "video",    "fileId": "jp1.1628695315008671000.1628781715.0.1000001.0.0.0"  }}