API Endpoints

GET /conversations

Query Parameters:
- status: open | pending | closed
- limit: number (default: 20, max: 100)
- offset: number (default: 0)
- from: ISO date string
- to: ISO date string

{
"data": [
  {
    "id": "conv_abc123",
    "visitor_name": "John Smith",
    "visitor_email": "[email protected]",
    "status": "open",
    "source_url": "https://yoursite.com/pricing",
    "created_at": "2025-01-15T14:30:00Z",
    "updated_at": "2025-01-15T14:35:00Z",
    "message_count": 5
  }
],
"meta": {
  "total": 142,
  "limit": 20,
  "offset": 0
}
}

GET /conversations/:id

POST /conversations/:id/messages

{
"content": "Thanks for reaching out! Let me help you with that.",
"sender_type": "agent"
}

PATCH /conversations/:id

{
"status": "closed",
"assigned_to": "user_123"
}

GET /contacts

Query Parameters:
- email: email address to search
- limit: number (default: 20)
- offset: number (default: 0)

POST /contacts

{
"name": "Jane Doe",
"email": "[email protected]",
"custom_fields": {
  "company": "Acme Inc",
  "plan": "enterprise"
}
}

PATCH /contacts/:id

{
"name": "Jane Smith",
"custom_fields": {
  "plan": "pro"
}
}

DELETE /contacts/:id

GET /knowledge

Query Parameters:
- source: crawled | uploaded | manual
- limit: number
- offset: number

POST /knowledge

{
"type": "qa",
"question": "What are your business hours?",
"answer": "We're open Monday-Friday, 9 AM to 5 PM EST."
}

GET /analytics/overview

Query Parameters:
- from: ISO date (required)
- to: ISO date (required)

{
"period": {
  "from": "2025-01-01",
  "to": "2025-01-15"
},
"conversations": {
  "total": 523,
  "ai_resolved": 412,
  "human_handled": 111
},
"resolution_rate": 0.79
}

POST /webhooks

{
"url": "https://yourserver.com/tahc-webhook",
"events": [
  "conversation.created",
  "conversation.escalated"
]
}

{
"error": "error_code",
"message": "Human-readable message",
"code": 400
}