Quick Start Guide 🏃
0:00 WhatsApp API Integration Guide
0:35 How Webhook Works to Receive WhatsApp Messages
0:50 Setting Up WhatsApp Webhook to Receive Incoming WhatsApp Messages
7:03 Using the WhatsApp Push API to Send Messages Out
9:21 Using Postman Collection for Testing WhatsApp API
12:08 Checking WhatsApp Sent Report & Status
Generate API Token -> Select Your Project -> Settings -> API Token
Setup Webhook -> Select Project - Settings -> Webhook
Webhook & API Supports only POST Method & Both make use of JSON Format , no header based authentication required, pass the api token
token variable in body.Webhook is responsible to handle the incoming messages to your application. When a new message arrives in your application then the message details will be pushed to your web server instantly.
- 1.👉
message-invariable holds the message contents and this is URL encoded, so you need to decode the same. You can also get the raw i.e URL not coded value frommessage-in-rawvariable - 2.👉 We use the POST method to push messages to your server and the payload format is JSON.
Instant Reply - if you would like to give an instant reply back to the user whenever you receive an incoming message then give your reply message in JSON Format as a response to the webhook (like giving acknowledgment )
This method is highly recommended for all those who want to give an instant reply back without calling the Push API
Phone automation doesn't support receiving incoming media files i.e you will get only text messages in your webhook but it's possible to know what kind of media you have received. See Workaround Solution
In order to send messages out, you need to make use of the PUSH API. Use our postman collection for quick testing. Get Postman Collection
- 1.Recipient mobile number must be passed with country code without 0 or +
- 2.Supports only the POST method and the payload format should be in JSON
- 3.Make use of dynamic API to send personalised messages in a single API call rather than calling API multiple times
- 4.If you would like to send media files then please upload your media to a public URL and pass the link to download through
media-urlvariable. Please note the URL should not redirect to another page / server.
- 1.For WhatsApp Official & Shared number make sure you have a valid session to the recipient mobile number before sending a message, if there is no valid session then you need to make use of approved template messages
- 2.WhatsApp Official new numbers must go through warm-up process i.e by default all new numbers are allowed to send messages only to 1000 users in 24 hours window this will gradually increase when you send messages to more users. This is not applicable for WhatsApp session messages. Read More
- 3.For Facebook messenger, you need to make use of subscriber unique id to send a message.
- 4.For Sending and Receiving messages through WhatsApp Official Channel use application=8
- 1.For WhatsApp Web Automation you must first request a WhatsApp Web Automation Server from your account, Login and Select the Project Go to -> Settings -> Channels (Tab) -> WhatsApp Web Automation. Read More
- 2.Once the WhatsApp Server is enabled you need to scan your existing WhatsApp Web QR code with our Server, once it's connected your will not able to use the WhatsApp Web further in your Desktop
- 3.For Sending and Receiving messages through WhatsApp Web Automation Channel use application=10
- 4.WhatsApp Web Automation Service supports sending and receiving all type of message contents except the WhatsApp Interactive Buttons
- 5.
- 1.Please make sure the bridge app is installed and configured in the device. (activated using your project license key)
- 2.Make sure the device screen is unlocked "Screen Lock should set to "None" and no dual WhatsApp or any virtualisation app are installed in the device.
- 3.Please make sure the application you pass is installed in your device i.e application=1 (personal) and application=2 (business)
- 4.For Sending SMS using your SIM Card please make sure your have an active SMS plan.
- 5.For initiating a call conference make sure your SIM Card is enabled with call conferencing service and have valid calling plan.
- 6.
- 1.Please make sure you pass application=<your shared number> to route the message correctly.
- 2.To use push API your project should have an active session with the recipient you would like to send message
- 3.You can't use the template message if the recipient's mobile number never sends you a message in your keyword.
Templated messages are used only to send messages if no valid session is available against a recipient's mobile number. Read More
All the API request to any end points are rate limited to 90 requests per minute from one project, if we are getting more than 90 request per minute then you will receive an error "429" and those messages or requests will be dropped in our firewall level and won't be showing in your Picky Assist Platform
If you want to send high volume personalised messaging then we highly recommend to make use our Dynamic Push API. Read More
The Admin will also receive an email notification with the Subject "Urgent Rate Limit Reached - Picky Assist" whenever we throttle your request because of the rate limit. Kindly note that in order to avoid cluttering your email inbox we will send email once in every 30 minutes only even if we drop your message continuously.