Developer Platform

Build with the WhatsPing API

Send messages, manage contacts and groups, create templates, run campaigns and read your WhatsApp account health — all over a simple REST API on top of the official WhatsApp Cloud API.

AMSR
Token-based auth · JSON over HTTPS · works from any language
# Send a WhatsApp message to a phone number
curl -X POST https://app.whatsping.com/api/wpbox/sendMessageToPhoneNumber \
  -H "Content-Type: application/json" \
  -d '{
    "token":   "YOUR_API_TOKEN",
    "phone":   "8801712345678",
    "message": "Hello from WhatsPing 🚀"
  }'
Response { "status": "success" } Don't have a key yet? Get one →
What you can build

Everything the API gives you

💬

Messaging

Send text, media, interactive and template messages to any number.

7 endpoints →
👥

Contacts

Create, read, update and delete contacts; toggle the AI bot per contact.

6 endpoints →
🗂️

Groups

Organize contacts into groups you can target in campaigns.

4 endpoints →
📋

টেমপ্লেট

List, create and submit WhatsApp templates and upload header media.

4 endpoints →
📣

Campaigns

List campaigns and trigger campaign messages to a phone number.

2 endpoints →

Automated replies

Manage keyword auto-replies — exact match, contains and welcome.

4 endpoints →
📊

Account status

Read connection state, quality rating and messaging tier.

2 endpoints →
🔗

Inbound webhook

Receive messages and status updates from the WhatsApp Cloud API.

See webhooks →

Quick start

  • 1
    Create an account

    Sign up free and connect your WhatsApp number with embedded signup.

  • 2
    Generate an API token

    Create a personal access token from your dashboard settings.

  • 3
    Make your first request

    Call /sendMessageToPhoneNumber with your token.

অথেনটিকেশন

Every request is authenticated with your API token. Pass it as token — a query parameter for GET requests, or a field in the JSON body for POST/PUT/DELETE.

token = YOUR_API_TOKEN

Tokens are scoped to your organization. Keep them secret — never expose a token in client-side code. An invalid token returns { "status": "error" }.

Response format

All responses are JSON with a status field of success or error.

// success { "status": "success", "contacts": [ ... ] } // error { "status": "error", "message": "Invalid token" }
Reference

API endpoints

All paths are relative to https://app.whatsping.com/api/wpbox. Every request needs your token.

POST
/sendMessageToPhoneNumber
Send a text, media or interactive (buttons) message. Params: phone, message, optional header, footer, buttons, image.
POST
/sendtemplatemessage
Send an approved template. Params: phone, template_name, template_language, components.
POST
/sendmedia
Send a media message (image, document or video) to a phone number.
POST
/sendCampaignMessageToPhoneNumber
Trigger a campaign's message to a number. Params: phone, campaing_id, data.
GET
/getConversations
List recent conversations for your organization.
GET
/getMessages
List the latest messages for a contact. Param: contact_id.
GET
/getMessageStatus
Get the delivery status of a message. Param: message_id.
GET
/getContacts
List all contacts in your organization.
GET
/getSingleContact
Fetch one contact by contact_id or phone.
POST
/makeContact
Create or update a contact. Params: name, phone, optional email, groups, custom.
POST/PUT
/updateContact
Update a contact's name, phone, email, language or subscription. Param: id.
DELETE
/deleteContact
Delete a contact by id.
POST
/updateAIBot
Enable or disable the AI bot for a specific contact.
GET
/getGroups
List contact groups. Optional showContacts=yes to include members.
POST
/addGroup
Create a new contact group.
PUT
/updateGroup
Rename or update a group.
DELETE
/deleteGroup
Delete a group.
GET
/getTemplates
List your WhatsApp message templates and their approval status.
POST
/createTemplate
Create a template and submit it to Meta for approval.
POST
/uploadTemplateMedia
Upload an image, video or PDF header for a template.
POST/DELETE
/deleteTemplate
Delete a template.
GET
/getCampaigns
List campaigns. Optional type = bot, api or regular.
POST
/sendcampaigns
Send a campaign message to a phone number.
GET
/getAutomatedReplies
List keyword auto-replies (exact match, contains, welcome).
POST
/addAutomatedReply
Create a keyword auto-reply.
PUT
/updateAutomatedReply
Update an existing auto-reply.
DELETE
/deleteAutomatedReply
Delete an auto-reply.
GET
/me
Return the authenticated account for the token.
GET
/accountStatus
WhatsApp connection state, account status, phone quality rating and messaging tier.
Real-time inbound

ওয়েবহুক

WhatsPing exposes a webhook that the WhatsApp Cloud API calls whenever a customer messages your number or a message's status changes. You set this URL in Meta once during setup — WhatsPing verifies it and routes every event into your inbox, bots and flows.

How inbound events flow

WhatsAppCustomer messages
your number
🔗
WhatsPing
webhook
💬
Inbox · bots ·
flows

Events delivered by Meta include inbound messages (text, media, interactive replies) and message status updates (sent, delivered, read, failed) — WhatsPing processes them automatically, triggering keyword replies, flows and AI.

Webhook endpoints

GET
/webhook/wpbox/receive/{token}
Verification handshake — Meta calls this once to confirm the URL.
POST
/webhook/wpbox/receive/{token}
Receives inbound messages and status updates from the Cloud API.

The {token} in the URL is unique to your organization, so events are always attributed to the right account.

Fair use

Plan limits

API usage counts against your plan's monthly quotas — the same limits that apply across the app. Upgrade any time for more headroom.

ResourceFree 30 DaysStandardPremium
Messages / month100UnlimitedUnlimited
Campaigns / month2100500
Contacts100UnlimitedUnlimited
Agents / organization110Unlimited

Exceeding a quota returns { "status": "error", "message": "You have exceeded the limit …" } — no partial sends.

Ready to build something amazing?

Generate a token and send your first WhatsApp message in minutes.

নোটিফিকেশন চালু করুন ঠিক আছে না, ধন্যবাদ