AI agents for Crisp

List conversations

Lists conversations, most recently active first, 20 to 50 a page (pages start at 1).

Get a conversation

Reads one conversation by its session ID: state, people_id, inbox_id, assigned, meta.

List messages in a conversation

Reads a conversation's latest messages, or the batch before a message timestamp (before, from a message's timestamp) to page back.

Find contacts

Lists contact profiles, 20 to 50 a page, or those matching a quick text search (name, email and more).

Get a contact

Reads one contact profile by its people ID or email address.

List a contact's conversations

Lists the session IDs of conversations with one contact (by people ID or email), 20 a page, optionally only unresolved or resolved ones.

List operators

Lists the workspace's operators (team members).

Reply or add a private note

Sends a message in a conversation as your team: a reply the visitor sees in the chatbox (and by email if they left) or, with note true, a private note only operators see.

Resolve or reopen a conversation

Sets a conversation's state to resolved, unresolved (open) or pending.

Assign a conversation

Assigns a conversation to an operator by their user ID (from List operators), or unassigns it when user_id is left out.

Update a conversation's details

Changes a conversation's subject, the visitor's nickname, email or phone, or its segments (Crisp's tags; the list replaces the current segments, so include the ones to keep).

Create a contact

Adds a contact profile with an email and a name, and optionally a phone, company name, segments and a private notepad.