> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Crisp

> Crisp is a customer messaging platform for managing conversations, contacts, operators, helpdesk content, campaigns, and workspace settings.

![Crisp logo](https://mintcdn.com/composio-preview/NPf8agM6UrvZD-Iu/images/toolkits/crisp.svg?fit=max\&auto=format\&n=NPf8agM6UrvZD-Iu\&q=85\&s=5df553a3d77cafa8cd782273268c8b1d)

* **Category:** customer support
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 12
* **Triggers:** 0
* **Slug:** `CRISP`
* **Version:** 20261030\_00

## Tools

> [accordion] Assign Conversation
>
> **Slug:** `CRISP_ASSIGN_CONVERSATION`
>
> Assign a conversation to one operator or explicitly remove its current operator assignment.
>
> #### Input Parameters
>
> **silent** `boolean`
>
> If true, do not notify the newly assigned operator.
>
> **operation** `string ("assign" | "unassign")` *required*
>
> Whether to assign an operator or remove the current assignment.
>
> **session\_id** `string` *required*
>
> Crisp session ID of the conversation.
>
> **operator\_id** `string`
>
> Operator user ID to assign. Required for assign and omitted for unassign.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Conversation
>
> **Slug:** `CRISP_GET_CONVERSATION`
>
> Get one conversation's status, assignment, inbox, visitor metadata, unread counts, and latest-message summary.
>
> #### Input Parameters
>
> **session\_id** `string` *required*
>
> Crisp session ID of the conversation to retrieve.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get People Profile
>
> **Slug:** `CRISP_GET_PEOPLE_PROFILE`
>
> Get one customer profile by its Crisp people ID or exact email address.
>
> #### Input Parameters
>
> **email** `string`
>
> Exact email address of the profile to retrieve. Supply exactly one of email or people\_id.
>
> **people\_id** `string`
>
> Crisp people ID of the profile to retrieve. Supply exactly one of people\_id or email.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Conversation Messages
>
> **Slug:** `CRISP_LIST_CONVERSATION_MESSAGES`
>
> Return a batch of messages from a conversation, optionally before, after, or around one millisecond timestamp.
>
> #### Input Parameters
>
> **session\_id** `string` *required*
>
> Crisp session ID of the conversation.
>
> **timestamp\_after** `integer`
>
> Return a newer batch starting after this Unix timestamp in milliseconds.
>
> **timestamp\_around** `integer`
>
> Return a batch centered around this Unix timestamp in milliseconds.
>
> **timestamp\_before** `integer`
>
> Return an older batch ending before this Unix timestamp in milliseconds.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Conversations
>
> **Slug:** `CRISP_LIST_CONVERSATIONS`
>
> List or search workspace conversations with support-focused filters, one page at a time.
>
> #### Input Parameters
>
> **sort\_by** `string ("created_at" | "updated_at" | "waiting_since")`
>
> Optional ordering. waiting\_since also excludes conversations that are not waiting.
>
> **inbox\_id** `string`
>
> Return only conversations in this inbox. Omit to search all inboxes.
>
> **per\_page** `integer`
>
> Conversations per page (20-50).
>
> **resolution** `string ("resolved" | "not_resolved")`
>
> Filter by whether the conversation is resolved.
>
> **page\_number** `integer`
>
> Page to return, starting at 1.
>
> **search\_type** `string ("text" | "segment")`
>
> How Crisp should interpret search\_query. Required when search\_query is set; omit both for no search.
>
> **unread\_only** `boolean`
>
> Return only conversations with unread operator messages.
>
> **search\_query** `string`
>
> Text or segment name to search for, according to search\_type.
>
> **include\_empty** `boolean`
>
> Include conversations that have no messages.
>
> **updated\_after** `string`
>
> Only conversations updated at or after this ISO 8601 timestamp.
>
> **mentioned\_only** `boolean`
>
> Return only conversations containing an operator mention.
>
> **updated\_before** `string`
>
> Only conversations updated at or before this ISO 8601 timestamp.
>
> **unassigned\_only** `boolean`
>
> Return only conversations with no assigned operator. Cannot be combined with assigned\_operator\_id.
>
> **assigned\_operator\_id** `string`
>
> Return only conversations assigned to this operator user ID.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Inboxes
>
> **Slug:** `CRISP_LIST_INBOXES`
>
> List configured Crisp inboxes and their operator/team membership, one page at a time.
>
> #### Input Parameters
>
> **page\_number** `integer`
>
> Page to return, starting at 1.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Operators
>
> **Slug:** `CRISP_LIST_OPERATORS`
>
> List workspace operators and pending members with their IDs, roles, and current availability.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List People Profiles
>
> **Slug:** `CRISP_LIST_PEOPLE_PROFILES`
>
> List or search customer profiles by text, creation date, and sort order, one page at a time.
>
> #### Input Parameters
>
> **per\_page** `integer`
>
> Profiles per page (20-50).
>
> **sort\_field** `string`
>
> Crisp profile field to sort by, such as nickname or created\_at.
>
> **sort\_order** `string ("ascending" | "descending")`
>
> Sort direction; omit to use Crisp's default direction.
>
> **page\_number** `integer`
>
> Page to return, starting at 1.
>
> **search\_text** `string`
>
> Quick-search text such as a name or email.
>
> **created\_after** `string`
>
> Only profiles created at or after this ISO 8601 timestamp.
>
> **created\_before** `string`
>
> Only profiles created at or before this ISO 8601 timestamp.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Move Conversation to Inbox
>
> **Slug:** `CRISP_MOVE_CONVERSATION_TO_INBOX`
>
> Move a conversation to a specific Crisp inbox, or remove its inbox categorization when inbox\_id is null.
>
> #### Input Parameters
>
> **inbox\_id** `string` *required*
>
> Destination inbox ID, or null to remove inbox categorization.
>
> **session\_id** `string` *required*
>
> Crisp session ID of the conversation.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Send Conversation Message
>
> **Slug:** `CRISP_SEND_CONVERSATION_MESSAGE`
>
> Send a visitor-visible text reply to an existing Crisp conversation immediately; this external communication is irreversible.
>
> #### Input Parameters
>
> **origin** `string`
>
> Delivery origin matching the conversation channel: chat, email, or a Crisp URN such as urn:crisp.im:slack:0.
>
> **content** `string` *required*
>
> Plain-text reply visible to the visitor.
>
> **mentions** `array`
>
> Operator or team IDs to mention in the message.
>
> **session\_id** `string` *required*
>
> Crisp session ID of the conversation to reply to.
>
> **fingerprint** `integer`
>
> Optional unique message fingerprint for caller-managed duplicate prevention.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Conversation Meta
>
> **Slug:** `CRISP_UPDATE_CONVERSATION_META`
>
> Update support-relevant visitor details, subject, segments, or custom data on a conversation without replacing unspecified fields. Provide at least one field to update.
>
> #### Input Parameters
>
> **email** `string`
>
> Visitor email address. Omit to leave unchanged.
>
> **phone** `string`
>
> Visitor phone number. Omit to leave unchanged.
>
> **address** `string`
>
> Visitor postal address. Omit to leave unchanged.
>
> **subject** `string`
>
> Conversation subject. Supply null only when explicitly clearing the subject.
>
> **nickname** `string`
>
> Visitor display name. Omit to leave unchanged.
>
> **segments** `array`
>
> Complete segment list to associate with the conversation. Omit to leave unchanged.
>
> **session\_id** `string` *required*
>
> Crisp session ID of the conversation.
>
> **custom\_data** `object`
>
> Custom visitor data object to store as Crisp meta data. Omit to leave unchanged.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Conversation State
>
> **Slug:** `CRISP_UPDATE_CONVERSATION_STATE`
>
> Set a conversation to pending, unresolved, or resolved.
>
> #### Input Parameters
>
> **state** `string ("pending" | "unresolved" | "resolved")` *required*
>
> New support state for the conversation.
>
> **session\_id** `string` *required*
>
> Crisp session ID of the conversation to update.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
