For the complete documentation index, see llms.txt. This page is also available as Markdown.

Default and Regional Proxies

Default Proxy for Your Channel

Each WhatsApp channel automatically connects to WhatsApp through a proxy—no configuration required. By default, this is Whapi own standard proxy, hosted on servers in Europe.

We don't display the exact IP address of this proxy anywhere in the control panel or API—it's taken from a shared internal pool.

After being blocked, you should change the proxy address for the channel so that a new connected number doesn't use the IP address WhatsApp has already associated with the blocked session. Partners can do this instantly and independently—either using the "Change Proxy" button in the partner control panel or via the "Change Proxy Channel" API method.

In either case, a new proxy will be selected automatically from the pool, but we won't return information about the assigned IP address.

Regional Proxies

Partners can assign a proxy server located in a specific region to their clients' channels, instead of the standard Whapi proxy (hosted on our servers in Europe). Matching the proxy server's region to the account's actual location reduces the likelihood of session drops and reduces WhatsApp's mistrust of the connection—this is especially important for newly registered numbers.

It's free.

How it works:

  1. Get the list of available regional proxies via the Partner API — Get proxies (regional). Each entry includes an id, country, region, and usage (current load, %).

  2. Assign a proxy to the channel via Set channel proxy (regional), passing the channel ID and the chosen proxy ID.

Part of the response to a proxy list request
{
"proxies": [
{
"id": 3,
"country": "SouthAfrica-1",
"region": "Africa",
"usage": 1.8
},
{
"id": 4,
"country": "India",
"region": "Asia",
"usage": 1
}

We recommend setting the proxy before the WhatsApp account is linked to the channel, so the session starts in the correct region from the beginning.

Last updated