Messages

curl -X POST https://wbiztool.com/api/v2/messages \
  -H "Authorization: Bearer $WBIZTOOL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: order-1042-ready" \
  -d '{
    "from": 101,
    "to": { "phone": "+919876543210" },
    "text": "Hi Asha, your order #1042 is ready."
  }'

import os
import requests

response = requests.post(
    "https://wbiztool.com/api/v2/messages",
    headers={
        "Authorization": f"Bearer {os.environ['WBIZTOOL_API_KEY']}",
        "Idempotency-Key": "order-1042-ready",
    },
    json={
        "from": 101,
        "to": {"phone": "+919876543210"},
        "text": "Hi Asha, your order #1042 is ready.",
    },
    timeout=30,
)
body = response.json()

if response.status_code == 202:
    print("Queued:", body["id"], body["status"])
else:
    print("Refused:", body["error"]["code"], body["error"]["message"])

// Node.js 18+ (built-in fetch). Save as .mjs to use top-level await.
const response = await fetch("https://wbiztool.com/api/v2/messages", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.WBIZTOOL_API_KEY}`,
    "Content-Type": "application/json",
    "Idempotency-Key": "order-1042-ready",
  },
  body: JSON.stringify({
    from: 101,
    to: { phone: "+919876543210" },
    text: "Hi Asha, your order #1042 is ready.",
  }),
});
const body = await response.json();

if (response.status === 202) {
  console.log("Queued:", body.id, body.status);
} else {
  console.error("Refused:", body.error.code, body.error.message);
}

<?php
$ch = curl_init('https://wbiztool.com/api/v2/messages');
curl_setopt_array($ch, [
    CURLOPT_POST           => true,
    CURLOPT_HTTPHEADER     => [
        'Authorization: Bearer ' . getenv('WBIZTOOL_API_KEY'),
        'Content-Type: application/json',
        'Idempotency-Key: order-1042-ready',
    ],
    CURLOPT_POSTFIELDS     => json_encode([
        'from' => 101,
        'to'   => ['phone' => '+919876543210'],
        'text' => 'Hi Asha, your order #1042 is ready.',
    ]),
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT        => 30,
]);
$body = json_decode(curl_exec($ch), true);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($status === 202) {
    echo 'Queued: ' . $body['id'] . ' ' . $body['status'];
} else {
    echo 'Refused: ' . $body['error']['code'] . ' ' . $body['error']['message'];
}

curl -X POST https://wbiztool.com/api/v2/messages/batch \
  -H "Authorization: Bearer $WBIZTOOL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: opening-hours-2026-10-20" \
  -d '{
    "from": 101,
    "to": [
      { "phone": "+919876543210" },
      { "phone": "+447700900123" },
      { "group": "Bakery staff" }
    ],
    "text": "We open at 10 tomorrow."
  }'

import os
import requests

recipients = ["+919876543210", "+447700900123"]

response = requests.post(
    "https://wbiztool.com/api/v2/messages/batch",
    headers={
        "Authorization": f"Bearer {os.environ['WBIZTOOL_API_KEY']}",
        "Idempotency-Key": "opening-hours-2026-10-20",
    },
    json={
        "from": 101,
        "to": [{"phone": p} for p in recipients] + [{"group": "Bakery staff"}],
        "text": "We open at 10 tomorrow.",
    },
    timeout=60,
)
body = response.json()

if response.status_code == 202:
    for message in body["data"]:
        print(message["id"], message["to"], message["status"])
else:
    print("Refused:", body["error"]["code"], body["error"]["field"], body["error"]["message"])

// Node.js 18+ (built-in fetch). Save as .mjs to use top-level await.
const recipients = ["+919876543210", "+447700900123"];

const response = await fetch("https://wbiztool.com/api/v2/messages/batch", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.WBIZTOOL_API_KEY}`,
    "Content-Type": "application/json",
    "Idempotency-Key": "opening-hours-2026-10-20",
  },
  body: JSON.stringify({
    from: 101,
    to: [...recipients.map((phone) => ({ phone })), { group: "Bakery staff" }],
    text: "We open at 10 tomorrow.",
  }),
});
const body = await response.json();

if (response.status === 202) {
  for (const message of body.data) console.log(message.id, message.to, message.status);
} else {
  console.error("Refused:", body.error.code, body.error.field, body.error.message);
}

<?php
$recipients = ['+919876543210', '+447700900123'];
$to = array_map(fn ($phone) => ['phone' => $phone], $recipients);
$to[] = ['group' => 'Bakery staff'];

$ch = curl_init('https://wbiztool.com/api/v2/messages/batch');
curl_setopt_array($ch, [
    CURLOPT_POST           => true,
    CURLOPT_HTTPHEADER     => [
        'Authorization: Bearer ' . getenv('WBIZTOOL_API_KEY'),
        'Content-Type: application/json',
        'Idempotency-Key: opening-hours-2026-10-20',
    ],
    CURLOPT_POSTFIELDS     => json_encode(['from' => 101, 'to' => $to, 'text' => 'We open at 10 tomorrow.']),
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT        => 60,
]);
$body = json_decode(curl_exec($ch), true);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($status === 202) {
    foreach ($body['data'] as $message) {
        echo $message['id'] . ' ' . $message['status'] . "\n";
    }
} else {
    echo 'Refused: ' . $body['error']['code'] . ' ' . $body['error']['field'];
}

curl -G https://wbiztool.com/api/v2/messages \
  -H "Authorization: Bearer $WBIZTOOL_API_KEY" \
  --data-urlencode "status=failed" \
  --data-urlencode "since=2026-10-01T00:00:00+05:30" \
  --data-urlencode "limit=100"

import os
import requests

headers = {"Authorization": f"Bearer {os.environ['WBIZTOOL_API_KEY']}"}
params = {"status": "failed", "since": "2026-10-01T00:00:00+05:30", "limit": 100}
failed = []

while True:
    page = requests.get("https://wbiztool.com/api/v2/messages",
                        headers=headers, params=params, timeout=30).json()
    failed += page["data"]
    if not page["next_cursor"]:
        break
    params["cursor"] = page["next_cursor"]  # same filters, next page

for message in failed:
    print(message["id"], message["to"], message["error"]["message"])

// Node.js 18+ (built-in fetch). Save as .mjs to use top-level await.
const params = new URLSearchParams({ status: "failed", since: "2026-10-01T00:00:00+05:30", limit: "100" });
const failed = [];

while (true) {
  const response = await fetch(`https://wbiztool.com/api/v2/messages?${params}`, {
    headers: { Authorization: `Bearer ${process.env.WBIZTOOL_API_KEY}` },
  });
  const page = await response.json();
  failed.push(...page.data);
  if (!page.next_cursor) break;
  params.set("cursor", page.next_cursor); // same filters, next page
}

for (const message of failed) console.log(message.id, message.to, message.error.message);

<?php
$params = ['status' => 'failed', 'since' => '2026-10-01T00:00:00+05:30', 'limit' => 100];
$failed = [];

do {
    $ch = curl_init('https://wbiztool.com/api/v2/messages?' . http_build_query($params));
    curl_setopt_array($ch, [
        CURLOPT_HTTPHEADER     => ['Authorization: Bearer ' . getenv('WBIZTOOL_API_KEY')],
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_TIMEOUT        => 30,
    ]);
    $page = json_decode(curl_exec($ch), true);
    curl_close($ch);
    $failed = array_merge($failed, $page['data']);
    $params['cursor'] = $page['next_cursor']; // same filters, next page
} while ($page['next_cursor']);

foreach ($failed as $message) {
    echo $message['id'] . ' ' . $message['error']['message'] . "\n";
}

curl https://wbiztool.com/api/v2/messages/9817263 \
  -H "Authorization: Bearer $WBIZTOOL_API_KEY"

import os
import requests

response = requests.get(
    "https://wbiztool.com/api/v2/messages/9817263",
    headers={"Authorization": f"Bearer {os.environ['WBIZTOOL_API_KEY']}"},
    timeout=30,
)
message = response.json()
print(message["status"], message["sent_at"])

// Node.js 18+ (built-in fetch). Save as .mjs to use top-level await.
const response = await fetch("https://wbiztool.com/api/v2/messages/9817263", {
  headers: { Authorization: `Bearer ${process.env.WBIZTOOL_API_KEY}` },
});
const message = await response.json();
console.log(message.status, message.sent_at);

<?php
$ch = curl_init('https://wbiztool.com/api/v2/messages/9817263');
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer ' . getenv('WBIZTOOL_API_KEY')],
    CURLOPT_RETURNTRANSFER => true,
]);
$message = json_decode(curl_exec($ch), true);
curl_close($ch);
echo $message['status'];

curl -X DELETE https://wbiztool.com/api/v2/messages/9817263 \
  -H "Authorization: Bearer $WBIZTOOL_API_KEY"

import os
import requests

response = requests.delete(
    "https://wbiztool.com/api/v2/messages/9817263",
    headers={"Authorization": f"Bearer {os.environ['WBIZTOOL_API_KEY']}"},
    timeout=30,
)
body = response.json()

if response.status_code == 200:
    print("Cancelled")
elif body["error"]["code"] == "not_cancellable":
    print("Too late, it is", body["error"]["status"])

// Node.js 18+ (built-in fetch). Save as .mjs to use top-level await.
const response = await fetch("https://wbiztool.com/api/v2/messages/9817263", {
  method: "DELETE",
  headers: { Authorization: `Bearer ${process.env.WBIZTOOL_API_KEY}` },
});
const body = await response.json();

if (response.ok) console.log("Cancelled");
else if (body.error.code === "not_cancellable") console.log("Too late, it is", body.error.status);

<?php
$ch = curl_init('https://wbiztool.com/api/v2/messages/9817263');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST  => 'DELETE',
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer ' . getenv('WBIZTOOL_API_KEY')],
    CURLOPT_RETURNTRANSFER => true,
]);
$body = json_decode(curl_exec($ch), true);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
echo $status === 200 ? 'Cancelled' : $body['error']['code'];