Crisp API: what you can do and how to use it with AI agents
The Crisp REST API lets you read and send messages, manage conversations, contacts and operators, work with the help center, and receive events by webhook. Companies that serve customers through website chat and channels linked to Crisp use it. Access is through a plugin registered in the Crisp marketplace, with a token and approved scopes.
What the Crisp API offers
Conversations
Listing, state, assignment and metadata of conversations.
Messages
Reading and sending messages on behalf of the website.
Contacts
Profiles of people with data and segments.
Operators
The support team and their availability.
Help center
Articles of the help center.
Webhooks and RTM
Events such as a message received, by webhook or in real time.
How to access the Crisp API
- With your company’s credentialsA plugin token (identifier and key) obtained in the Crisp developer marketplace, with approved scopes, installed on the customer's website.
- Plugin scopes go through approval, so ask for the minimum.
- Conversations contain personal data, so handle them under GDPR or your local law.
- Respect the API request limits.
Official documentation: docs.crisp.chat
What an iTeam agent does with the Crisp API
First reply in chat
The agent answers in the website chat based on the help articles and hands over to an operator when the topic calls for it.
Visitor ready to buy
When a visitor asks about plans, the agent qualifies them, records it on the contact and calls the salesperson.
Conversation with no reply
The agent warns the team about open conversations left unanswered past the deadline.
New article from the questions
Frequent questions with no article become drafts for the team to publish.
From the credential to the agent at work, with approval
Create the plugin and request the scopes
In the Crisp marketplace, register the plugin and ask only for the scopes you need.
Install it on the website and store it in the vault
The token stays in the iTeam vault, and the agent replies only in the inboxes it is cleared for.
Test with approval
Start with replies suggested to the operator before replying on its own.
Ready-made AI teams for this work
WhatsApp customer service
Customers write at 11 p.m. and on Sundays. This team replies in seconds, with your prices and policies, and calls a person when it should.
Help desk support team
It reads each ticket, finds the answer in your docs and past replies, and drafts a response your agents can send or improve.
AI phone receptionist
It answers the phone, books the visit in your calendar and sends your team a short note about every call.
Online store support team
It looks up the real order in Shopify or WooCommerce and answers tracking, return and exchange questions in seconds.
Customer success team
It reads usage, tickets and CRM notes every week and tells your team which accounts need a call, and why.
Customer feedback analysis
It reads every comment, finds the themes behind the scores and tells each area what customers are asking it to fix.
Questions about the Crisp API
Is the Crisp API free?
It depends on usage. API and plugin features come with limits and plans, so confirm the current terms with Crisp.
Do I need to code to use the Crisp API with iTeam?
Not necessarily. iTeam's HTTP tool reads the documentation, and the deployment team sets up the workflows.
Can the agent hand a conversation to a person?
Yes. The agent assigns the conversation to an operator and leaves a summary.
