Zum Inhalt springen
Wiz Message
Cloud-API-kompatibel

Schon auf WhatsApp Cloud API gebaut? Ändern Sie Host und Token.

Das ist kein „wir haben auch eine API“. Es ist dieselbe API. Die Pfade entsprechen denen von Meta, die Request-Bodies entsprechen, die Antworten entsprechen, und Fehler kommen im Umschlag von Meta zurück – Ihre bereits geschriebene Fehlerbehandlung funktioniert also weiter. Richten Sie Ihren Client auf einen anderen Host, tauschen Sie das Token, und hören Sie auf.

Enthalten inWiz BotWiz CampaignWiz Pro

Tarife ansehenPreise ansehen
Ein Host und ein Token. Der Rest Ihrer Integration bleibt unangetastet
Zwei Änderungen
Fehler kommen im Fehlerumschlag von Meta zurück, Ihre bestehende Behandlung greift also weiter
Dieselben Fehler
Die in Ihrer URL fixierte Version funktioniert weiter, nachdem Meta sie abgeschaltet hat
Versionssicher

Für wen das gedacht ist

Das Unternehmen oder die Agentur, die bereits eine Entwicklerin für die Anbindung an Metas Cloud API bezahlt hat – und für eine Migration nicht erneut zahlt.

Die Sorge, die es ausräumt

„Plattformwechsel heißt neu integrieren.“ Nicht, wenn Endpunkte, Nutzdaten und Fehlerformen identisch sind.

So läuft die Migration

  1. Schlüssel erstellen

    Erzeugen Sie im Dashboard einen API-Schlüssel. Er wird in derselben Header-Form übergeben wie ein Meta-Token.

  2. Basis-URL ändern

    Richten Sie Ihren bestehenden Client auf den kompatiblen Host statt auf den von Meta.

  3. Token tauschen

    Verwenden Sie Ihren Schlüssel als Bearer-Token. An der Art, wie Sie Requests zusammenbauen, ändert sich nichts.

  4. Bestehende Tests laufen lassen

    Dieselben Pfade, dieselben Bodies, dieselben Antworten, derselbe Fehlerumschlag – Ihre Testsuite ist die Migrationsprüfung.

Was gespiegelt ist

Die Endpunkte, die Integrationen tatsächlich nutzen, an den Pfaden, die Meta dokumentiert.

  • Nachrichten senden am selben Nachrichten-Endpunkt, den Sie schon aufrufen
  • Nachrichten als gelesen markieren und Tippindikatoren senden, mit demselben Request-Body
  • Medien-Upload, der eine ID in der Form zurückgibt, die Sie bereits auswerten
  • Nachrichtenvorlagen auflisten
  • Medien-Metadaten, Download und Löschen – die Metadaten liefern eine funktionierende URL, die Ihr Client abruft, ohne zu wissen, wem sie gehört
  • Ein Durchreichen per Positivliste für die übrigen dokumentierten Pfade
  • Fehler im Umschlag von Meta, sodass Ihre bestehende Fehlerbehandlung weiter funktioniert

Versionsfixierung, die Metas Abschaltungen überlebt

Das Versionssegment in der URL wird angenommen und dann ignoriert. Das klingt nach Abkürzung und ist in Wahrheit ein Vorteil, den man aussprechen sollte: Ein auf eine ältere Version fixierter Client läuft weiter, nachdem Meta sie abgeschaltet hat, und eine neuere zu fixieren kann Sie nicht in Verhalten hineinziehen, das gar nicht ausgerollt ist. Die Version in Ihrem Code hört auf, eine Wartungsaufgabe zu sein.

Eine Positivliste, kein blinder Proxy

Es existieren nur die dokumentierten Pfade, und jeder prüft, dass die Kennung im Pfad zum aufrufenden Schlüssel gehört. Das hält die Oberfläche prüfbar – Sie können genau angeben, wie weit dieser Endpunkt reicht – und bedeutet, dass ein Fehler in Ihrem Client eine ehrliche Antwort bekommt, statt irgendwohin weitergereicht zu werden. Jeder Versand läuft weiterhin über die Plattform, es gelten also dieselbe Ratenbegrenzung und derselbe Kontoschutz wie überall sonst.

Gut zu wissen

Wo diese Funktion aufhört, klar gesagt – damit Sie hier nach dem Kauf nichts überrascht.

  • Erfordert ein aktives Abonnement und durchläuft dieselben Berechtigungs- und Ratenprüfungen wie der Rest der API.
  • Das ist eine Positivliste, kein offener Proxy. Es existieren nur die dokumentierten Pfade, und jeder prüft, dass die Kennung im Pfad zu Ihrem Schlüssel gehört.
  • Das Versionssegment wird erkannt und dann ignoriert – Aufrufe gehen immer an die konfigurierte Plattformversion. Das ist Absicht und der Grund, warum eine alte Fixierung weiter funktioniert.
  • Nur GET, POST und DELETE. Kein PUT, kein PATCH, weil eine plausible Fehlermeldung dafür weniger ehrlich wäre als ein 404.
  • Sendungen laufen weiterhin über das Plattform-Gateway statt direkt hinaus, sodass Ratenbegrenzung und Schutzmechanismen auf Kontoebene weiter greifen.

Enthalten in

Diese Funktion gehört zu den folgenden Tarifen.

  • Wiz Bot
  • Wiz Campaign
  • Wiz Pro
Tarife und Preise vergleichen
FAQ

Häufig gestellte Fragen

Wie viel von meinem Code muss sich ändern?

Die Basis-URL und das Token. Pfade, Request-Bodies, Antworten und Fehlerformen sind gleich – genau darin besteht der Zweck dieser Funktion.

Ist das wirklich dieselbe API oder nur eine ähnliche?

Dieselben Pfade, dieselben Request-Bodies, dieselben Antworten und derselbe Fehlerumschlag. „Ähnlich“ würde Sie weiterhin eine Neuentwicklung kosten; dies ist so gebaut, dass Ihre bestehenden Tests unverändert bestehen.

Und die Versionsnummer in meinen URLs?

Sie wird angenommen und ignoriert, sodass ein auf eine ältere Version fixierter Client weiterläuft, nachdem Meta sie abgeschaltet hat. Sie müssen Abkündigungen nicht hinterherlaufen.

Welche HTTP-Methoden werden unterstützt?

GET, POST und DELETE. Kein PUT und kein PATCH – wir geben lieber einen ehrlichen 404 zurück als eine überzeugende Fehlermeldung für etwas, das es nicht gibt.

Ist alles verfügbar, was Meta anbietet?

Nein. Dies ist eine bewusste Positivliste der dokumentierten Pfade, kein blinder Proxy, damit die Oberfläche prüfbar bleibt.

Bekomme ich weiterhin die eigenen Funktionen der Plattform?

Ja. Sendungen laufen über dieselbe Plattform, die auch Ihr Dashboard nutzt – Posteingang, Auswertungen, Kontoschutz und Ratenbegrenzung gelten also weiterhin.

Wechseln, ohne neu zu integrieren

Host ändern, Token tauschen und Ihre bestehenden Tests laufen lassen.

Tarife ansehen

Weitere Funktionen Entdecken

Entdecken Sie weitere Tools, die WizMessage zur kompletten WhatsApp-Plattform machen.