Taktik API

Integrate Taktik into your existing tools and workflows. Manage conversations, analytics, webhooks, and more programmatically.

Quick Start

Authentication

Get your API token by signing in and calling the token endpoint:

# 1. Sign in at taktik.xyz/login to get your session cookie
# 2. Exchange it for an API token
curl https://taktik.xyz/api/auth/token \
  -H "Cookie: next-auth.session-token=YOUR_SESSION_COOKIE"

# 3. Use the token for all API calls
curl https://taktik.xyz/api/chat/conversations?workspaceId=ws_xxx \
  -H "Authorization: Bearer YOUR_TOKEN"

List Conversations

GET /api/chat/conversations
  ?workspaceId=ws_xxx
  &status=open
  &limit=20

Filter by status, assignee, team, or skill tags. Supports cursor-based pagination.

Send a Message

POST /api/chat/conversations/{id}/messages
{
  "content": "Hello!",
  "workspaceId": "ws_xxx"
}

Send agent messages, internal notes, or AI-assisted responses.

Get Analytics

GET /api/analytics/overview
  ?workspaceId=ws_xxx

Conversation counts, response times, CSAT scores, and agent performance.

Configure Webhook

POST /api/webhooks
{
  "workspaceId": "ws_xxx",
  "name": "Slack Alerts",
  "url": "https://...",
  "events": ["conversation.created"]
}

Receive real-time events for conversations, messages, and more.

API Categories

Conversations

List, create, update, close

Messages

Send, edit, read receipts

Analytics

Overview, CSAT, NPS, agents

Workspaces

Settings, members, teams

Webhooks

Create, test, manage

Knowledge Base

Sources, chunks, sync

Insights

Product insights, evidence

Notifications

List, mark read, counts

Import

CSV import, templates

Widget

Visitor-facing endpoints

Swarm

Expert checkout, heartbeat

Billing

Subscription, checkout

Ready to Integrate?

API access is available on Pro plans and above. Start your free trial to get your API token.