Trackly SMS receives delivery status updates from SMS providers via internal webhook endpoints. These are configured on the provider side to send delivery reports back to Trackly — they are not user-configurable webhooks.
These webhook endpoints are internal. They are configured by Trackly within each SMS provider’s dashboard so that delivery reports are routed back to the platform. You do not need to configure these yourself.
Webhook URLs Each SMS provider has a dedicated webhook endpoint:
Provider Webhook URL Infobip https://app.tracklysms.com/api/webhook-feedbacks/infobip?account={account_id}CM https://app.tracklysms.com/api/webhook-feedbacks/cm?account={account_id}Twilio https://app.tracklysms.com/api/webhook-feedbacks/twilio?account={account_id}Lime https://app.tracklysms.com/api/webhook-feedbacks/lime?account={account_id}
Query Parameters The Trackly account ID associated with the delivery report. This parameter is included in the webhook URL so Trackly can route the delivery status to the correct account.
Webhook Payload Infobip sends delivery status updates in the following format:
{ "results" : [ { "messageId" : "msg_abc123def456" , "to" : "+14155551234" , "status" : { "groupId" : 3 , "groupName" : "DELIVERED" , "id" : 5 , "name" : "DELIVERED_TO_HANDSET" }, "doneAt" : "2024-01-15T10:30:00.000+0000" } ] }
Status Groups Infobip uses status groups to categorize delivery outcomes:
Group ID Group Name Description 1 PENDINGMessage is being processed 2 UNDELIVERABLEMessage could not be delivered 3 DELIVEREDMessage was delivered successfully 4 EXPIREDMessage expired before delivery 5 REJECTEDMessage was rejected by carrier
Common Status Codes Delivered (Group 3) ID Name Description 5 DELIVERED_TO_HANDSETDelivered to recipient’s phone 6 DELIVERED_TO_OPERATORDelivered to carrier (no handset confirmation)
Undeliverable (Group 2) ID Name Description 7 REJECTED_ABSENT_SUBSCRIBERRecipient not available 9 REJECTED_SYSTEM_ERRORSystem error 14 REJECTED_OPERATORRejected by carrier 15 REJECTED_DUPLICATEDuplicate message
Rejected (Group 5) ID Name Description 51 REJECTED_SPAMMessage flagged as spam 52 REJECTED_DESTINATIONInvalid destination
Receiving Alerts Instead of polling for status updates, you can receive real-time alerts in Discord:
Discord Alerts Get notified of delivery failures in real-time
Configure Alerts Customize which alerts you receive
Alert Types When delivery failures occur, you can receive alerts via Discord:
Alert Type Trigger Delivery Failure Message status is UNDELIVERABLE or REJECTED Spam Complaint Message flagged as spam (status 51) Opt-Out Recipient replied STOP
See Discord Alerts for configuration details.
Response The Trackly webhook endpoint returns a 200 OK response to acknowledge receipt:
If the webhook returns an error status, the SMS provider may retry the request. Trackly’s endpoints are designed to handle retries idempotently.
