Picky Assist Help Desk
Setting UpAPI V2FAQGuide
Search…
Welcome To Picky Assist 🙏
Setting Up Guide
Setting Up Account
Connecting Channels
Setting Up Teambox
Setting Up Smart Replies
Setting Up Broadcaster
Setting Up Sequence
Setting Up CRM
Setting Up Social CRM
Setting Up Connector
Setting Up Widgets
Setting Up Ad-On's
Google Chrome Extensions
Quick Rollout Guide
Archives
API Documentation V2
Introduction
Quick Start Guide 🏃
Sandbox Mode WhatsApp Official
Global Webhook
Event Webhook
Push API
WhatsApp Template API
WhatsApp Group API
WhatsApp Settings API's
Device Manage API’s
Account API
Project Management API
References
Sample Codes
General Guidelines
WhatsApp
Billing
Blacklisting Numbers
Adding Money Into Account
Rate Limits
FAQ
General FAQ
Push API FAQ
Webhook FAQ
Changelog
2021
2020
2019
Powered By GitBook
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. 1.
    👉message-in variable 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 from message-in-raw variable
  2. 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. 1.
    Recipient mobile number must be passed with country code without 0 or +
  2. 2.
    Supports only the POST method and the payload format should be in JSON
  3. 3.
    Make use of dynamic API to send personalised messages in a single API call rather than calling API multiple times
  4. 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-url variable. Please note the URL should not redirect to another page / server.

  1. 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. 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. 3.
    For Facebook messenger, you need to make use of subscriber unique id to send a message.
  4. 4.
    For Sending and Receiving messages through WhatsApp Official Channel use application=8

  1. 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. 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. 3.
    For Sending and Receiving messages through WhatsApp Web Automation Channel use application=10
  4. 4.
    WhatsApp Web Automation Service supports sending and receiving all type of message contents except the WhatsApp Interactive Buttons
  5. 5.
    WhatsApp Web Automation Service supports Group Automation Also. Read More​

  1. 1.
    Please make sure the bridge app is installed and configured in the device. (activated using your project license key)
  2. 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. 3.
    Please make sure the application you pass is installed in your device i.e application=1 (personal) and application=2 (business)
  4. 4.
    For Sending SMS using your SIM Card please make sure your have an active SMS plan.
  5. 5.
    For initiating a call conference make sure your SIM Card is enabled with call conferencing service and have valid calling plan.
  6. 6.
    Always keep in mind the message sending speed and limitations. Read More ​

  1. 1.
    Please make sure you pass application=<your shared number> to route the message correctly.
  2. 2.
    To use push API your project should have an active session with the recipient you would like to send message
  3. 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.
API Documentation V2 - Previous
Introduction
Next - API Documentation V2
Sandbox Mode WhatsApp Official
Last modified 3mo ago
Copy link
On this page
Watch Quick Video Intro
---Video Chapters---
Quick Setup
Receiving Messages
Sending Messages (PUSH API)
Using WhatsApp Official Account
Using WhatsApp Web Automation
Using Phone Automation (Depreciated)
Using WhatsApp Shared Number
Sending Templated Messages to WhatsApp
API Rate Limit