Transactional WhatsApp Message File Processes

These file processes only work for Cloud API customers; these features are not available for OnPrem customers (TR numbers).

Uploading a file for your transactional WhatsApp messages is a two-step process:

File Upload

You can use the Application Uploads endpoint to describe your file and create an upload session.

If successful, a file handle will be returned, which you can then use with other endpoints that support file handles returned by the Resumable Upload API.

Note: When you upload a file to Meta, the system generates a file ID. This ID can be used instead of the file URL when sending messages.

• As of now, the validity period of Meta File Upload IDs has been reduced from 1 month to 1 week.

• This update only affects file uploads made via API endpoints.

• Panel usage is not affected, as it doesn’t rely on this file ID system.

Headers

Sample Request

curl --location 'https://whatsapp.useinsider.com/v1/media/upload' \
--header 'x-ins-auth-key: INS.1a2b3c4d5e6f' \
--header 'Content-Type: application/json' \
--form 'file=@"/Desktop/test.jpeg"' \
--form 'type="image/jpeg"' \
--form 'messaging_product="whatsapp"'

Sample Response

{
    "id": "{{FILE_ID}}"
}

Get File URL

You can use the returned upload session ID to initiate the upload process.

If successful, a file handle will be returned, which you can then use with other endpoints that support file handles returned by the Resumable Upload API.

Headers

Sample Request

curl --location 'https://whatsapp.useinsider.com/v1/media/{{FILE_ID}}' \
--header 'x-ins-auth-key: INS.1a2b3c4d5e6f' \
--header 'Content-Type: application/json'

Sample Response

{
   "url": "{{FILE_URL}}",
   "mime_type": "FILE_TYPE",
   "sha256": "{{SHA_CODE}}",
   "File_size": {{FILE_SIZE}},
   "id": "{{FILE_ID}}",
   "messaging_product": "whatsapp"
}