Vai al contenuto
Sviluppatori

Endpoint

Conversations

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

I percorsi sono relativi all'URL di base. Ogni scheda indica il permesso richiesto dalla chiamata e ogni parametro, con tipo e limiti.

GET
/conversations

List conversations, most recently updated first.

Permesso: inbox
Formato di risposta legacy

Parametri di query

  • limitopzionaleinteger

    1–100, default 20.

  • offsetopzionaleinteger

    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 }.

Permesso: inbox
Formato di risposta legacy

Parametri del percorso

  • idobbligatoriointeger

    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.

Permesso: inbox
Formato di risposta legacy

Parametri del percorso

  • idobbligatoriointeger

    Conversation ID.

Parametri di query

  • sinceopzionaleinteger

    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.

Permesso: inbox

Parametri del percorso

  • idobbligatoriointeger

    Conversation ID.

Corpo JSON

  • statusobbligatorioenum

    New status.

    Valori consentiti:openclosed

  • closing_note_idopzionaleinteger | null

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

  • closing_note_textopzionalestring | null

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

  • allow_reopenopzionaleboolean

    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.

Permesso: inbox

Parametri del percorso

  • idobbligatoriointeger

    Conversation ID.

Corpo JSON

  • user_idopzionalestring | null

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

POST
/conversations/:id/ai/pause

Stop AI replies on a conversation.

Permesso: inbox

Parametri del percorso

  • idobbligatoriointeger

    Conversation ID.

Corpo JSON

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

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

  • reasonopzionalestring

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

POST
/conversations/:id/ai/resume

Turn AI replies back on.

Permesso: inbox

Parametri del percorso

  • idobbligatoriointeger

    Conversation ID.

POST
/conversations/:id/handover/resolve

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

Permesso: inbox

Parametri del percorso

  • idobbligatoriointeger

    Conversation ID.

GET
/conversations/:id/comments

List internal team comments on a conversation, newest first.

Permesso: inbox
Paginato

Parametri del percorso

  • idobbligatoriointeger

    Conversation ID.

POST
/conversations/:id/comments

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

Permesso: inbox

Parametri del percorso

  • idobbligatoriointeger

    Conversation ID.

Corpo JSON

  • bodyobbligatoriostring

    1–5,000 characters.

  • mentionsopzionalearray of strings

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