Home > API Center > API interface guide

Brand
Get Started

Message

Voice

 
 

Platform-Initiated Push of Click Records

POST
User-configured HTTP click callback URL
After a user configures the HTTP click callback URL on the Account Management - Application Management page, the platform will proactively push click records for SMS messages sent through the HTTP API to the user-configured URL.
 
Push Parameters
Parameter Description Type
appId Application ID (the appId value on the Account Management - Application Management page) String
orderId The orderId submitted through the API String
msgid The platform msgid corresponding to the submitted mobile number String
mobile Submitted mobile number String
mcc MCC of the mobile number String
mnc MNC of the mobile number String
clickTime Click time String
replacedUrl The actual platform short link delivered String
originalUrl The customer's original link before replacement String
ip Click IP address String
ua User agent of the clicking device String
country Country of the click IP address String
 
Push Example
Request URL:
  User-configured HTTP click callback URL
Request Method: 
  POST
Request Headers:
  Content-Type: application/json;charset=UTF-8
Request Body:
{
    "appId":"4luaKsL2",
    "orderId":"123",
    "msgid":"2108021059531000096",
    "mobile":"91856320003",
    "mcc":"515",
    "mnc":"1",
    "clickTime":"2026.07.03 12:00:00",
    "replacedUrl":"fbcf.cc/abcde",
    "originalUrl":"www.google.com",
    "ip":"1.37.87.20",
    "ua":"Mozilla/5.0 (Linux; Android 14; V2344) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/123.0.6312.118 Mobile Safari/537.36 VivoBrowser/14.7.2.0",
    "country":"Philippines"
},
{
    "appId":"4luaKsL2",
    "orderId":"123",
    "msgid":"2108021059531000096",
    "mobile":"91856321003",
    "mcc":"515",
    "mnc":"1",
    "clickTime":"2026.07.03 12:00:00",
    "replacedUrl":"fbcf.cc/abcde",
    "originalUrl":"www.google.com",
    "ip":"1.37.87.20",
    "ua":"Mozilla/5.0 (Linux; Android 14; V2344) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/123.0.6312.118 Mobile Safari/537.36 VivoBrowser/14.7.2.0",
    "country":"Philippines"
}
 
Response Example

An HTTP 200 response indicates success. The platform does not validate the response content.

PB Status Report Callback Description
Voice Global Status Code

Was this page helpful?

Questions about integration? Contact our technical support

ITNIO TECH API dedicated TG technical support channel, real-time response to your needs

Contact via Telegram