# Sending Media Attachments – Push You can send media files using the below method; {% hint style="info" %} Please pass your internet facing public URL of your media file through **“globalmedia”** please make sure the media file can be downloaded and accessible through internet.\ \ Those who are using standalone application or don't have a webserver for media files then can make use of **"globalmedia\_code"** to pass the base64 code of the media files {% endhint %} ### **Supported Media Files** | Platform | Type | Extension | Max Size | | -------- | -------- | ----------------------------- | -------- | | WhatsApp | Images | jpg, jpeg, gif, png, image | 5 MB | | WhatsApp | Video | mp4, 3gpp | 16 MB | | WhatsApp | Audio | mp3, wav, aac, m4a, amr, opus | 16 MB | | WhatsApp | Document | Any valid MIME-type | 100 MB | Only H.264 video codec and AAC audio codec is supported by WhatsApp ### **Optional Caption Message** For image & video you can pass caption text in the **“globalmessage”** or **“message”** variables, by passing a separate message in the **“message”** variable you have the capability to send dynamic caption message which is helpful for sending personalised messages with image & video. Please note caption message works only with **“image & video”** files ![whatsapp-image-with-caption-message](/files/-LlM-a9UcHUjgBCoeR01) {% hint style="warning" %} **Sending Dynamic Media** Currently we don't support sending dynamic media files to each contacts through a single API for phone & WhatsApp Web automation, so if you need to send dynamic images then please trigger the API multiple times keeping **5 seconds** intervals between each API request.\ \ **Sending dynamic media file is supported for those who are using WhatsApp Official or WhatsApp Shared Numbers use "media" or "media\_code" variable** {% endhint %} ## Sending Media Attachments Messages `POST` `https://pickyassist.com/app/api/v2/push` This API allows you to send Messages with media attachments ### Request URL (V4) Method : **`POST`** ``` https://app.pickyassist.com/api/v2/push ``` #### Request Body | Name | Type | Description | | ------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | token | string | Your API token for authentication | | media\_name | string | Optional for PDF & Documents, pass the file name to be displayed, not supported in Phone Automation, a maximum of 20 characters | | media\_code | string | If you need to pass base64 of the media file then please pass through this variable | | application | number |

Specify through which application the message need to sent.

1 = Whatsapp Personal
2 = Whatsapp Business
3 = SMS
4 = Call Conference
8 = WhatsApp Official
10 = WhatsApp Web Automation

121 = WhatsApp Official Managed
101 = WhatsApp Cloud API

If you have connected multiple channels or using WhatsApp Cloud api then please get the channel id from your project under Settings -> Channels

| | globalmessage | string | Pass Caption Message Here supports only for image and video. | | globalmedia | string | URL from we need to fetch the media , | | priority | string |

This gives priority in the message queue

0 = Low (Default)
1 = High

| | data | array | This is an array in which you need to pass the mobile number and message | | number | number |

Mobile Number with full country code without 0 or +

+55 12345 6789 – Wrong Format
55123456789 – Correct Format

| | message | string |

Pass Caption message here

Caption text is not supported for PDF, Audio, Document

| {% tabs %} {% tab title="200 Please note “100 -> Sucess” response doesn’t means the message has been successfully send to the user, it means your message has been accepted by our servers and pushed to your phone / docker / app for processing. " %} ```javascript { "status": 100, "push_id": "7478630", "message": "Success", "data": [ { "msg_id": "9844217", "number": "934343442290", "credit": "0.005" }, { "msg_id": "9844218", "number": "35435304220", "credit": "0.005" } ] } ``` {% endtab %} {% endtabs %} ### Sample Request Body JSON for Sending Static Media Files ```javascript { "token": "PICKY_API_TOKEN", "priority ": "0", "application": "1", "media_file": "Name of the File", "globalmessage": "Media URL", "globalmedia": "MEDIA FILE UNIQUE URL", "data": [ { "number": "NUMBER 1", "message": "Caption Message" } ] } ``` ### Sample Request Body JSON for sending Static Media Files using Base64 ```javascript { "token": " PICKY_API_TOKEN ", "priority ": "0", "application": "8", "globalmessage": "GLOBAL MESSAGE", "globalmedia_code": "Media Base64 Code", "data": [ { "number": " NUMBER 1 ", "message": "Caption Message" } ] } ``` ### ### Sample Request Body JSON for Sending Audio File as Voice Note {% hint style="danger" %} Please note this method works only WhatsApp Web Automation Channel {% endhint %} ```javascript { "token":"248f02903a57ee0fed380bd500dd1293e6d", "application":"10", "globalmedia":"Audio URL", "voice":1, "data":[ { "number":"1194407768", "message":"" } ] } ``` ### Sample Request Body JSON for Sending Dynamic Media {% hint style="danger" %} Sending dynamic media is supported only in WhatsApp Official & WhatsApp Shared Numbers {% endhint %} ```javascript { "token":"PICKY_API_TOKEN", "priority ":"0", "application":"8", "globalmessage":"", "data":[ { "number":"NUMBER 1", "message":"MESSAGE FOR NUMBER 1", "media":"media url for number 1" }, { "number":"NUMBER 2", "message":"MESSAGE FOR NUMBER 2", "media":"media url for number " }, { "number":"NUMBER 3", "message":"MESSAGE FOR NUMBER 3", "media":"media url for number 3" }, { "number":"NUMBER 4", "message":"MESSAGE FOR NUMBER 4", "media":"media url for number 4" }, { "number":"NUMBER 5", "message":"MESSAGE FOR NUMBER 5", "media":"media url for number 5" } ] } ``` ### Sample Request Body JSON for Sending Dynamic Media through Base64 {% hint style="danger" %} Sending dynamic media is supported only in WhatsApp Official & WhatsApp Shared Channels {% endhint %} ```javascript { "token":"PICKY_API_TOKEN", "priority ":"0", "application":"8", "globalmessage":"", "data":[ { "number":"NUMBER 1", "message":"MESSAGE FOR NUMBER 1", "media_code":"base64 code for number 1" }, { "number":"NUMBER 2", "message":"MESSAGE FOR NUMBER 2", "media_code":"base64 code for number 2" }, { "number":"NUMBER 3", "message":"MESSAGE FOR NUMBER 3", "media_code":"base64 code for number 3" }, { "number":"NUMBER 4", "message":"MESSAGE FOR NUMBER 4", "media_code":"base64 code for number 4" }, { "number":"NUMBER 5", "message":"MESSAGE FOR NUMBER 5", "media_code":"base64 code for number 5" } ] } ``` ### ### Sample Response ```javascript { "status": 100, "push_id": "7478630", "message": "Success", "data": [ { "msg_id": "9844217", "number": "934343442290", "credit": "0.005" }, { "msg_id": "9844218", "number": "35435304220", "credit": "0.005" } ] } ``` {% hint style="info" %} Please note **“100 -> Sucess”** response doesn’t means the message has been successfully sent to the user, it means your message has been accepted by our servers and pushed to your phone / docker /app for processing. {% endhint %} --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://help.pickyassist.com/api-documentation-v2/push-api/sending-media-attachments-push.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.