Ihr erster Aufruf

Listen Sie die Verbindungen auf, die Ihr Schlüssel erreichen kann, und prüfen Sie Ihre Kapazität, bevor Sie eine weitere bereitstellen.

Basis-URL https://developers.wasync.app/api/v1.

Nutzbare Verbindungen auflisten

GET /connections

curl https://developers.wasync.app/api/v1/connections \
  -H "Authorization: Bearer $WASYNC_API_KEY"

Es erscheinen nur Verbindungen mit aktiver Lizenz. Jede enthält einen provider mit dem Wert qr oder cloud_api, eine id (eine cuid – die stabile Kennung, die Sie bei Ihrem eigenen Kundendatensatz speichern sollten) und einen status. Verwendet whatsapp.read.

Sie rufen bereits cloudapi.wasync.app/api/v1 auf? Dabei bleibt es.

developers.wasync.app ist der kanonische Host, aber cloudapi.wasync.app ist ein dauerhafter Alias für exakt dieselbe API – dieselben Schlüssel, dieselben Pfade, dieselben Antworten – und bleibt unbefristet gültig. Bestehende Integrationen müssen nichts ändern. Die OAuth-Endpunkte, die /.well-known/…-Dokumente und die URL des MCP-Servers sind Protokollkennungen, die bei Clients registriert sind: Sie bleiben bewusst auf cloudapi.wasync.app.

Kapazität prüfen, bevor Sie sie zusagen

GET /account

curl https://developers.wasync.app/api/v1/account \
  -H "Authorization: Bearer $WASYNC_API_KEY"

200 response

{
  "slots": {
    "total": 30,
    "used": 28,
    "available": 2,
    "nextExpiry": "2027-08-08T09:00:00.000Z"
  },
  "connections": {
    "total": 28,
    "connected": 27,
    "needsReconnect": 1
  }
}

slots.available zeigt Ihnen, ob Sie jetzt eine weitere Nummer einrichten können. nextExpiry ist das Datum, vor dem Sie Ihrem eigenen Kunden eine Rechnung stellen müssen – damit ein Slot nie unter den Händen von jemandem ausläuft, der Sie bereits bezahlt hat. connections.needsReconnect zählt die Nummern, die gerade darauf warten, dass ihr Inhaber einen QR-Code scannt. Abonnieren Sie die Verbindungsereignisse, um im Moment der Änderung benachrichtigt zu werden, statt ständig abzufragen. Verwendet whatsapp.read.

Ein Slot ist Kapazität, keine Telefonnummer. Löschen Sie eine Verbindung, kehrt ihr Slot mit der verbleibenden Laufzeit in Ihren Pool zurück – die nächste Nummer, die Sie verbinden, übernimmt ihn automatisch. So können Sie einen bezahlten Slot von einem ausscheidenden Kunden auf einen neuen übertragen, ohne doppelt zu zahlen.

Eine Nummer verbinden

Ein Aufruf erstellt die Verbindung und liefert einen QR-Code zum Scannen. Das funktioniert in einem brandneuen Workspace ganz ohne Verbindungen – mit einem Schlüssel müssen Sie zuvor nichts in einem Portal anklicken.

POST /connections

curl -X POST https://developers.wasync.app/api/v1/connections \
  -H "Authorization: Bearer $WASYNC_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"label":"Support line"}'

201 response

{
  "connection": {
    "id": "conn_8f3a21",
    "status": "connecting",
    "qr": "data:image/png;base64,iVBORw0KGgo…"
  }
}

Der QR-Code von hier bleibt nicht gültig

WhatsApp wechselt den Kopplungscode etwa alle 20 Sekunden. Der qr in der Antwort auf die Erstellung ist daher schon Sekunden nach der Anzeige veraltet. Das schlägt unbemerkt fehl: Das Telefon koppelt sich nie, und nichts auf dem Bildschirm erklärt, warum. Fragen Sie GET /connections/{id} alle 3–5 s ab und rendern Sie den qr aus jeder Antwort neu. Speichern Sie ihn nicht zwischen, und verstecken Sie die Aktualisierung nicht hinter einer Schaltfläche, die der Nutzer drücken muss. Kopplungscode & QR behandelt die Alternative mit einem einzigen Gerät.

Verwendet whatsapp.manage. Auf diese Weise erstellte Verbindungen sind qr-Nummern; cloud_api-Nummern werden stattdessen über Meta Embedded Signup eingerichtet. Dieser Endpunkt gilt nur für eigenständige Workspaces – ein Bitrix24-Portal erhält 403 forbidden_portal_kind, denn dort legt der Portal-Administrator die Verbindungen in WASync an. Senden Sie einen Idempotency-Key: Das Erstellen einer Verbindung verbraucht einen bezahlten Slot, und ein Wiederholungsversuch nach einem Timeout ohne Schlüssel kauft Ihnen zwei. Fehler & Idempotenz beschreibt die vier Fälle, die Sie behandeln müssen.

War diese Seite hilfreich?

Nutzbare Verbindungen auflisten

Kapazität prüfen, bevor Sie sie zusagen

Eine Nummer verbinden

On this page