Integrieren Sie sem.chat in Ihre Anwendungen mit unserem leistungsstarken REST API.
Mit sem.chat API können Sie Konversationen programmgesteuert verwalten, Nachrichten senden und darauf zugreifen Analytik. Alle API-Anfragen erfordern eine Authentifizierung mit einer API-Taste.
https://api.sem.chat/v1 Fügen Sie Ihren API-Schlüssel in den Authorization-Header aller Anfragen ein:
Authorization: Bearer your_api_key_here Rufen Sie eine Liste aller Konversationen für Ihr Konto ab.
| Parameter | Typ | Beschreibung |
|---|---|---|
| Limit | ganze Zahl | Anzahl der zurückzugebenden Ergebnisse (max. 100) |
| offset | integer | Anzahl der zu überspringenden Ergebnisse |
| status | string | Nach Status filtern: aktiv, geschlossen, ausstehend |
Details einer bestimmten Konversation einschließlich aller Nachrichten abrufen.
Eine neue Konversation starten Programmgesteuert.
Senden Sie eine Nachricht an eine bestehende Konversation.
// Example request body { "content": "Hello, how can I help you today?", "sender": "agent" } Richten Sie Webhooks ein, um Echtzeitbenachrichtigungen über Konversationsereignisse zu erhalten.
| Ereignis | Beschreibung |
|---|---|
| conversation.started | Eine neue Konversation wurde initiiert |
| message.received | Eine neue Nachricht wurde von einem Besucher empfangen |
| conversation.closed | Eine Konversation wurde geschlossen |
| lead.captured | Kontaktinformationen wurden gesammelt |
API Anfragen sind begrenzt, um eine faire Nutzung sicherzustellen:
| Planen | Rate Limit |
|---|---|
| Testversion | 100 Anfragen/Stunde |
| Pro | 1.000 Anfragen/Stunde |
| Business | 10.000 Anfragen/Stunde |
Definieren Sie mit der API-Referenz nur die Daten und Berechtigungen, die der konkrete Ablauf wirklich benoetigt. Speichern Sie Zugangsdaten ausschliesslich serverseitig und niemals im Browser, in oeffentlichen Repositories, Screenshots oder Support-Nachrichten. Trennen Sie Entwicklung und Produktion, validieren Sie Eingaben, behandeln Sie Limits und Wiederholungen kontrolliert und protokollieren Sie keine sensiblen Kundendaten. Testen Sie abgelaufene Zugangsdaten, doppelte Ereignisse, Netzwerkfehler und einen sicheren Rollback. Benennen Sie Verantwortliche fuer Rotation und Stoerungsfaelle und entfernen Sie nicht mehr benoetigte Zugriffe regelmaessig.