get https://api.imiconnect.io/v2/callstatus/
Response Parameters
| Parameter | Description |
|---|---|
| clientId | The ID of the client (the ID of the tenant in the backend) |
| toType | msisdn - Indicates that an outbound call customer id - Indicates that an outbound call is made to the mobile number associated with the customer id |
| requestTimestamp | The date and time stamp in ISO8601 format at which the request is submitted |
| groupId | The ID of the group to which the user belongs to |
| channel | Voice for all the voice APIs |
| messageId | The unique message id for the transaction on which you are querying the call status |
| description | The description of the status of the API request |
| requestedReceipts | Events for which the user will receive notifications. The events are: Offered: when imiconnect platform offers a call to the network to place a call Accepted: when the network accepts the call offered by imiconnect and places to end-customer Answered: when the end-customer answers the call Dropped: when the call is dropped because of an internal technical error Rejected: when the call gets rejected; it can be due to various reasons like network failure, the customer is busy, rejected by the customer, etc. Released: when the call is ended by the platform Disconnected: when the end-customer disconnects the call Trombone Connected: when the imiconnect platform sends an outbound call to the customer and the customer asks to talk to an agent. The Trombone Connect event occurs when both parties A (end-customer) and B (agent) are connected. Trombone Released: when the party B (agent) exits the call Message Expired: when the call request comes in after the configured expiry time, the request expires. |
| priority | Indicates the call priority: 1-low 2-medium * 3-high |
| version | The version of the messaging API using which the API request is made. 2.0 in this case. |
| callbackData | Data to be sent to the notification Url |
| notifyUrl | The URL at which you want imiconnect Platform to notify about the callback data and the receipts |
| from | The number from which the outbound call is initiated |
| correlationId | The same correlation ID that was used in the call request |
| to | The set of numbers to which the call is initiated |
| direction | Specifies if the call is an outbound call or an inbound call |
| status | The status of the call: Initiated - the call is initiated with the specified mobile numbers Ringing - the call is in ringing state and is not answered yet In-progress - the call is in progress with the specified mobile numbers and is not yet ended Completed - the call is completed successfully Busy - the user's phone is busy and has not answered the call No-answer - the call is initiated from imiconnect but the user has not answered Canceled - the user has rejected the call Failed - the call failed abruptly |
Error Codes
| Error Code | Description |
|---|---|
| 7401 | No answer |
| 7402 | Customer busy |
| 7404 | Others |
| 7406 | Rejected |
| 7407 | Call Offered |
| 7408 | Call Accepted |
| 7409 | Call Dropped |
| 7410 | Disconnected |
| 7411 | Trombone Connected |
| 7412 | Trombone Released |
| 7208 | Message expired |