Nombor

Nombor ialah nombor WhatsApp atau akaun Telegram yang disambungkan ke ruang kerja anda. id-nya ialah from yang anda gunakan untuk menghantar mesej. Dengan API v2, anda boleh menyenaraikannya, melihat sama ada setiap satu disambungkan, dan menyambungkan nombor WhatsApp dari aplikasi anda sendiri, dengan kod QR atau kod pautan.

Kunci yang dihadkan kepada sebahagian nombor hanya melihat dan menyambungkan semula nombor itu, dan tidak boleh menambah nombor.

Senaraikan nombor#

Semua nombor ruang kerja, yang tertua dahulu, dalam satu senarai data (tanpa halaman).

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

import os
import requests

response = requests.get(
    "https://wbiztool.com/api/v2/numbers",
    headers={"Authorization": f"Bearer {os.environ['WBIZTOOL_API_KEY']}"},
    timeout=30,
)
for number in response.json()["data"]:
    print(number["id"], number["phone"], number["label"], number["status"])

// Node.js 18+ (built-in fetch). Save as .mjs to use top-level await.
const response = await fetch("https://wbiztool.com/api/v2/numbers", {
  headers: { Authorization: `Bearer ${process.env.WBIZTOOL_API_KEY}` },
});
const { data } = await response.json();
for (const number of data) console.log(number.id, number.phone, number.label, number.status);

<?php
$ch = curl_init('https://wbiztool.com/api/v2/numbers');
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer ' . getenv('WBIZTOOL_API_KEY')],
    CURLOPT_RETURNTRANSFER => true,
]);
$numbers = json_decode(curl_exec($ch), true)['data'];
curl_close($ch);
foreach ($numbers as $number) {
    echo $number['id'] . ' ' . $number['phone'] . ' ' . $number['status'] . "\n";
}

{
  "data": [
    {
      "id": 101,
      "phone": "919800000000",
      "label": "Shop",
      "platform": "whatsapp",
      "status": "connected",
      "login_method": "qr",
      "connect": null
    },
    {
      "id": 102,
      "phone": null,
      "label": "",
      "platform": "whatsapp",
      "status": "disconnected",
      "login_method": "qr",
      "connect": null
    }
  ]
}

connect sentiasa null dalam senarai. Untuk mengikuti sambungan, dapatkan nombor itu.

Dapatkan nombor#

Satu nombor. Semasa ia sedang disambungkan, connect mengandungi kod QR untuk diimbas atau kod pautan untuk ditaip.

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

{
  "id": 102,
  "phone": null,
  "label": "",
  "platform": "whatsapp",
  "status": "connecting",
  "login_method": "qr",
  "connect": {
    "qr_code_url": "https://…/qr_codes/…png?X-Amz-Signature=…",
    "pairing_code": null,
    "pairing_code_expires_at": null,
    "linking": false,
    "requested_at": "2026-10-18T11:02:15.402Z"
  }
}

Nombor yang tidak wujud, atau yang tidak boleh digunakan oleh kunci, menjawab 404 number_not_found.

Objek Number#

connect mengandungi:

Mesej yang dihantar dengan nombor disconnected sebagai from masih diterima: ia menunggu dan dihantar apabila nombor disambungkan semula. Peristiwa webhook untuk nombor akan datang kemudian; sehingga itu, tinjau GET /numbers untuk mengesan nombor yang telah log keluar.

Sambungkan nombor WhatsApp#

Meminta pelayan WbizTool membuka WhatsApp untuk sesuatu nombor, supaya anda boleh memautkannya dari aplikasi atau laman web anda sendiri, seperti di halaman Nombor WhatsApp. Responsnya ialah 202 dengan Number, berstatus connecting. Kemudian tinjau ia sehingga ia connected.

Ia memerlukan pelan yang merangkumi API kod QR; jika tidak, ia menjawab 403 plan_required. Akaun Telegram disambungkan dalam papan pemuka, bukan di sini.

# By QR code
curl -X POST https://wbiztool.com/api/v2/numbers \
  -H "Authorization: Bearer $WBIZTOOL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"login_method": "qr"}'

# By pairing code, reconnecting number 101
curl -X POST https://wbiztool.com/api/v2/numbers \
  -H "Authorization: Bearer $WBIZTOOL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"login_method": "phone_code", "phone": "+919876543210", "number_id": 101}'

import os
import time
import requests

API = "https://wbiztool.com/api/v2"
headers = {"Authorization": f"Bearer {os.environ['WBIZTOOL_API_KEY']}"}

number = requests.post(f"{API}/numbers", headers=headers,
                       json={"login_method": "phone_code", "phone": "+919876543210"}, timeout=30).json()

shown = None
while number["status"] == "connecting":
    time.sleep(3)
    number = requests.get(f"{API}/numbers/{number['id']}", headers=headers, timeout=30).json()
    code = (number["connect"] or {}).get("pairing_code")
    if code and code != shown:
        print("On the phone: WhatsApp → Linked devices → Link with phone number, then type", code)
        shown = code

print("Number", number["id"], "is", number["status"])

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

let number = await (await fetch(`${API}/numbers`, {
  method: "POST", headers, body: JSON.stringify({ login_method: "qr" }),
})).json();

let shown = null;
while (number.status === "connecting") {
  await new Promise((r) => setTimeout(r, 3000));
  number = await (await fetch(`${API}/numbers/${number.id}`, { headers })).json();
  const qr = number.connect?.qr_code_url;
  if (qr && qr !== shown) {
    console.log("Show this QR code to scan:", qr); // e.g. in an <img> on your page
    shown = qr;
  }
}
console.log(`Number ${number.id} is ${number.status}`);

<?php
$ch = curl_init('https://wbiztool.com/api/v2/numbers');
curl_setopt_array($ch, [
    CURLOPT_POST           => true,
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer ' . getenv('WBIZTOOL_API_KEY'), 'Content-Type: application/json'],
    CURLOPT_POSTFIELDS     => json_encode(['login_method' => 'qr']),
    CURLOPT_RETURNTRANSFER => true,
]);
$number = json_decode(curl_exec($ch), true);
curl_close($ch);
// Save $number['id'], then poll GET /api/v2/numbers/{id} every few seconds (see The connect flow).
echo $number['id'] . ' ' . $number['status'];

Aliran sambungan#

1. Minta sambungan

   POST /numbers dengan login_method (dan phone untuk kod pautan). Simpan id daripada respons. Hantar Idempotency-Key supaya cubaan semula tidak meminta dua kali.

2. Tinjau nombor setiap beberapa saat

   GET /numbers/{id} setiap 2 hingga 5 saat semasa status ialah connecting. Kod QR atau kod pautan muncul dalam connect dalam beberapa saat; sehingga itu medannya ialah null.

3. Paparkan kod QR atau kod pautan

   QR: paparkan imej di connect.qr_code_url; pada telefon, buka WhatsApp → Peranti dipaut → Paut peranti dan imbasnya. Setiap pautan berfungsi selama 10 minit dan pautan baharu datang dengan setiap tinjauan, jadi paparkan yang terbaharu setiap kali. Kod pautan: pada telefon, buka WhatsApp → Peranti dipaut → Paut peranti → Paut dengan nombor telefon, dan taip connect.pairing_code 8 aksara sebelum connect.pairing_code_expires_at (kira-kira 3 minit).

4. Tunggu sehingga disambungkan

   Selepas imbasan atau kod, connect.linking ialah true semasa WhatsApp menyelesaikan pemautan. Kemudian status menjadi connected dan phone menunjukkan nombor itu. Berhenti meninjau.

Jika tiada apa-apa berlaku selama 10 minit, percubaan itu tamat dan status kembali kepada disconnected. Minta semula dengan POST /numbers dan number_id-nya.

Semasa sesuatu nombor sedang disambungkan, permintaan lain untuknya menjawab 409 connect_in_progress dengan number_id-nya: teruskan meninjau nombor itu sebaliknya.

Ralat semasa menyambung#

Berkaitan#

• Sambung nombor WhatsApp anda dalam papan pemuka
• Sambung akaun Telegram
• Mesej: hantar dari sesuatu nombor dengan from
• Ralat