Zum Inhalt springen
Entwickler

Endpoints

Conversations

Open, close, assign and hand over conversations, pause the AI, and leave team comments.

Pfade sind relativ zur Basis-URL. Jede Karte zeigt die Berechtigung, die der Aufruf braucht, und jeden Parameter mit Typ und Grenzen.

GET
/conversations

List conversations, most recently updated first.

Berechtigung: inbox
Altes Antwortformat

Query-Parameter

  • limitoptionalinteger

    1–100, default 20.

  • offsetoptionalinteger

    Number of conversations to skip, default 0.

  • Returns a plain JSON array (offset pagination, not the list envelope).
GET
/conversations/:id

Retrieve a conversation with its messages, as { conversation, messages }.

Berechtigung: inbox
Altes Antwortformat

Pfadparameter

  • iderforderlichinteger

    Conversation ID.

GET
/conversations/:id/messages

Poll the AI replies of an API-channel conversation. Returns { conversationId, messages, cursor } with assistant messages newer than since.

Berechtigung: inbox
Altes Antwortformat

Pfadparameter

  • iderforderlichinteger

    Conversation ID.

Query-Parameter

  • sinceoptionalinteger

    Return only messages with a larger ID (pass the previous cursor). Default 0.

  • For every message of any conversation, use GET /messages?conversation_id= instead.
PUT
/conversations/:id/status

Open or close a conversation, with an optional closing note.

Berechtigung: inbox

Pfadparameter

  • iderforderlichinteger

    Conversation ID.

JSON-Body

  • statuserforderlichenum

    New status.

    Erlaubte Werte:openclosed

  • closing_note_idoptionalinteger | null

    A closing note from GET /closing-notes. Only when closing.

  • closing_note_textoptionalstring | null

    Free-text closing note, up to 2,000 characters. Only when closing.

  • allow_reopenoptionalboolean

    When closing: whether a new customer message reopens this conversation (true) or starts a new one (false).

PUT
/conversations/:id/assignee

Assign the conversation to a team member, or unassign it.

Berechtigung: inbox

Pfadparameter

  • iderforderlichinteger

    Conversation ID.

JSON-Body

  • user_idoptionalstring | null

    A user from GET /users. Omit or send null to unassign.

POST
/conversations/:id/ai/pause

Stop AI replies on a conversation.

Berechtigung: inbox

Pfadparameter

  • iderforderlichinteger

    Conversation ID.

JSON-Body

  • untiloptionalstring (ISO 8601 date-time with offset) | null

    Resume automatically at this time (must be in the future). Omit to pause until resumed.

  • reasonoptionalstring

    Up to 100 characters, passed to the conversation.ai_paused event.

POST
/conversations/:id/ai/resume

Turn AI replies back on.

Berechtigung: inbox

Pfadparameter

  • iderforderlichinteger

    Conversation ID.

POST
/conversations/:id/handover/resolve

Mark the conversation's open handover requests as handled. Returns resolved_count.

Berechtigung: inbox

Pfadparameter

  • iderforderlichinteger

    Conversation ID.

GET
/conversations/:id/comments

List internal team comments on a conversation, newest first.

Berechtigung: inbox
Paginiert

Pfadparameter

  • iderforderlichinteger

    Conversation ID.

POST
/conversations/:id/comments

Add an internal team comment. It is never sent to the customer.

Berechtigung: inbox

Pfadparameter

  • iderforderlichinteger

    Conversation ID.

JSON-Body

  • bodyerforderlichstring

    1–5,000 characters.

  • mentionsoptionalarray of strings

    Up to 20 user IDs from GET /users to notify.