Loading Tropic...
Concepts, SDKs, API reference, channel integrations, and deployment guides. Copy a snippet and your first agent is live in one command.
Ship your first agent in 10 minutes
Agents, sessions, knowledge bases, handoffs
API keys, scopes, rotation, JWT auth
TypeScript + Python clients, typed end-to-end
Session events, handoff requests, analytics
Web widget, Slack, WhatsApp, Teams, email
CSAT, resolution rate, top intents, cohorts
SOC 2, HIPAA, GDPR, data residency
From zero to a deployed agent in three steps.
# TypeScript / Node
npm install @tropic/sdk
# Python
pip install tropicimport { Tropic } from "@tropic/sdk";
const tropic = new Tropic({ apiKey: process.env.TROPIC_API_KEY });
const agent = await tropic.agents.create({
name: "support-agent",
persona: "Friendly, concise. Always de-escalate.",
knowledge: ["https://tropic.run/docs"],
channels: ["web", "slack"],
});
console.log("Deployed:", agent.widgetUrl);const session = await tropic.sessions.start({ agentId: agent.id });
const reply = await tropic.sessions.send(session.id, {
role: "user",
content: "My order hasn't shipped yet.",
});
console.log(reply.content);Tropic POSTs signed JSON to your endpoint every time a session event fires.
{
"event": "session.handoff_requested",
"session_id": "sess_01H…",
"agent_id": "agent_01H…",
"summary": "Customer is asking for a full refund — outside auto-refund policy.",
"customer": { "email": "[email protected]" },
"transcript_url": "https://api.tropic.run/sessions/sess_01H…/transcript",
"signature": "t=1712…,v1=a3f2…"
}Verify with HMAC-SHA256 using the signing secret from Settings → Webhooks. Tropic retries failed deliveries with exponential backoff for 24h.
Every paid plan includes direct Slack access to engineers building Tropic. Median first response: under one hour.
Contact supportGrab an API key and you're running in a minute. No credit card for the trial.