Messages

Send to multiple numbers

Queue the same message to several phone numbers and group names given as one comma-separated phone string; one msg_id per recipient. The whole batch must fit in the number's daily fair-use room (and the free plan's messages) or nothing is created. Most errors come back with HTTP 200 and status: 0; a missing or non-numeric whatsapp_client, a non-string phone or a non-numeric msg_type returns an empty object {}. Images and files by URL only; group_name and expire_after_seconds are ignored. The JSON body is served with Content-Type: text/html; parse it as JSON whatever the header says.

post/send_msg/multi/

Request

  • Base URL: https://wbiztool.com/api/v1
  • URL: https://wbiztool.com/api/v1/send_msg/multi/
  • Auth: none required

Request body

client_idinteger required

Your API Client ID from Settings → API keys.

api_keystring required

One of your API keys from the same page. Keep it secret.

whatsapp_clientinteger required

ID of the WhatsApp number (or Telegram account) to send from, shown as "ID …" on the number's card on WhatsApp numbers in the dashboard.

phonestring required

Phone numbers and group names in one comma-separated string, e.g. 9876543210,9812345670,Sales Team Mumbai. Not a JSON array. Text with letters is treated as a group name; numbers that are too short/long are skipped.

msg_type0 | 1 | 2

0 text (default), 1 image, 2 file or document.

msgstring

Message text; required when msg_type is 0. For images and files it is the caption and can be empty. WhatsApp formatting works (*bold*, _italic_, ~strikethrough~). message is accepted as an alias.

img_urlstring uri

Public http/https URL of the image. Required when msg_type is 1 (and no file is uploaded).

file_urlstring uri

Public http/https URL the file can be downloaded from directly. Required when msg_type is 2 (and no file is uploaded).

file_namestring

File name the recipient sees, such as invoice-4821.pdf. Sent in lower case, characters such as & : ? * $ ; become _, cut to 150 characters. With msg_type 2, .pdf is added when the extension is missing or not supported.

webhookstring uri

Public URL that receives a form-encoded POST (msg_id, status) when the message is sent, fails, is cancelled or expires. See the messageStatus webhook.

Example request

{
  "client_id": 12345,
  "api_key": "YOUR_API_KEY",
  "whatsapp_client": 678
}

Response

Messages queued (status: 1), or the request failed (status: 0, or {}). Failure messages: Auth Error, Msg cant be null, Image Url Can't be null, File Url Can't be null, Not enough credits: … messages requested, … credits remaining, Daily limit reached: … (with code: daily_limit_reached), Invalid whatsapp client, No valid contacts found, Demo Account can not access apis, Invalid JSON format: ….

OR
OR
OR
object required

Empty object: failed.

Example response

{
  "message": "Successfully created 3 messages"
}

Changes

No recorded changes to this operation across all 1 revision of this API.