Skip to main content
Crisp logo
  • Category: customer support
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 12
  • Triggers: 0
  • Slug: CRISP
  • Version: 20261030_00

Tools

Slug: CRISP_ASSIGN_CONVERSATIONAssign a conversation to one operator or explicitly remove its current operator assignment.

Input Parameters

boolean
If true, do not notify the newly assigned operator.
string ("assign" | "unassign")
required
Whether to assign an operator or remove the current assignment.
string
required
Crisp session ID of the conversation.
string
Operator user ID to assign. Required for assign and omitted for unassign.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CRISP_GET_CONVERSATIONGet one conversation’s status, assignment, inbox, visitor metadata, unread counts, and latest-message summary.

Input Parameters

string
required
Crisp session ID of the conversation to retrieve.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CRISP_GET_PEOPLE_PROFILEGet one customer profile by its Crisp people ID or exact email address.

Input Parameters

string
Exact email address of the profile to retrieve. Supply exactly one of email or people_id.
string
Crisp people ID of the profile to retrieve. Supply exactly one of people_id or email.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CRISP_LIST_CONVERSATION_MESSAGESReturn a batch of messages from a conversation, optionally before, after, or around one millisecond timestamp.

Input Parameters

string
required
Crisp session ID of the conversation.
integer
Return a newer batch starting after this Unix timestamp in milliseconds.
integer
Return a batch centered around this Unix timestamp in milliseconds.
integer
Return an older batch ending before this Unix timestamp in milliseconds.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CRISP_LIST_CONVERSATIONSList or search workspace conversations with support-focused filters, one page at a time.

Input Parameters

string ("created_at" | "updated_at" | "waiting_since")
Optional ordering. waiting_since also excludes conversations that are not waiting.
string
Return only conversations in this inbox. Omit to search all inboxes.
integer
Conversations per page (20-50).
string ("resolved" | "not_resolved")
Filter by whether the conversation is resolved.
integer
Page to return, starting at 1.
string ("text" | "segment")
How Crisp should interpret search_query. Required when search_query is set; omit both for no search.
boolean
Return only conversations with unread operator messages.
string
Text or segment name to search for, according to search_type.
boolean
Include conversations that have no messages.
string
Only conversations updated at or after this ISO 8601 timestamp.
boolean
Return only conversations containing an operator mention.
string
Only conversations updated at or before this ISO 8601 timestamp.
boolean
Return only conversations with no assigned operator. Cannot be combined with assigned_operator_id.
string
Return only conversations assigned to this operator user ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CRISP_LIST_INBOXESList configured Crisp inboxes and their operator/team membership, one page at a time.

Input Parameters

integer
Page to return, starting at 1.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CRISP_LIST_OPERATORSList workspace operators and pending members with their IDs, roles, and current availability.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CRISP_LIST_PEOPLE_PROFILESList or search customer profiles by text, creation date, and sort order, one page at a time.

Input Parameters

integer
Profiles per page (20-50).
string
Crisp profile field to sort by, such as nickname or created_at.
string ("ascending" | "descending")
Sort direction; omit to use Crisp’s default direction.
integer
Page to return, starting at 1.
string
Quick-search text such as a name or email.
string
Only profiles created at or after this ISO 8601 timestamp.
string
Only profiles created at or before this ISO 8601 timestamp.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CRISP_MOVE_CONVERSATION_TO_INBOXMove a conversation to a specific Crisp inbox, or remove its inbox categorization when inbox_id is null.

Input Parameters

string
required
Destination inbox ID, or null to remove inbox categorization.
string
required
Crisp session ID of the conversation.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CRISP_SEND_CONVERSATION_MESSAGESend a visitor-visible text reply to an existing Crisp conversation immediately; this external communication is irreversible.

Input Parameters

string
Delivery origin matching the conversation channel: chat, email, or a Crisp URN such as urn:crisp.im:slack:0.
string
required
Plain-text reply visible to the visitor.
array
Operator or team IDs to mention in the message.
string
required
Crisp session ID of the conversation to reply to.
integer
Optional unique message fingerprint for caller-managed duplicate prevention.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CRISP_UPDATE_CONVERSATION_METAUpdate 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

string
Visitor email address. Omit to leave unchanged.
string
Visitor phone number. Omit to leave unchanged.
string
Visitor postal address. Omit to leave unchanged.
string
Conversation subject. Supply null only when explicitly clearing the subject.
string
Visitor display name. Omit to leave unchanged.
array
Complete segment list to associate with the conversation. Omit to leave unchanged.
string
required
Crisp session ID of the conversation.
object
Custom visitor data object to store as Crisp meta data. Omit to leave unchanged.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CRISP_UPDATE_CONVERSATION_STATESet a conversation to pending, unresolved, or resolved.

Input Parameters

string ("pending" | "unresolved" | "resolved")
required
New support state for the conversation.
string
required
Crisp session ID of the conversation to update.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not