Overview
Flutter Crisp Chat (crisp_chat) is a Flutter plugin that integrates the Crisp live chat platform into your app on Android, iOS, Web, and desktop (macOS, Windows, Linux). Mobile targets use the official Crisp Android and iOS SDKs; Web and desktop use the official Crisp Web Chat SDK, with the same Dart API for opening chat, sessions, and REST helpers.
Why Crisp Chat?
Crisp is a customer messaging platform used by thousands of companies worldwide. It provides live chat, a shared inbox, knowledge base, and CRM — all in one place. This Flutter plugin brings that experience into your app on mobile, web, and desktop.
What This Plugin Provides
| Feature | Description |
|---|---|
| Open Chat | Launch Crisp chat with one method call (native UI on mobile, web chatbox on web/desktop) |
| User Identification | Set user email, name, phone, avatar, and company details |
| Push Notifications | FCM (Android) and APNs (iOS); not available on Web/desktop |
| Session Management | Set custom session data, segments, and events |
| Unread Messages | Query unread message count via the Crisp REST API |
| Session Control | Get session identifiers and reset sessions on logout |
| Video / audio calls | Optional on iOS (build-time CrispWebRTC SDK); Web/desktop via web chatbox; Android not yet |
| Helpdesk / FAQ | Open the Crisp Helpdesk search screen or a specific article directly (Android, iOS, Web, desktop) |
Supported SDK Versions
| Platform | SDK | Version / source |
|---|---|---|
| Android | Crisp Android SDK | 2.0.23 |
| iOS | Crisp iOS SDK (Crisp or CrispWebRTC) | ~> 2.13.0 — see Enable video calls |
| Web | Crisp Web Chat SDK ($crisp) | Loaded from https://client.crisp.chat/l.js |
| Desktop | Same as Web (embedded WebView) | desktop_webview_window + browser fallback |
Requirements
| Platform | Minimum Version |
|---|---|
| Flutter | 3.24.0+ (3.0+ for mobile-only usage) |
| Dart | 3.5.0+ (2.15.0+ for mobile-only usage) |
| Android | API 23 (Android 6.0) |
| iOS | 13.0+ |
| compileSdkVersion | 36 |
| Web / desktop | See Supported Platforms |
Quick Links
- Installation — Add the package to your project
- Platform Setup — Android, iOS, Web, and desktop (includes optional iOS video calls)
- Supported Platforms — Web and desktop support matrix
- Quick Start — Open your first chat in 5 minutes
- Push Notifications — Set up FCM and APNs
- API Reference — Complete method documentation
- Full Example — Working example app code
Package Links
Next Steps
- Installation — Add the package to your project
- Platform Setup — Android, iOS, Web, and desktop configuration