Binde Chat33
in deinen Stack ein.

Endpoint

POST https://chat33.io/api/webhooks/events?token=YOUR_TOKEN

Content-Type: application/json

{
  "event": "purchase",
  "contactId": "cm1abc123...",
  "value": 49.99,
  "currency": "USD",
  "metadata": {
    "product": "Pro Plan",
    "source": "checkout"
  }
}

Request-Body

Beispiele

# cURL
curl -X POST "https://chat33.io/api/webhooks/events?token=YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"event":"purchase","value":29.99,"currency":"USD"}'

// Node.js / fetch
await fetch("https://chat33.io/api/webhooks/events?token=YOUR_TOKEN", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    event: "purchase",
    contactId: "cm1abc123...",
    value: 29.99,
    currency: "USD",
  }),
});

Die Developer-Connect-API stellt einen Einmal-Link aus, der einen deiner Nutzer in deinem Auftrag zum OAuth-Zustimmungsbildschirm der Plattform schickt, ohne je sein Passwort zu berühren. Sobald die Person zustimmt, verhält sich das verbundene Konto wie jedes andere in der Social-Posting-API oben: Du postest darauf, liest die Analysen, soweit die Plattform sie liefert, und trennst es wieder. Alles bezieht sich auf den Endnutzer („Profil“), dem es gehört.

So funktioniert es

1. Erstelle ein Profil für den Nutzer (POST /v1/profiles) oder verwende eines wieder, identifiziert über deine eigene externalId.
2. Fordere einen Connect-Link für dieses Profil und eine Plattform an (POST /v1/connect). Er ist einmal gültig, für 15 Minuten.
3. Schick den Nutzer zur zurückgegebenen url. Die Person stimmt auf dem eigenen Bildschirm der Plattform zu, der Chat33 als anfragende App nennt. Das ist erwartet, und niemand sieht ihr Passwort.
4. Sie landen wieder auf deiner redirectUrl mit status, profileId und accountIds (oder status=error&code=…, wenn abgebrochen wurde oder etwas schiefging: Eine abgebrochene Zustimmung verbraucht den Link nicht).

Profil erstellen

curl -X POST "https://chat33.io/api/v1/profiles" \
  -H "x-api-key: sk_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Acme Fitness",
    "externalId": "user_482"
  }'

Connect-Link erstellen

curl -X POST "https://chat33.io/api/v1/connect" \
  -H "x-api-key: sk_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "profileId": "prof_abc123",
    "platform": "instagram",
    "redirectUrl": "https://yourapp.com/oauth/done",
    "skipIntro": false
  }'
# -> {"url": "https://chat33.io/connect/...", "expiresAt": "...", "platform": "instagram", "profileId": "prof_abc123"}
# send your user to that url
# skipIntro: true returns a url that goes straight to the platform's consent screen

Das sieht dein Nutzer

Eine von Chat33 gehostete Seite, die deine App nennt, danach der Login- und Zustimmungsbildschirm der Plattform, der Chat33 als App nennt, die den Zugriff anfragt, nicht deine App. So funktioniert das zugrunde liegende OAuth, und es ist erwartet. Der Zugriff lässt sich jederzeit bei der Plattform selbst widerrufen.

Um die Einführungsseite zu überspringen und den Nutzer direkt zum Zustimmungsbildschirm der Plattform zu schicken, übergib beim Erstellen des Links "skipIntro": true. Der Link ist dann eine sofortige Weiterleitung: derselbe Token, dieselben 15 Minuten Gültigkeit, dieselbe Rückkehr zu deiner redirectUrl. Wenn du sie überspringst, sag deinem Nutzer auf deinem eigenen Bildschirm, dass die Zustimmungsseite Chat33 nennt, und schick ihn lieber per Button-Klick statt per Link in einer E-Mail: Mail-Clients und Chat-Apps rufen Links vorab ab, und ein Vorabruf eines skipIntro-Links öffnet den Dialog der Plattform im Scanner (der Token wird dabei nicht verbraucht).

Regeln

• Ein echtes Konto existiert in ganz Chat33 nur einmal. Es kann kein zweites Mal verbunden werden, weder von dir noch von jemand anderem, weder über die API noch über das Chat33-Dashboard.
• Per API verbundene Konten zählen nie auf das Kanal-Limit des Tarifs deiner Organisation.
• Eingehende Nachrichten und Kommentare auf diesen Konten werden von Chat33 nicht gespeichert oder automatisiert (v1 kann nur veröffentlichen).
• Facebook verbindet jede Seite, auf die die Person Zugriff gewährt; jede Seite ist ein eigenes Konto und ein eigener Slot.
• Instagram verbindet über Instagram Login, für Business- oder Creator-Konten.
• X-Posts über verbundene Konten ziehen ebenfalls vom Guthaben ab, genau wie Posts von Konten in deinem eigenen Dashboard.

Pausierte Konten

Ein Konto, dessen Slot 7 Tage unbezahlt blieb, wird pausiert: Das Veröffentlichen liefert 402 account_paused mit den betroffenen accountIds; es läuft automatisch weiter, wenn du aufladest. POST /v1/posts, POST /v1/posts/validate und POST /v1/posts/:id/duplicate prüfen das alle vorab, bevor etwas eingereiht wird.

// 402
{
  "error": "ACCOUNT_PAUSED",
  "code": "account_paused",
  "message": "These accounts are paused until outstanding connection charges are paid. Top up credits.",
  "accountIds": ["chan_abc123"]
}

API-Referenz

Scope aktivieren

Hole dir den Scope connect:write: Erstelle unter Einstellungen → API Keys einen Key und hake Konten deiner Nutzer verbinden an. Er ist bei jedem Key standardmäßig aus.

So funktioniert es

Wenn du getrackte Links in deinen Automationen nutzt, verpackt Chat33 sie in eine Redirect-URL, die den Klick aufzeichnet, bevor sie zum Ziel weiterleitet. Die Kontakt-ID wird als Query-Parameter angehängt, damit nachgelagerte Seiten den Besucher erkennen können.

# Original URL in your flow:
https://yoursite.com/signup

# What gets sent to the user:
https://chat33.io/api/t?url=https://yoursite.com/signup&cid=cm1abc...&fid=flow123

# User is redirected to:
https://yoursite.com/signup?cid=cm1abc...&fid=flow123

Angehängte URL-Parameter