How to Get Direct Media Link From Omnichannel?

  • Updated

While trying to broadcast different types of media through Omnichannel, or create a template with media through API, it will require a direct link to the media, to add them as a header.

1. Copy the Media URL from Approved WhatsApp Template

If you are trying to send a WhatsApp broadcast template and need a media direct URL for the header in your CSV or API, you can copy the default URL of the media you have uploaded when submitting the template. 

1. Open Outbound Menu > WhatsApp Broadcast Templates > choose the desired template

2. Click the Copy Media Link then you can use it now.

Note: if the Media Link format from this step is like, the link will not work if used as a header parameter. So, please try method number 2 or 3 below.


2. Using Omnichannel Dashboard to Get a Media Direct URL

1. Open a session with yourself


2. As an Agent or Admin on your Omnichannel, send your image by clicking this button and choosing your desired image



3. Once the image is uploaded, click right on the image and then choose "copy image address"


Or you can choose "open image in new tab", and see the image URL:


4. Copy and save your URL for use later.



3. Using API to Get a Media Direct URL

1. You need to get the SDK token before uploading the image

curl --location --request POST '' \
--header 'qiscus-sdk-app-id:{{appid}}' \
--header 'content-type: application/x-www-form-urlencoded' \
--data-urlencode '' \
--data-urlencode 'password=123456789' \
--data-urlencode 'username=User Upload'

2. Uploading images using API

curl --location --request POST '' \
--header 'qiscus_sdk_app_id:{{appid}}' \
--header 'qiscus_sdk_token:{{token}}' \
--form 'file=@"elXDTpDyE/unnamed.jpeg"'

3. or using Secret Key Omnichannel (no need to get SDK token in step 1-2)

curl --location --request POST '' \
--header 'qiscus_sdk_app_id:{{appid}}' \
--header 'qiscus_sdk_secret:{{secret_key}}' \
--form 'file=@"elXDTpDyE/unnamed.jpeg"'

Example response

"results": {
"file": {
"name": "Qiscus.jpeg",
"pages": 1,
"size": 33184,
"url": ""
"status": 200


Was this article helpful?



Please sign in to leave a comment.