Anleitung/SendApp Agent/Berichte & API

API-Schlüssel und Webhooks

Wenn du SendApp Agent mit deinen Systemen (Warenwirtschaft, CRM, Automatisierungen) integrieren möchtest, ist die API der Weg. Hier findest du, wie du dich authentifizierst, was du tun kannst und wie du eingehende Events über Webhooks empfängst. Es ist eine technische Anleitung, aber mit Schritt für Schritt erklärten Konzepten.

Aktualisiert am 16. Juni 2026 · 6 Min. Lesezeit

Den API-Schlüssel erhalten

1. 1

   Öffne den Bereich „API“

   Öffne im Menü API: Hier findest du den Entwicklerschlüssel (apikey) deines Kontos.

2. 2

   Kopiere den Schlüssel

   Verwende ihn, um deine Anfragen zu authentifizieren. Behandle ihn wie ein Passwort.

So authentifizierst du dich

Basis-URL

Die API liegt auf der Domain deines Kontos, mit dem Präfix /api (z. B. https://deine-domain/api). Verwende weder „/v1“ noch andere Domains.

Authentifizierung

Übergib den Schlüssel im HTTP-Header „X-API-Key“ oder als Parameter „apikey“ in der Anfrage. Es wird kein Bearer-Token verwendet.

Teile den API-Schlüssel nicht und füge ihn nicht in öffentlichen Code ein (z. B. JavaScript auf Browser-Seite): Wer den Schlüssel hat, kann auf deinem Konto agieren. Wenn er offengelegt wurde, generiere ihn neu.

Was du über die API tun kannst

• Nachrichten senden (z. B. über den WhatsApp-Versand-Endpoint), im Rahmen der Regeln des Kanals (bei der offiziellen Meta-API braucht es ein genehmigtes Template, um zuerst zu schreiben).
• Die Kontakte des Adressbuchs verwalten.
• Programmatisch ein neues Konto (Bot) erstellen.
• Die URL deines Webhooks registrieren, um eingehende Events zu empfangen.

Die Endpoints, die den Schlüssel akzeptieren, funktionieren sowohl mit dem Kontoinhaber als auch mit einem berechtigten Operator: Vergib die Schlüssel mit Bedacht, je nachdem, wer integrieren soll.

Webhooks: die Events empfangen

Mit den Webhooks empfängst du in Echtzeit die eingehenden Events (z. B. eine neue Nachricht von einem Kanal). Du registrierst die URL deines Endpoints über die API: Ab diesem Moment sendet SendApp die Daten an dein System, wenn das Event eintritt. Das ist der Weg, um ein CRM oder eine externe Warenwirtschaft synchron zu halten.

Häufige Fehler

401 / nicht autorisiert

Schlüssel fehlt oder ist falsch: Prüfe den Header X-API-Key oder den Parameter apikey.

Falsche URL

Verwende die Domain deines Kontos mit dem Präfix /api, ohne „/v1“.

Zu viele Anfragen an einen Endpoint

Manche Endpoints haben ein Frequenzlimit: Verteile die Aufrufe, statt sie zu bündeln.