Download OpenAPI specification:Download
API for managing activity feedback
Retrieve a list of all activity feedback with optional filtering and pagination
| page | integer >= 1 Default: 1 Page number for pagination |
| per_page | integer [ 1 .. 100 ] Default: 25 Number of items per page |
| sort | string Sort field |
| company_namespace | Array of strings Company namespace for filtering |
| activity_type | string Filter by activity type |
| rep | string Filter by representative ID |
| client | string Filter by client ID |
| rating | integer [ 1 .. 5 ] Filter by rating |
| _id | Array of strings Filter by ID |
{- "success": true,
- "data": [
- {
- "_id": "507f1f77bcf86cd799439011",
- "activity_type": "sales_visit",
- "activity_id": "507f1f77bcf86cd799439012",
- "rep": "507f1f77bcf86cd799439013",
- "client": "507f1f77bcf86cd799439014",
- "rating": 4,
- "feedback_text": "Great service, very professional",
- "feedback_categories": [
- "service_quality",
- "timeliness",
- "professionalism"
], - "sentiment": "positive",
- "is_anonymous": false,
- "source": "mobile_app",
- "response_time": 120,
- "attachments": [
- {
- "file_url": "string",
- "file_type": "string",
- "file_size": 0
}
], - "follow_up_required": false,
- "follow_up_notes": "string",
- "company_namespace": [
- "string"
], - "createdAt": "2019-08-24T14:15:22Z",
- "modifiedAt": "2019-08-24T14:15:22Z",
- "SVClient": 0,
- "__v": 0
}
], - "paging": {
- "total": 0,
- "page": 0,
- "per_page": 0,
- "pages": 0
}
}Create a new activity feedback entry
| activity_type required | string Type of activity this feedback is for |
| activity_id | string ID of the related activity |
| rep required | string Representative ID |
| client | string Client ID |
| rating required | integer [ 1 .. 5 ] Feedback rating (1-5 scale) |
| feedback_text | string Detailed feedback text |
| feedback_categories | Array of strings Categories of feedback |
| is_anonymous | boolean Default: false Whether the feedback is anonymous |
| source | string Default: "mobile_app" Enum: "mobile_app" "web_portal" "email" "sms" "phone" Source of the feedback |
| response_time | integer Time taken to provide feedback (in seconds) |
Array of objects | |
| follow_up_required | boolean Default: false Whether follow-up is required |
| follow_up_notes | string Notes for follow-up actions |
| company_namespace | Array of strings Company namespace |
{- "activity_type": "sales_visit",
- "activity_id": "507f1f77bcf86cd799439012",
- "rep": "507f1f77bcf86cd799439013",
- "client": "507f1f77bcf86cd799439014",
- "rating": 4,
- "feedback_text": "Great service, very professional",
- "feedback_categories": [
- "string"
], - "is_anonymous": false,
- "source": "mobile_app",
- "response_time": 0,
- "attachments": [
- {
- "file_url": "string",
- "file_type": "string",
- "file_size": 0
}
], - "follow_up_required": false,
- "follow_up_notes": "string",
- "company_namespace": [
- "string"
]
}{- "success": true,
- "data": {
- "_id": "507f1f77bcf86cd799439011",
- "activity_type": "sales_visit",
- "activity_id": "507f1f77bcf86cd799439012",
- "rep": "507f1f77bcf86cd799439013",
- "client": "507f1f77bcf86cd799439014",
- "rating": 4,
- "feedback_text": "Great service, very professional",
- "feedback_categories": [
- "service_quality",
- "timeliness",
- "professionalism"
], - "sentiment": "positive",
- "is_anonymous": false,
- "source": "mobile_app",
- "response_time": 120,
- "attachments": [
- {
- "file_url": "string",
- "file_type": "string",
- "file_size": 0
}
], - "follow_up_required": false,
- "follow_up_notes": "string",
- "company_namespace": [
- "string"
], - "createdAt": "2019-08-24T14:15:22Z",
- "modifiedAt": "2019-08-24T14:15:22Z",
- "SVClient": 0,
- "__v": 0
}
}Retrieve a specific activity feedback by its ID
| id required | string Activity feedback ID |
{- "success": true,
- "data": {
- "_id": "507f1f77bcf86cd799439011",
- "activity_type": "sales_visit",
- "activity_id": "507f1f77bcf86cd799439012",
- "rep": "507f1f77bcf86cd799439013",
- "client": "507f1f77bcf86cd799439014",
- "rating": 4,
- "feedback_text": "Great service, very professional",
- "feedback_categories": [
- "service_quality",
- "timeliness",
- "professionalism"
], - "sentiment": "positive",
- "is_anonymous": false,
- "source": "mobile_app",
- "response_time": 120,
- "attachments": [
- {
- "file_url": "string",
- "file_type": "string",
- "file_size": 0
}
], - "follow_up_required": false,
- "follow_up_notes": "string",
- "company_namespace": [
- "string"
], - "createdAt": "2019-08-24T14:15:22Z",
- "modifiedAt": "2019-08-24T14:15:22Z",
- "SVClient": 0,
- "__v": 0
}
}Update an existing activity feedback
| id required | string Activity feedback ID |
| rating | integer [ 1 .. 5 ] Feedback rating (1-5 scale) |
| feedback_text | string Detailed feedback text |
| feedback_categories | Array of strings Categories of feedback |
| follow_up_required | boolean Whether follow-up is required |
| follow_up_notes | string Notes for follow-up actions |
| company_namespace | Array of strings Company namespace |
{- "rating": 1,
- "feedback_text": "string",
- "feedback_categories": [
- "string"
], - "follow_up_required": true,
- "follow_up_notes": "string",
- "company_namespace": [
- "string"
]
}{- "success": true,
- "data": {
- "_id": "507f1f77bcf86cd799439011",
- "activity_type": "sales_visit",
- "activity_id": "507f1f77bcf86cd799439012",
- "rep": "507f1f77bcf86cd799439013",
- "client": "507f1f77bcf86cd799439014",
- "rating": 4,
- "feedback_text": "Great service, very professional",
- "feedback_categories": [
- "service_quality",
- "timeliness",
- "professionalism"
], - "sentiment": "positive",
- "is_anonymous": false,
- "source": "mobile_app",
- "response_time": 120,
- "attachments": [
- {
- "file_url": "string",
- "file_type": "string",
- "file_size": 0
}
], - "follow_up_required": false,
- "follow_up_notes": "string",
- "company_namespace": [
- "string"
], - "createdAt": "2019-08-24T14:15:22Z",
- "modifiedAt": "2019-08-24T14:15:22Z",
- "SVClient": 0,
- "__v": 0
}
}Get analytics and statistics for activity feedback
| date_from | string <date> Start date for analytics |
| date_to | string <date> End date for analytics |
| activity_type | string Filter by activity type |
| rep | string Filter by representative ID |
{- "success": true,
- "data": {
- "total_feedback": 0,
- "average_rating": 0,
- "rating_distribution": {
- "1": 0,
- "2": 0,
- "3": 0,
- "4": 0,
- "5": 0
}, - "by_activity_type": {
- "property1": {
- "count": 0,
- "average_rating": 0
}, - "property2": {
- "count": 0,
- "average_rating": 0
}
}
}
}