Nummern

Eine Nummer ist eine WhatsApp-Nummer oder ein Telegram-Konto, das mit Ihrem Arbeitsbereich verbunden ist. Ihre id ist das from, mit dem Sie Nachrichten senden. Mit der API v2 listen Sie sie auf, sehen, ob jede verbunden ist, und verbinden eine WhatsApp-Nummer aus Ihrer eigenen App, per QR-Code oder Kopplungscode.

Ein auf einige Nummern beschränkter Schlüssel sieht und verbindet nur diese neu und kann keine Nummer hinzufügen.

Nummern auflisten#

Alle Nummern des Arbeitsbereichs, die älteste zuerst, in einer einzigen data-Liste (ohne Seiten).

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 ist in der Liste immer null. Um eine Verbindung zu verfolgen, rufen Sie die Nummer ab.

Eine Nummer abrufen#

Eine einzelne Nummer. Während sie verbunden wird, enthält connect den QR-Code zum Scannen oder den Kopplungscode zum Eingeben.

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"
  }
}

Eine Nummer, die nicht existiert oder die der Schlüssel nicht nutzen darf, antwortet mit 404 number_not_found.

Das Number-Objekt#

connect enthält:

Nachrichten mit einer Nummer im Status disconnected als from werden trotzdem angenommen: Sie warten und gehen raus, sobald die Nummer wieder verbunden ist. Webhook-Ereignisse für Nummern folgen später; bis dahin fragen Sie GET /numbers regelmäßig ab, um eine abgemeldete Nummer zu bemerken.

WhatsApp-Nummer verbinden#

Bittet einen WbizTool-Server, WhatsApp für eine Nummer zu öffnen, damit Sie sie aus Ihrer eigenen App oder Website verknüpfen können, so wie unter WhatsApp-Nummern. Die Antwort ist 202 mit der Nummer im Status connecting. Fragen Sie sie dann regelmäßig ab, bis sie connected ist.

Dafür ist ein Plan nötig, der die QR-Code-API enthält; sonst lautet die Antwort 403 plan_required. Telegram-Konten werden im Dashboard verbunden, nicht hier.

# 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'];

Der Verbindungsablauf#

1. Verbindung anfordern

   POST /numbers mit login_method (und phone für einen Kopplungscode). Merken Sie sich die id aus der Antwort. Senden Sie einen Idempotency-Key, damit ein erneuter Versuch nicht doppelt anfordert.

2. Die Nummer alle paar Sekunden abfragen

   GET /numbers/{id} alle 2 bis 5 Sekunden, solange status connecting ist. Der QR-Code oder Kopplungscode erscheint innerhalb kurzer Zeit in connect; bis dahin sind seine Felder null.

3. QR-Code oder Kopplungscode anzeigen

   QR: Zeigen Sie das Bild unter connect.qr_code_url an; öffnen Sie auf dem Smartphone WhatsApp → Verknüpfte Geräte → Gerät hinzufügen und scannen Sie es. Jeder Link funktioniert 10 Minuten, und mit jeder Abfrage kommt ein neuer, zeigen Sie also jedes Mal den neuesten an. Kopplungscode: Öffnen Sie auf dem Smartphone WhatsApp → Verknüpfte Geräte → Gerät hinzufügen → Stattdessen mit Telefonnummer verknüpfen und geben Sie den 8-stelligen connect.pairing_code vor connect.pairing_code_expires_at ein (etwa 3 Minuten).

4. Auf connected warten

   Nach dem Scan oder dem Code ist connect.linking true, während WhatsApp die Verknüpfung abschließt. Dann wird status zu connected, und phone zeigt die Nummer. Beenden Sie die Abfragen.

Passiert 10 Minuten lang nichts, endet der Versuch, und status wechselt zurück zu disconnected. Fordern Sie erneut mit POST /numbers und ihrer number_id an.

Während eine Nummer verbunden wird, antwortet ein weiterer Request für sie mit 409 connect_in_progress und ihrer number_id: Fragen Sie stattdessen weiter diese ab.

Fehler beim Verbinden#

Verwandte Themen#

• WhatsApp-Nummer verbinden im Dashboard
• Telegram-Konto verbinden
• Nachrichten: mit from von einer Nummer senden
• Fehler