Sending Media Attachments – Push

You can send media files using the below method;

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

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

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

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 + [phone] – Wrong Format 55123456789 – Correct Format
message	string	Pass Caption message here Caption text is not supported for PDF, Audio, Document

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.

{
    "status": 100,
    "push_id": "7478630",
    "message": "Success",
    "data": [
        {
            "msg_id": "9844217",
            "number": "934343442290",
            "credit": "0.005"
        },
        {
            "msg_id": "9844218",
            "number": "35435304220",
            "credit": "0.005"
        }
    ]
}

Sample Request Body JSON for Sending Static Media Files

{
  "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

{
  "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

Please note this method works only WhatsApp Web Automation Channel

{
   "token":"248f02903a57ee0fed380bd500dd1293e6d",
   "application":"10",
   "globalmedia":"Audio URL",
   "voice":1,
   "data":[
      {
         "number":"1194407768",
         "message":""
      }
   ]
}

Sample Request Body JSON for Sending Dynamic Media

Sending dynamic media is supported only in WhatsApp Official & WhatsApp Shared Numbers

{
   "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

Sending dynamic media is supported only in WhatsApp Official & WhatsApp Shared Channels

{
   "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

{
    "status": 100,
    "push_id": "7478630",
    "message": "Success",
    "data": [
        {
            "msg_id": "9844217",
            "number": "934343442290",
            "credit": "0.005"
        },
        {
            "msg_id": "9844218",
            "number": "35435304220",
            "credit": "0.005"
        }
    ]
}

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.