Update Extra Field Values for specific Call Logs.
Endpoint:
POST https://api.convoso.com/v1/log/update
đź”’ Authentication
- Parameter Name: auth_token
- Type: Query Parameter
- Required: Yes
🔍 Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| auth_token | string | âś… Yes | Your API authentication token. |
| call_log_id | string | âś… Yes | Call Log Identifier |
| extra_field_01 | string | ❌ No | Value to enter in extra field 1 |
| extra_field_02 | string | ❌ No | Value to enter in extra field 2 |
Example Request
POST https://api.convoso.com/v1/log/update?auth_token=YOUR_API_TOKEN&call_log_id=999999&extra_field_01=&extra_field_02=
Response Format
{
"success": true,
}Response Descriptions
Top-Level Request Metadata
| Field | Type | Description |
|---|---|---|
| success | boolean | Indicates whether the request was successful. |
Call Log Results Object
| Field | Type | Description |
|---|---|---|
| id | string | Unique identifier for the call log entry. |
| lead_id | string | ID of the associated lead. |
| list_id | string | ID of the lead list. |
| campaign_id | string | ID of the campaign. |
| campaign | string | Name of the campaign. |
| user | string | Full name or label of the user (agent). |
| user_id | string | ID of the agent/user. |
| phone_number | string | Phone number of the lead. |
| number_dialed | string | Number that was dialed. |
| first_name | string | First name of the lead. |
| last_name | string | Last name of the lead. |
| status | string | Call status code (e.g., HU for Hang Up). |
| status_name | string | Human-readable name of the call status. |
| call_length | string | Duration of the call in seconds. |
| call_date | string | Timestamp when the call occurred (YYYY-MM-DD HH:MM:SS). |
| agent_comment | string | Optional comment added by the agent. |
| recording | array[object] | Array of recording objects (see sub-table below). |
| queue_id | string/null | ID of the queue (if applicable). |
| called_count | string | Number of times this lead has been called. |
| caller_id_displayed | string | Caller ID number shown to the lead. |
| term_reason | string | Reason the call ended (e.g., CALLER). |
| call_type | string | Type of call (OUTBOUND, INBOUND). |
| queue_position | string | Lead’s position in the queue (if applicable). |
| queue_seconds | string | Time in seconds the lead waited in the queue. |
| originating_agent_id | string/null | ID of the originating agent (if any). |
| session_id | string | SIP session ID associated with the call. |
Recording Object Structure
| Field | Type | Description |
|---|---|---|
| src | string | Internal source path of the recording. |
| type | string | Type of recording (e.g., pause). |
| new | string | Whether it's a new recording (yes). |
| recording_id | string | Unique ID of the recording. |
| filename | string | File name of the recording. |
| public_url | string | Publicly accessible URL for playback/download of the recording. |