Connect your agent
Bring your own agent and connect it to the dashboard.
Who builds what
| You | Helpdesk |
|---|---|
| Run chat inference. Decide when to escalate. Pass summary and urgency. | Handoff UI, Helpdesk queue, tickets, assignees, status. |
- Run chat on your stack (LLM, bot, or third-party API).
- Return escalate: true or call the handoff endpoint.
- Keep the widget or React SDK pointed at your baseUrl.
Escalation signals
- SSE final event with escalate: true and handoff object.
- Customer taps handoff in the widget.
- POST /api/v1/handoff/ticket from your own UI.
SSE final event
{
"delta": "",
"done": true,
"escalate": true,
"handoff": {
"humanDesk": true,
"urgency": "high",
"conversationSummary": "Customer cannot access account after password reset."
}
}Widget payload
Handoff object
{
"humanDesk": true,
"email": "support@yourcompany.com",
"conversationSummary": "Customer asked about refund for order #4521...",
"urgency": "medium"
}POST /handoff/ticket
Create a ticket without the chat stream. Useful for headless integrations.