API-Kanal
Verbinde Entagl mit deiner eigenen App oder mit Make: Nachrichten senden, Antworten empfangen und deinen Workspace verwalten.
Überblick
Mit dem API-Channel kannst du denselben AI-Agenten, der deine DMs beantwortet, in deinem Website-Chat, deiner Mobile App oder deinem Backend nutzen. Du sendest eine Nachricht, der Agent denkt nach (mit demselben Buffering und den menschlich wirkenden, mehrteiligen Antworten wie bei einer echten DM), und die Antwort kommt kurz darauf per webhook Callback oder per Polling zurück. Richte alles unter Kanäle → API ein: API-Key generieren, Channel aktivieren und dann Callback oder Polling wählen. Über dieselbe API kann dein Entwickler oder Make außerdem mit Kontakten, Conversations, Buchungen, Bestellungen und mehr arbeiten. Siehe den Tab Workspace API.
Tabs auf dieser Seite
Die API ist nicht nur für Chat gedacht. Dein Entwickler oder ein Tool wie Make kann sie nutzen, um die meisten Daten in deinem Workspace zu lesen und zu aktualisieren.
Was du damit machen kannst
Neben dem Senden von Nachrichten deckt die API Folgendes ab:
- Kontakte: erstellen, aktualisieren, nachschlagen, zusammenführen, Notizen hinzufügen, als nicht kontaktieren markieren
- Tags und Lifecycle-Stages: Tags hinzufügen oder entfernen, einen Kontakt in eine andere Stage verschieben
- Conversations: einem Teammitglied zuweisen, mit Closing Note schließen, die AI pausieren oder fortsetzen, Team-Kommentare hinzufügen, eine Nachricht als dein Unternehmen senden
- Buchungen und Erinnerungen: freie Zeiten prüfen, buchen, verschieben, stornieren, Erinnerungen erstellen und abschließen
- Bestellungen und Produkte: Bestellungen und ihre Positionen erstellen und aktualisieren, deinen Katalog verwalten
- Anrufe: einen AI-Telefonanruf starten oder in die Warteschlange stellen, das Ergebnis lesen
- Kampagnen: deine Kampagnen ansehen und eine senden
Wenn sich etwas ändert, kann Entagl deine Tools sofort per webhook informieren.
Zwei Anmeldemöglichkeiten
Make. Wenn du Make verbindest, meldest du dich mit deinem eigenen Entagl-Konto an. Make handelt dann in deinem Namen, mit genau deinen Rechten: Ein Owner oder Admin kann alles, ein Teammitglied nur das, was seine Berechtigungen erlauben. Wenn dein Login mehrere Workspaces hat, wählst du aus, welchen du verwenden möchtest.
API-Key. Für deinen eigenen Server erstellst du unter Kanäle → API oder Einstellungen → API keys einen Key und sendest ihn als Authorization: Bearer <your key>. Ein Key gehört zu genau einem Workspace und hat dort vollen Owner-Zugriff, behandle ihn also wie ein Passwort.
Sicher wiederholbar: der Idempotency-Key-Header
Manchmal geht eine Anfrage durch, aber die Antwort geht auf dem Rückweg verloren. Wenn dein System nicht sicher ist, ob eine Anfrage funktioniert hat, kann es sie mit demselben Idempotency-Key-Header erneut senden. Innerhalb von 24 Stunden erkennt Entagl den Key, überspringt die Arbeit und gibt die erste Antwort zurück, sodass nicht zwei Bestellungen oder zwei Kontakte entstehen. Derselbe Key für eine andere Anfrage wird mit einem Fehler abgelehnt.
Wie viele Anfragen du senden kannst
Bis zu 120 Anfragen pro Minute und Workspace. Wenn du das überschreitest, antwortet Entagl mit Fehler 429 (rate_limited). Warte kurz und versuche es erneut. Die meisten Automationen kommen nicht einmal annähernd an dieses Limit.
Die vollständige API-Referenz
Jeder Endpunkt, jedes Feld und jeder Fehlercode ist in der Entagl API-Referenz aufgeführt. Öffne sie mit dem Link 'Für Entwickler: API-Referenz' nahe der Oberseite dieser Seite und teile sie mit deinem Entwickler.
Features
Einrichtung & Authentifizierung
Öffne Einstellungen → Integrationen, wähle API und klicke auf API-Schlüssel generieren. Aktiviere den Schalter in der API-Kanal-Karte und rufe dann die API unter https://api.entagl.com mit dem Header Authorization: Bearer <dein Schlüssel> auf. Jeder Schlüssel funktioniert nur für einen Arbeitsbereich.
Nachricht senden
POST /api/v1/messages mit { message, externalUserId }. Du erhältst sofort einen 202 und eine conversationId. Verwende diese conversationId erneut, um die Unterhaltung fortzusetzen. Die Antwort des Agents kommt später, nicht in dieser Response.
Webhook (Callback) (empfohlen)
Füge eine Callback-URL in die API-Kanal-Karte ein und klicke auf Speichern. Entagl sendet dann jede Agentenantwort an diese URL, signiert mit dem Header X-Entagl-Signature (HMAC-SHA256). Verwende eine öffentliche HTTPS-Adresse und klicke auf 'Testlieferung senden', um zu überprüfen, ob es funktioniert. Dein Server sollte die Signatur verifizieren und innerhalb von etwa 5 Sekunden mit einem 2xx-Code antworten. Fehlgeschlagene Rückrufe werden nicht erneut versucht.
Polling
Wenn Sie keine Callback-URL hosten können, rufen Sie GET /api/v1/conversations/:id/messages?since=<cursor> auf, um neue Antworten abzurufen. Geben Sie den cursor aus jeder Antwort als ?since= zurück, damit Sie nur neue Nachrichten erhalten.
Sicherheit & Isolation
API-Keys werden gehasht gespeichert und das Signing Secret wird verschlüsselt (beides wird nur einmal angezeigt). Jede Abfrage ist auf den Workspace begrenzt: Eine Conversation-ID aus einem anderen Workspace gibt 404 zurück, und du kannst keine User ID übergeben (sie wird aus deinem Key abgeleitet).
Häufige Aufgaben
API-Kanal einrichten
Ungefähr 3 min- Öffne Einstellungen → Integrationen, wähle API und klicke auf API-Schlüssel generieren. Gib ihm einen Namen, wenn du möchtest, und kopiere den Schlüssel jetzt, denn er wird nur einmal angezeigt.
- Aktiviere den Schalter im Header der API-Kanal-Karte. Bis er aktiviert ist, werden Nachrichten, die an die API gesendet werden, abgelehnt.
- Empfohlen: Öffne die Einstellungen der Karte, füge deine Callback-URL ein und klicke auf Speichern. Kopiere das Signing Secret, das erscheint, und klicke dann auf Testlieferung senden.
- Senden Sie aus Ihrer App Nachrichten per POST an https://api.entagl.com/api/v1/messages und empfangen Sie Antworten per Callback oder Polling.
Tipps
Häufig gestellte Fragen
War diese Seite hilfreich?