Start Free Trial

Getting Started

The sem.chat API allows you to programmatically manage conversations, send messages, and access analytics. All API requests require authentication using an API key.

Base URL

https://api.sem.chat/v1

Authentication

Include your API key in the Authorization header of all requests:

Authorization: Bearer your_api_key_here

Conversations

List Conversations

GET /conversations

Retrieve a list of all conversations for your account.

Parameter Type Description
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 Conversation

GET /conversations/{id}

Retrieve details of a specific conversation including all messages.

Create Conversation

POST /conversations

Start a new conversation programmatically.

Messages

Send Message

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

Set up webhooks to receive real-time notifications about conversation events.

Available Events

Event Description
conversation.started A new conversation has been initiated
message.received A new message was received from a visitor
conversation.closed A conversation has been closed
lead.captured Contact information was collected

Rate Limits

API requests are limited to ensure fair usage:

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