API Documentation

GoWAPI WhatsApp API

Best WhatsApp API for Developers and Automators. Build powerful WhatsApp integrations with our easy-to-use REST API.

Using Proxies

Getting Started

Learn how to configure proxies for your WhatsApp sessions to prevent frequent disconnects and ensure fast, reliable message delivery. SOCKS5 is highly recommended.

Configuring Proxies for WhatsApp Sessions

Using a proxy helps mask our server's IP address and routes your session's traffic through a dedicated IP, which helps with connection stability. Proxies can be configured individually per session. Supported Protocols: We support http://, https://, and socks5:// proxies, but SOCKS5 is highly recommended for the best performance and seamless compatibility with WhatsApp.

Best Practices & Recommendations

To ensure your sessions remain stable, please follow these guidelines when selecting a proxy:

Location Matching: Always use a proxy located in the same country as the phone number registered to the WhatsApp session.
Sticky IPs: Use a sticky proxy (an IP that remains the same for a prolonged period) rather than a frequently rotating proxy.
Speed is Key: Ensure your proxy is fast and has low latency. Slow proxies will cause connection timeouts and lead to session_not_ready errors.

Recommended Provider: If you are looking for fast, reliable, and sticky SOCKS5 proxies that work perfectly with our system, we highly recommend GeoNode.

(Disclaimer: This is an official link. Using it helps support our platform at no extra cost to you)

Configuration via Dashboard

You can easily assign a proxy to a session without writing any code:

Navigate to your dashboard and go to Sessions.
Click Edit Session on the session you want to modify.
Locate the Proxy URL field.
Enter your proxy string (e.g. socks5://username:password@ip:port) and save.

Configuration via API

You can also programmatically update a session's proxy using our REST API.

Authentication Note: Because updating a session's core configuration is an account-level action, you must authenticate this request using your Personal Access Token (found in your profile settings), not the Session API Key.

Make a PUT request to the session endpoint with your proxy URL (example below):

Code Examples

Bash

curl -X PUT "https://www.gowapi.com/api/whatsapp-sessions/{whatsappSession}" \
  -H "Authorization: Bearer YOUR_PERSONAL_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "proxy_url": "socks5://username:password@ip:port"
  }'