Download OpenAPI specification:Download
API for managing activity feedback (version 2)
Retrieve a list of all activity feedback v2 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 |
| overall_satisfaction | integer [ 1 .. 10 ] Filter by overall satisfaction rating |
| template_id | string Filter by feedback template ID |
| _id | Array of strings Filter by ID |
{- "success": true,
- "data": [
- {
- "_id": "507f1f77bcf86cd799439011",
- "activity_type": "sales_visit",
- "activity_id": "507f1f77bcf86cd799439012",
- "rep": "507f1f77bcf86cd799439013",
- "client": "507f1f77bcf86cd799439014",
- "template_id": "507f1f77bcf86cd799439015",
- "overall_satisfaction": 8,
- "responses": [
- {
- "question_id": "string",
- "question_text": "string",
- "question_type": "rating",
- "response_value": "string",
- "response_text": "string"
}
], - "nps_score": 9,
- "sentiment_analysis": {
- "overall_sentiment": "very_positive",
- "confidence_score": 1,
- "keywords": [
- "string"
]
}, - "completion_time": 180,
- "completion_rate": 100,
- "session_data": {
- "device_type": "mobile",
- "browser": "string",
- "ip_address": "string",
- "location": {
- "country": "string",
- "city": "string"
}
}, - "follow_up_actions": [
- {
- "action_type": "call",
- "priority": "high",
- "assigned_to": "string",
- "due_date": "2019-08-24",
- "status": "pending"
}
], - "is_anonymous": false,
- "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 v2 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 |
| template_id required | string Feedback template ID used |
| overall_satisfaction required | integer [ 1 .. 10 ] Overall satisfaction rating (1-10 scale) |
Array of objects | |
| nps_score | integer [ 0 .. 10 ] Net Promoter Score (0-10) |
| completion_time | integer Time taken to complete feedback (in seconds) |
object | |
| is_anonymous | boolean Default: false Whether the feedback is anonymous |
| company_namespace | Array of strings Company namespace |
{- "activity_type": "sales_visit",
- "activity_id": "507f1f77bcf86cd799439012",
- "rep": "507f1f77bcf86cd799439013",
- "client": "507f1f77bcf86cd799439014",
- "template_id": "507f1f77bcf86cd799439015",
- "overall_satisfaction": 8,
- "responses": [
- {
- "question_id": "string",
- "question_type": "rating",
- "response_value": "string",
- "response_text": "string"
}
], - "nps_score": 10,
- "completion_time": 0,
- "session_data": {
- "device_type": "mobile",
- "browser": "string",
- "ip_address": "string"
}, - "is_anonymous": false,
- "company_namespace": [
- "string"
]
}{- "success": true,
- "data": {
- "_id": "507f1f77bcf86cd799439011",
- "activity_type": "sales_visit",
- "activity_id": "507f1f77bcf86cd799439012",
- "rep": "507f1f77bcf86cd799439013",
- "client": "507f1f77bcf86cd799439014",
- "template_id": "507f1f77bcf86cd799439015",
- "overall_satisfaction": 8,
- "responses": [
- {
- "question_id": "string",
- "question_text": "string",
- "question_type": "rating",
- "response_value": "string",
- "response_text": "string"
}
], - "nps_score": 9,
- "sentiment_analysis": {
- "overall_sentiment": "very_positive",
- "confidence_score": 1,
- "keywords": [
- "string"
]
}, - "completion_time": 180,
- "completion_rate": 100,
- "session_data": {
- "device_type": "mobile",
- "browser": "string",
- "ip_address": "string",
- "location": {
- "country": "string",
- "city": "string"
}
}, - "follow_up_actions": [
- {
- "action_type": "call",
- "priority": "high",
- "assigned_to": "string",
- "due_date": "2019-08-24",
- "status": "pending"
}
], - "is_anonymous": false,
- "company_namespace": [
- "string"
], - "createdAt": "2019-08-24T14:15:22Z",
- "modifiedAt": "2019-08-24T14:15:22Z",
- "SVClient": 0,
- "__v": 0
}
}Retrieve a specific activity feedback v2 by its ID
| id required | string Activity feedback v2 ID |
{- "success": true,
- "data": {
- "_id": "507f1f77bcf86cd799439011",
- "activity_type": "sales_visit",
- "activity_id": "507f1f77bcf86cd799439012",
- "rep": "507f1f77bcf86cd799439013",
- "client": "507f1f77bcf86cd799439014",
- "template_id": "507f1f77bcf86cd799439015",
- "overall_satisfaction": 8,
- "responses": [
- {
- "question_id": "string",
- "question_text": "string",
- "question_type": "rating",
- "response_value": "string",
- "response_text": "string"
}
], - "nps_score": 9,
- "sentiment_analysis": {
- "overall_sentiment": "very_positive",
- "confidence_score": 1,
- "keywords": [
- "string"
]
}, - "completion_time": 180,
- "completion_rate": 100,
- "session_data": {
- "device_type": "mobile",
- "browser": "string",
- "ip_address": "string",
- "location": {
- "country": "string",
- "city": "string"
}
}, - "follow_up_actions": [
- {
- "action_type": "call",
- "priority": "high",
- "assigned_to": "string",
- "due_date": "2019-08-24",
- "status": "pending"
}
], - "is_anonymous": false,
- "company_namespace": [
- "string"
], - "createdAt": "2019-08-24T14:15:22Z",
- "modifiedAt": "2019-08-24T14:15:22Z",
- "SVClient": 0,
- "__v": 0
}
}Update an existing activity feedback v2
| id required | string Activity feedback v2 ID |
| overall_satisfaction | integer [ 1 .. 10 ] Overall satisfaction rating (1-10 scale) |
Array of objects | |
| nps_score | integer [ 0 .. 10 ] Net Promoter Score (0-10) |
Array of objects | |
| company_namespace | Array of strings Company namespace |
{- "overall_satisfaction": 1,
- "responses": [
- {
- "question_id": "string",
- "question_type": "rating",
- "response_value": "string",
- "response_text": "string"
}
], - "nps_score": 10,
- "follow_up_actions": [
- {
- "action_type": "call",
- "priority": "high",
- "assigned_to": "string",
- "due_date": "2019-08-24",
- "status": "pending"
}
], - "company_namespace": [
- "string"
]
}{- "success": true,
- "data": {
- "_id": "507f1f77bcf86cd799439011",
- "activity_type": "sales_visit",
- "activity_id": "507f1f77bcf86cd799439012",
- "rep": "507f1f77bcf86cd799439013",
- "client": "507f1f77bcf86cd799439014",
- "template_id": "507f1f77bcf86cd799439015",
- "overall_satisfaction": 8,
- "responses": [
- {
- "question_id": "string",
- "question_text": "string",
- "question_type": "rating",
- "response_value": "string",
- "response_text": "string"
}
], - "nps_score": 9,
- "sentiment_analysis": {
- "overall_sentiment": "very_positive",
- "confidence_score": 1,
- "keywords": [
- "string"
]
}, - "completion_time": 180,
- "completion_rate": 100,
- "session_data": {
- "device_type": "mobile",
- "browser": "string",
- "ip_address": "string",
- "location": {
- "country": "string",
- "city": "string"
}
}, - "follow_up_actions": [
- {
- "action_type": "call",
- "priority": "high",
- "assigned_to": "string",
- "due_date": "2019-08-24",
- "status": "pending"
}
], - "is_anonymous": false,
- "company_namespace": [
- "string"
], - "createdAt": "2019-08-24T14:15:22Z",
- "modifiedAt": "2019-08-24T14:15:22Z",
- "SVClient": 0,
- "__v": 0
}
}Get detailed analytics and insights for activity feedback v2
| 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 |
| template_id | string Filter by feedback template ID |
{- "success": true,
- "data": {
- "summary": {
- "total_feedback": 0,
- "average_satisfaction": 0,
- "response_rate": 0
}, - "satisfaction_trends": [
- {
- "date": "2019-08-24",
- "average_satisfaction": 0,
- "count": 0
}
], - "question_analysis": [
- {
- "question_id": "string",
- "question_text": "string",
- "average_score": 0,
- "response_count": 0
}
]
}
}