Development Roadmap
See what's coming in future versions
Getting Started
Installation
Install Chat Rate Pro from the Crisp marketplace. Once installed, the plugin will automatically activate and start collecting ratings when agents mark chats as resolved.
💡 Tip: No configuration needed! The plugin works out of the box. Customers will see rating options immediately after chat resolution.
First Steps
- 1
Install the Plugin
Add Chat Rate Pro from the Crisp marketplace
- 2
Resolve a Chat
Mark any customer conversation as resolved
- 3
Customer Rates
Customer receives rating prompt and clicks stars directly in chat
Screenshot: Chat Rate Pro Rating Interface
[Placeholder - Screenshot coming soon]
Features
Direct Star Rating
Customers can rate their experience with 1-5 stars directly in the chat interface, no external pages needed.
How it Works:
- →Agent marks the chat as resolved
- →Plugin detects resolution via webhook
- →Customer receives picker with 5 clickable star buttons
- →Rating is parsed and saved with conversation metadata
- →Customer receives thank you message
- →Conversation is automatically re-resolved
[Placeholder - Direct Star Rating Interface]
No External Links
Unlike competing plugins, Chat Rate Pro doesn't require external links or redirect customers to other pages.
Advantages:
- →Better user experience - everything happens in chat
- →Higher completion rates - no extra steps required
- →Works seamlessly on mobile and desktop
[Placeholder - No External Links Feature]
WhatsApp Integration
Fully integrated with WhatsApp conversations. Customers rate directly within WhatsApp without leaving the app.
Platform Support:
- →WhatsApp Business integration
- →Crisp chatbot support
- →Web chat widget compatibility
[Placeholder - WhatsApp Integration Demo]
RESTful API with Authentication
Access your rating data programmatically with a secure RESTful API. Laravel Sanctum authentication included.
Available Endpoints:
- →
GET /api/ratings- List all ratings with filters & pagination - →
GET /api/ratings/stats- Get statistics and analytics - →
GET /api/ratings/trend- Track trends over time - →Laravel Sanctum token authentication for security
curl -H "Authorization: Bearer YOUR_TOKEN" \\
https://crisp.craffo.com/api/ratings/stats
Intelligent Rating Parsing
Advanced parsing system recognizes multiple rating formats and languages automatically.
Supported Formats:
- →Numbers: "5", "4", "3", "2", "1"
- →Star Emojis: "⭐⭐⭐⭐⭐"
- →Text: "excellent", "good", "poor"
- →Picker Selections (WhatsApp compatible)
- →Multi-language: English, French, Arabic
Enterprise-Grade Security
Built with security best practices. HMAC-SHA256 signature verification and authenticated API access.
Security Features:
- →HMAC-SHA256 webhook signature verification
- →Laravel Sanctum API token authentication
- →CSRF protection and input validation
- →SQL injection prevention via Eloquent ORM
API Reference
Authentication
All API endpoints require authentication using Laravel Sanctum tokens. Include your token in the Authorization header:
Authorization: Bearer YOUR_API_TOKENGET /api/ratings
List all ratings with filtering and pagination
Query Parameters:
- •
website_id- Filter by Crisp website - •
agent_id- Filter by agent - •
rating- Filter by rating value (1-5) - •
start_date,end_date- Date range - •
per_page- Results per page (max 100)
GET /api/ratings/stats
Get comprehensive statistics and analytics
Returns:
- • Total ratings count
- • Average rating score
- • Rating distribution (1-5 stars)
- • Sentiment analysis (positive/neutral/negative %)
- • Top performing agents
- • Recent ratings
GET /api/ratings/trend
Track rating trends over time
Query Parameters:
- •
group_by- Grouping period (day/week/month) - • Same filters as /api/ratings
Usage Examples
Example 1: Standard Chat Resolution
When an agent successfully resolves a customer inquiry:
- 1. Agent addresses customer's concern
- 2. Agent clicks "Resolve" on the conversation
- 3. Plugin detects resolution and creates rating record
- 4. Customer automatically receives picker with 5 star buttons
- 5. Customer clicks their rating (e.g., "⭐⭐⭐⭐⭐ 5 - Excellent")
- 6. Rating is saved with agent info and conversation metadata
- 7. Customer receives: "Thank you for your feedback! 🙏"
- 8. Conversation is automatically re-resolved
Example 2: WhatsApp Business
For WhatsApp conversations through Crisp:
- 1. Customer chats via WhatsApp Business
- 2. Agent resolves the conversation in Crisp dashboard
- 3. Customer sees rating picker message in WhatsApp
- 4. Customer taps star rating button directly in WhatsApp
- 5. Rating is stored with full conversation metadata
- 6. Thank you message appears in WhatsApp
- 7. No redirects, no external links, no extra apps needed
Example 3: API Data Access
Accessing rating data via the API:
curl -H "Authorization: Bearer YOUR_TOKEN" \\
"https://crisp.craffo.com/api/ratings/stats?website_id=YOUR_WEBSITE"Returns comprehensive statistics including average rating, distribution, sentiment analysis, and top agents.
Need Help?
Our support team is here to help you get the most out of Chat Rate Pro.
Last updated: October 2025