Setting Up WhatsApp Web

This article helps you to setup WhatsApp Web as channel to your picky assist project
This is a paid Chanel once enabled you will able to connect WhatsApp Web with Picky Assist as Channel and able to send and receive WhatsApp messages right from the Picky Assist Web Console or API. Please Click Here to Complete Details


  1. 1.
    WhatsApp Personal / Business App installed in a Phone Connected to the Internet.
  2. 2.
    WhatsApp Web Automation Adon Enabled in your Picky Assist Project


  1. 1.
    Not able to sync the media messages which are sent manually from the phone.
  2. 2.
    Not able to download message history prior connecting the WhatsApp number with Picky Assist Automation Server

Known Issues as on April 2022

  1. 1.
    No known issues found

Video Tutorial

----Contents of the Video------ 0:00​ - Introduction 0:26​ - How Web Automation Works? 1:09​ - Getting the Demo Access 1:49​ - Connecting WhatsApp 2:11​ - Using QR Code Connecting URL 3:23​ - Before Scanning QR Code 4:26​ - Scanning QR Code 5:26​ - Disconnecting Connected WhatsApp 5:42​ - Deleting Queued Messages 6:08​ - Various Statuses 6:54​ - Disabling Incoming Messages 6:59​ - Disabling Outgoing Messages 7:12​ - How Queue Limit Works 7:38​ - How Delay Between Message Works 7:59​ - Sync Message from Connected Phone 8:53​ - Setting Disconnection Event Alerts 9:54​ - How to Restart App 10:14​ - How to Restart Server 10:37​ - Getting Help

Getting Started

Once the WhatsApp Web automation is enabled you need to scan the QR code from your WhatsApp App from Settings -> Channels -> WhatsApp Web Automation as seen below;
A popup will appear as below "Select the Data Centre" which is near to your country then click on "Activate WhatsApp Web" button as shown below

Scan the QR Code

  1. 1.
    Open WhatsApp in your phone
  2. 2.
    Tap Menu or Settings and select "Linked Devices" and click on "Link A Device"
  3. 3.
    Point your phone to this screen to capture the code

The QR Code keep changing in every 10 seconds so please don't take a screenshot and share it with others to pair it, instead use the QR Code Connection URL to share the QR code

It will take 20 seconds to 5 minutes to connect the WhatsApp Web with your Picky Assist Project, so please wait until it re-direct automatically to the settings page. If you have more than 1000 open chats and lots of groups then synching with WhatsApp Web will taking longer time, you can either delete the unwanted chat conversation from the phone or "Delete All Chats" for quick pairing and best performance.

QR Code Connecting URL

If the WhatsApp phone is not with you or you are using the services for your customers then you can make use of the QR Code Connecting URL, to see the QR code connecting URL please scroll till you see the URL option as shown below;
You need to enable the Status then only the user can scan the QR code, once the status is enabled you can simply share the URL with your customers and guide them to open the WhatsApp App and scan the QR Code Please note this URL will work only when your WhatsApp Web Adon is in pairing mode i.e not connected with a number.

Settings & Configuration

Once the WhatsApp Web is successfully connected with the Picky Assist Project you will able to see the Settings menu as shown below ;
Settings Name
WhatsApp Number
This is the number of your Connected WhatsApp
Disconnect : On clicking the disconnect button the number will get released from Picky Assist Servers, you can connect another number or can connect same number after sometime
Queued Messages
This will show messages which are in queue , you can click on the refresh icon to get the latest queue count, for any reason if you wish to delete queued messages then you can use the "Clear Queue" button , this will clear all messages in the queue and there will no refund process for these messages.
Connected Status
This helps you to identify whether the connection between your phone and our server is established or not, below are the possible status
Connected = Connection Established
Timeout = Please check your Phone Internet Connection
Unpaired = WhatsApp Web is not paired with our Server
No Response = Our Server is not giving response, please click the "Restart App"
Connected Date
On which date the number is connected with your project
Incoming Message
This helps you to disable the incoming messages , once disables incoming messages will be processed by Picky Assist (you will also not be billed)
Outgoing Message
This helps you to disable the outgoing messages, once disables you will not able to send messages out. (messages will fail)
Queue Limit
This is one of the important value which helps you to queue the messages after it reaches certain count, for example if you set the value to 10 then whenever you send more than 10 messages at a time then system will automatically queue the message and start processing as per the delay between the message you configured
Delay b/w Messages
This is the value used to process messages from the queue , i.e if you set to 10 seconds then the system will wait 10 seconds to send next message in the queue, the recommended delay between messages is 10 seconds in order to avoid blocking of WhatsApp number.
Sync Messages From Connected Phone
When this is enabled the system will track and sync all messages which are manually sent from the connected phone. Please note only text will sync correctly for images and videos only thumbnails will sync
Send Sync Message Out to Webhooks
This is only for developers who would like to get the messages which are sent manually from the phone, you will get an additional variable "direction"
Download Incoming Video
If you would like to download the video files then please enable this, enabling this will slow down the regular message sending and receiving speed of your Server.
If you are facing any issues then please contact us through live chat or by sending an email to [email protected]

Server Restart & App Restart

Don't get confused with Server Restart & App Restart both works differently, so let's understand the difference before using the commands.
Restart App : This is the automation app that runs in the WhatsApp Server, mostly Restart app solves the issues like QR code Not Showing, Connection Timeout, Low message sending speed etc
Server Restart : This is the dedicated server allocated to your project to connect WhatsApp Numbers, generally server restart is not required until suggested by our support team. Server restart will take 5 to 10 minutes so once the command is given please wait for 10 minutes to perform next action.
Use the Server Restart & App Restart only and when required as mentioned above.

Disconnecting & Connecting Another Number

If you wish to disconnect the existing number and connect another number then please follow the below guide;
First click on "Disconnect" as shown below
This will prompt a new confirmation popup as below;
If you wish to delete all the queue and message history from the WhatsApp Server then please check the "Clear Queue & Messages" , still you will have the message history in the Picky Assist Account, the message history will get deleted only from WhatsApp Server.
In case you want to disconnect and connect again with the same or different number and process the pending queue then please uncheck this option, when a new/same number is connected the pending queue messages will get processed.
After clicking on the "Continue" button it may take 1-2 minutes to show another QR code, please refresh the page to see the new QR Code.

Number Disconnected from WhatsApp App

If the number is forcefully disconnected from the WhatsApp App then you may not see the option to disconnect instead it will show a box as below;
If you are seeing this option then please click on "Restart App" then you will able to see below options'
If you tick "Disconnect Existing Number & Restart" this will destroy the last connected number session and you need to scan the QR code again to repair the number.
If you tick "Clear Queue & Messages" this will destroy all the queue and message history from the WhatsApp Server
Even after restarting the app if you are unable to connect or see the QR code to scan then please repeat the restart process again.

API Customers

Those who are using API or Zoho CRM Workflow then please use application=10 in the API & Webhooks in order to send and receive messages from WhatsApp Web

Enabling / Disabling WhatsApp Groups

You can enable processing messages from WhatsApp Groups by clicking the respective settings to turn on or off as shown below;
Please note currently WhatsApp Group is available only for customers who are using our API Services. If you have too many active WhatsApp Group's then it may drastically slow down your regular WhatsApp Sending & Receiving Speed

Monitoring Disconnection Events & Alerting

This feature helps you to get alert when the WhatsApp number is disconnected or difficult to connect with our Server

This tool may not work with customers who are using Multi Device feature of WhatsApp, Please Use New Monitoring Tool​

To make this feature works more accurately you need to enable the "Keep Online" status on , when you turned this on your connected WhatsApp number will show always Online
Following types of alerts you will get;
Manual Disconnection : When the WhatsApp Web is manually disconnected from the phone i.e User go to the WhatsApp Web Menu and tapping "Logout from All Devices" in this case you will get real-time alert
Internet Disconnection : This mostly happens when the phone having internet issues and as a result, WhatsApp Web stops working, this event is not realtime , it may take upto 10 minutes to get the alert if the phone lost the internet connection or phone is not online.
You can add email address to get alerts in the below shown field;
This feature is currently in beta and not tested widely, by default this setting is off, if you are facing any issues then please email [email protected]

Monitoring Tool for WhatsApp Multi Device

As per our research we have observed that in the new WhatsApp Multi Device once a device is connected it won't get disconnected even if the phone is offline so the current Picky Assist monitoring tool may not work effectively as WhatsAp Web is always in connected state and it's connected directly to the WhatsApp Server not to the mobile phone.
Further we have also observed that WhatsApp Web new version keep crashing (Bug in WhatsApp) and as a result WhatsApp fails to send or receive messages even the connection shows as "Connected"
As we are always committed to provide the best possible services and give maximum uptime to the WhatsApp Web Automation services we have developed a new monitoring tool which will send an automated message "status_check" to our dedicated WhatsApp number "+13024370557" in every 5 minutes from your Connected WhatsApp Number.
If your WhatsApp automation server is connected to a WhatsApp number and we have not received "status_check" in the last 5 minutes then we can consider there must be a problem in the Connection.
In order to avoid any confusion of sending any automatic message by default this monitoring tool is disabled in your account, we request you to please enable this from your Settings -> Channels -> WhatsApp Web Automation -> Service Monitoring Tool (enable this) as shown in the below image;
Once you enabled this monitoring tool we will able to analyse the disconnection event and create the best technology to solve it in the coming days, we are considering below ideas;
  1. 1.
    Automatically restart the automation app as in most cases we observed that the automation app restart solves the problem related to Connection issues.
  2. 2.
    Inform you through Email for manual actions
  3. 3.
    Automatically reset the automation server if the app restart does not solves the issue then send an email to you so that you can scan the QR code again to establish the connection.
  4. 4.
    If 1,2,3 steps fails then automatically create a ticket with our support team for further investigations without your intervention.
Kindly note that the above actions are not yet implemented, we will monitor the situation based on how the new monitoring tool works and after few weeks we will implement the above proposed automation flow to handle it more effectively, we can only do this research if you enable the new monitoring tools which sends an automated message in every 5 minutes to our WhatsApp number.

Most Common Problems & Solutions

This is the list of most common problems and it's solutions, if the issue facing by you is not listed there then please feel free to contact us by sending an email to [email protected]

Status Showing as Connected but Incoming or Outgoing Message not working

This is the issue start observing from Feb 2022 onwards after WhatsApp released a major update to support it's new feature "MultiDevice" please follow below troubleshooting method to fix the issue;
  1. 1.
    Update WhatsApp Mobile App to the Latest Version from Google Play Store
  2. 2.
    Then join Multi Device feature in beta if showing in your phone under "Linked Device" Read More​
  3. 3.
    Go to Picky Assist Account Settings -> WhatsApp Web Automation -> Click on WhatsApp Icon -> Click on Restart App
  4. 4.
    Please wait for 2 minutes then refresh the Picky Assist page and try sending an incoming or outgoing message to check its working or not.
If the above step don't solve the issue then please an email to [email protected] mentioning your project name in which you are facing the problem to troubleshoot further

Getting Error "Couldn't scan code. Make sure you're on and scan again" after scanning the QR Code

This error could be because the QR code is expired, you can simply click on the Restart button to generate a new QR Code, please make sure you are scanning directly from the phone to the QR Code, taking a screenshot of the QR code and sharing won't work since the QR code keeps changing in every 10 seconds.
From February 2022 onwards we have observed that WhatsApp Web feature is not available to certain Phone Model & OS Versions mostly old devices and outdated phone software version, to check and confirm this please open in a computer browser then try to link your phone by scanning the QR code, if this shows any error it means the WhatsApp Web feature is not available to the phone.

Even after restarting the App if the issue is not getting solved then please contact us [email protected]

Showing Connection Status as "Timeout" Incoming and outgoing messages are not processing.

The timeout status means we are unable to communicate with your phone, make sure the phone is connected to the internet and the phone is switched on, if the phone is connected to the internet then please do any of the following actions
  1. 1.
    Restart the phone network sometimes solves the issues like Turn off the Wifi or Mobile data and on again or Switching to flight mode and turn back.
  2. 2.
    Disable all power saving modes in your phone as sometimes if the power saving mode is enabled phone restricts background usage of data and as a result the WhatsApp will work, so highly recommend disabling power saving mode in your phone
  3. 3.
    Close WhatsApp from the background and open it again
  4. 4.
    Restart the Phone

Incoming & Outgoing Messages are not processing

👉 The very first thing here is to check your phone internet connection and make sure the phone is turned on and connected to the internet, please send a WhatsApp message to your connected number and ensures it's showing in your phone.
👉 Please check the Connection Status from the Picky Assist Web Console -> Settings -> Channels -> WhatsApp Web Automation -> Settings
👉 If the connection status is other than "Connected" then please click on the "Restart App" please wait 5-10 seconds after Restart the refresh the Connection status by clicking the refresh icon. Even after the connection is not established then please click on the "Disconnect" and try to pair your WhatsApp again by scanning the QR Code.
👉 Always makes sure the WhatsApp Web is not paired in any other computer, in case you have paired then please go to WhatsApp & Click on WhatsApp Web then tap on "Log out from all devices" after that pair your number again with us. - Not Applicable if you are using Multi Device Feature

Taking a longer time to Connect WhatsApp Web, frequent disconnection & Incoming Message Missing

The issue could be occurring for any of the below mentioned cases;
In order to solve this issue let's understand a few things;
WhatsApp Web is connected with your phone directly , i.e the incoming messages first comes to your phone then sync with the WhatsApp Web similarly the outgoing messages sent from the WhatsApp Web comes to the phone to send them out, so without the mobile phone the incoming or outgoing messages won't be processed.

1. Unstable Internet Connection

The very first thing you need to check whether the phone is connected to Internet or not and please run a speed test as well, make sure you have both download and upload speed showing. Not Applicable if you are using Multi Device Feature

2. Phone Battery / Power Saving Mode enabled

Almost all phones by default have Power Saving Mode or Battery Saving mode enabled or automatically enable when your battery percentage goes below certain limit, the best ways is to disable all phone battery/power saving mode in your phone and make sure that your phone don't restrict background data usage of WhatsApp.
If the phone is automatically put app into sleep then opening WhatsApp App may restore the Internet connection to WhatsApp App. Not Applicable if you are using Multi Device Feature

3. More than 1000 Open Chats or too many WA Groups

WhatsApp saves all your incoming and outgoing messages in your mobile phone storage and when you connect the WhatsApp Web the open chat details and history will be synched from your Phone to the connected computer and further it saves in the computer / browser cache, so here if you have a lot of open chats and groups it may take longer time to complete the sync and sometimes your phone becomes unresponsive during this process, the syncing speed depends based on your phone configuration and internet upload speed. By keeping these things in mind we suggest the following maintenance for your phone and WhatsApp App to operate smoothly with Whatsapp Web.

Finding Open Chat Counts

Open the WhatsApp App then select a contact and then from the 3 dotted menu click on "Select All" and you able to see the total open chat count as shown below;

Deleting One by One

Open the WhatsApp App select one contact and delete it

Deleting Multiple Selected Chats

Open the WhatsApp App then long press on the contact and mark multiples to then tap on Delete as shown below
When using Select All if any groups are in the chat window then the delete option will not display, so manually find the groups and unselect those to get the delete button visible as shown above.

Delete All Chats

This is the recommended method , open the WhatsApp click tine 3 doted -> Settings -> Chats -> Chat History -> Delete All chats as shown below;
Please note Archive Chats will not help.

Experimental Scalability Option

We have an experimental feature of upgrading your existing WhatsApp Server configuration to a higher spec which may help to minimize the disconnection frequency and reconnect faster after disconnection, in order to do this option your phone should also be upgraded apart from the servers since the phone is primarily responsible for synching the messages and when the phone becomes unresponsive the WhatsApp Web get disconnects. Please note this is an experimental feature and we don't guarantee whether this approach works with your setup and this will cost you $49 extra per month.for each 10k open chats and when your open chat increases you need to upgrade again your phone and servers , you can consider 10k open chats costs you $49 per month (We provide free 7 days trial to check whether this upgrade works for you or not)