SmartChat API

Mit der SmartChat-REST-API kannst du alles, was du in der SmartChat-App machst. Sie wird von Zapier, Make, n8n, eigenem Code und dem Claude-Connector genutzt.

Adresse und Anmeldung

Alle Anfragen gehen an die Adresse unten. Schick deinen API-Schlüssel als Bearer-Token mit. Schlüssel erstellst du in SmartChat unter Einstellungen > API-Schlüssel. Gib jedem Schlüssel nur die Rechte, die er braucht.

https://api.smartchat.marketing/v1

curl https://api.smartchat.marketing/v1/me \
  -H "Authorization: Bearer sk_live_..."

Vollständige Referenz

Die komplette maschinenlesbare Beschreibung (OpenAPI 3) mit jedem Endpunkt, Feld und Fehler:

https://api.smartchat.marketing/v1/openapi.json
https://api.smartchat.marketing/v1/openapi.yaml

Die Bereiche

`/contacts`	Kontakte, Merkmale, Opt-in
`/messages, /sends`	WhatsApp-Nachrichten und Vorlagen senden, Zustellung prüfen
`/inbox`	Gespräche und Nachrichten
`/templates`	WhatsApp-Vorlagen, bei Meta einreichen
`/newsletters`	Newsletter, planen, abbrechen, Stand
`/followups`	Follow-up-Strecken und Schritte
`/automations`	Automationen, Läufe, auslösen
`/media`	Medien-Bibliothek, Upload (multipart, Adresse oder base64)
`/tools`	Jedes Werkzeug von SmartChat AI direkt, zum Beispiel update_landing oder create_newsletter
`/app`	Weitere App-Funktionen: Postfach-Antworten, AI-Einstellungen, Widgets, Domains, Team, Abrechnung (lesen)
`/webhook-subscriptions`	Ereignisse an dein System schicken lassen
`/stats, /me, /settings`	Zahlen, Konto und Einstellungen

Regeln

Grenze: 120 Anfragen pro Minute und Schlüssel. Darüber kommt 429 mit retry-after.
Doppelte vermeiden: beim Senden einen Idempotency-Key-Kopf mitschicken (gilt 24 Stunden).
Fehler kommen als JSON mit Code und englischer Meldung.
Nachrichten gehen nur an Kontakte, die ihre WhatsApp-Anmeldung bestätigt haben. Außerhalb des 24-Stunden-Fensters nur freigegebene Vorlagen.

Zweistufige Aktionen

Werkzeuge, die senden, planen, einreichen oder löschen, liefern zuerst eine Vorschau und ein confirm_token. Ruf dasselbe Werkzeug mit confirm_token nochmal auf, um es auszuführen. Beim ersten Aufruf passiert nichts.

Fragen?

Schreib uns an support@smartchat.marketing