API-Dokumentation

Erste Schritte

Die sem.chat-API ermöglicht es Ihnen, Gespräche programmgesteuert zu verwalten, Nachrichten zu senden und auf analytics. All API requests require authentication using an API key.

Base URL

https://api.sem.chat/v1

Authentifizierung

Fügen Sie Ihren API-Schlüssel in den Authorization-Header aller Anfragen ein:

Authorization: Bearer your_api_key_here

Gesprächs

List Gesprächs

GET /conversations

Eine Liste aller Gespräche Ihres Kontos abrufen.

Parameter	Type	Beschreibung
limit	integer	Number of results to return (max 100)
offset	integer	Number of results to skip
status	string	Filter by status: active, closed, pending

Get Gespräch

GET /conversations/{id}

Details eines bestimmten Gesprächs einschließlich aller Nachrichten abrufen.

Create Gespräch

POST /conversations

Start a new conversation programmatically.

Messages

Nachricht senden

POST /conversations/{id}/messages

Send a message to an existing conversation.

                // Example request body
{
  "content": "Hello, how can I help you today?",
  "sender": "agent"
}
            

Webhooks

Richten Sie Webhooks ein, um Echtzeit-Benachrichtigungen über Gesprächsereignisse zu erhalten.

Verfügbare Ereignisse

Ereignis	Beschreibung
conversation.started	Ein neues Gespräch wurde gestartet
message.received	Eine neue Nachricht von einem Besucher wurde empfangen
conversation.closed	Ein Gespräch wurde geschlossen
lead.captured	Contact information was collected

Ratenbegrenzungen

API-Anfragen sind begrenzt, um faire Nutzung zu gewährleisten:

Plan	Rate Limit
Free	100 requests/hour
Pro	1,000 requests/hour
Business	10,000 requests/hour