conversations
Inbox conversations: assignment, status, notes, labels, AI mode.
Inbox conversations: assignment, status, notes, labels, AI mode.
| Method | Path | Operation | Scope | Test mode |
|---|---|---|---|---|
| GET | /v1/conversations | conversations_list: List and filter conversations | conversations:read | yes |
| POST | /v1/conversations | conversations_create: Open a conversation with a contact on a channel | conversations:write | - |
| GET | /v1/conversations/{conversation_id} | conversations_get: Get a conversation | conversations:read | yes |
| PATCH | /v1/conversations/{conversation_id} | conversations_update: Update priority, subject and custom attributes | conversations:write | yes |
| GET | /v1/conversations/{conversation_id}/ai | conversations_ai_get: AI state of a conversation | conversations:read | - |
| POST | /v1/conversations/{conversation_id}/ai/pause | conversations_ai_pause: Pause the bot for this chat (human takeover) | conversations:write | - |
| POST | /v1/conversations/{conversation_id}/ai/resume | conversations_ai_resume: Resume the bot | conversations:write | - |
| POST | /v1/conversations/{conversation_id}/ai/suggest-replies | conversations_ai_suggest_replies: Suggested replies | ai:read | - |
| POST | /v1/conversations/{conversation_id}/ai/summarize | conversations_ai_summarize: Summarise the conversation | ai:read | - |
| POST | /v1/conversations/{conversation_id}/ai/translate | conversations_ai_translate: Translate messages | ai:read | - |
| POST | /v1/conversations/{conversation_id}/assign | conversations_assign: Assign to a user or team (or unassign) | conversations:write | - |
| POST | /v1/conversations/{conversation_id}/auto-assign | conversations_auto_assign: Apply the routing rule | conversations:write | - |
| POST | /v1/conversations/{conversation_id}/close | conversations_close: Resolve or close | conversations:write | yes |
| POST | /v1/conversations/{conversation_id}/labels | conversations_labels_add: Add labels | conversations:write | - |
| DELETE | /v1/conversations/{conversation_id}/labels/{label_id} | conversations_labels_remove: Remove a label | conversations:write | - |
| POST | /v1/conversations/{conversation_id}/lane | conversations_set_lane: Mark a chat private or business (owner only) | conversations:write | - |
| GET | /v1/conversations/{conversation_id}/notes | conversations_notes_list: Internal notes | conversations:read | yes |
| POST | /v1/conversations/{conversation_id}/notes | conversations_notes_create: Add an internal note | conversations:write | yes |
| DELETE | /v1/conversations/{conversation_id}/notes/{note_id} | conversations_notes_delete: Delete a note | conversations:write | yes |
| GET | /v1/conversations/{conversation_id}/notes/{note_id} | conversations_notes_get: Get an internal note | conversations:read | yes |
| PATCH | /v1/conversations/{conversation_id}/notes/{note_id} | conversations_notes_update: Edit a note | conversations:write | yes |
| GET | /v1/conversations/{conversation_id}/participants | conversations_participants_list: Agents who handled the chat, and watchers | conversations:read | - |
| POST | /v1/conversations/{conversation_id}/read | conversations_mark_read: Mark as read | conversations:write | yes |
| POST | /v1/conversations/{conversation_id}/reopen | conversations_reopen: Reopen a resolved conversation | conversations:write | yes |
| DELETE | /v1/conversations/{conversation_id}/snooze | conversations_unsnooze: Unsnooze | conversations:write | yes |
| POST | /v1/conversations/{conversation_id}/snooze | conversations_snooze: Snooze until a time | conversations:write | yes |
| POST | /v1/conversations/{conversation_id}/transfer-to-meta-agent | conversations_transfer_to_meta_agent: Pass thread control to Meta's agent or a partner app | conversations:write | - |
| POST | /v1/conversations/{conversation_id}/typing | conversations_typing: Typing indicator | messages:send | - |
| POST | /v1/conversations/{conversation_id}/watchers | conversations_watchers_add: Follow a conversation | conversations:write | - |
Request and response schemas: the interactive reference at https://api.wapitick.com/docs, or docs/api/openapi.json.