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 Endpoint, jedes Feld und jeder Fehlercode ist in der Entagl API-Referenz aufgeführt. Falls dein Entwickler sie noch nicht hat, schreib an support@entagl.com und bitte um die API-Referenz.
Features
Einrichtung & Authentifizierung
Erzeugen Sie einen API-Schlüssel unter Channels → API, aktivieren Sie den Kanalschalter und rufen Sie die API dann unter https://api.entagl.com mit dem Header Authorization: Bearer <Ihr Schlüssel> auf. Schlüssel sind auf den Workspace beschränkt.
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ügen Sie eine öffentliche HTTPS-Callback-URL hinzu, und Entagl sendet jede Agentenantwort per POST dorthin, signiert mit dem Header X-Entagl-Signature (HMAC-SHA256). Prüfen Sie die Signatur und antworten Sie innerhalb von ~5 Sekunden mit 2xx. Es gibt keinen automatischen Wiederholungsversuch.
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- Gehe zu Channels → API und klicke auf API Key generieren. Kopiere ihn sofort, weil er nur einmal angezeigt wird.
- Aktivieren Sie den Kanalschalter im Kopf der API-Karte.
- Empfohlen: Karte ausklappen, eine öffentliche HTTPS-Callback-URL einfügen, speichern und das Signaturgeheimnis kopieren.
- 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?