Not all numbers on the DialogTech platform are capable of sending/receiving SMS
DialogTech is partners with many top-tier carriers to handle call and SMS traffic around the world. Unfortunately, not every one of these partners is capable of sending/receiving SMS. This means not every number on the DialogTech platform is capable of sending/receiving SMS. If you need help ensuring the number you're wanting to use, is SMS capable, please reach out to our Customer Support Team at [email protected] or by calling (877) 295-5100.
The SMS Register Number API is used to enable SMS functionality for a tracking number within a DialogTech account.
Base URL for SMS Register Number
|action||Yes||String: sms.register_number||n/a||Only accepts sms.register_number to register a tracking number as SMS capable||Defines the API Call as "SMS Register Number" type|
|access_key||Yes||String||n/a||Access Key from the Key Manager within a DialogTech account||Credentials used for access to the API for a particular DialogTech account|
|secret_access_key||Yes||String||n/a||Secret Access Key from the Key Manager within a DialogTech account||Credentials used for access to the API for a particular DialogTech account|
|number||Yes||String: Unformatted Phone Number||10||Local phone number* from within a DialogTech account which is hosted with an SMS-capable carrier||Defines which phone number is being enabled for SMS|
|url||No||String URL||1024||URL which inbound SMS content will be forwarded to||When receiving an SMS, DialogTech can forward the SMS to a URL|
|dlr_url||No||String URL||1024||URL which DLR conent generated from outbound SMS will be forwarded to||When receiving DLR for an SMS, DialogTech can forward the DLR to a URL|
*Tollfree SMS is available by contacting your account manager or by reaching out to DialogTech's Customer Support Team.
These code examples are meant to show a basic method of using DialogTech's SMS Register Number API
<?php https://secure.dialogtech.com/ibp_api.php?access_key=ACCESS_KEY&secret_access_key=SECRET_ACCESS_KEY&action=sms.register_number&number=5556667777&url=http://example.net/sms_listener.php&dlr_url=http://www.example.net/dlr_listener.php ?>
curl -X ""
<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE response [ <!ELEMENT response (result,result_description)> <!ELEMENT result (#PCDATA)> <!ELEMENT result_description (#PCDATA)> ]> <response> <result>success</result> <result_description> Registered</result_description> </response>
DialogTech has the ability to forward the message received via SMS via a DialogTech SMS enabled tracking number, to a web-service by utilizing URL Parameters. The destination DialogTech will forward these messages to should be provided when using the SMS Register Number API and the available
|URL Parameter Name||Description|
|from_number||The Caller ID of the number which sent an SMS to a tracking number|
|to_number||The tracking number which was sent an SMS|
|message||The message sent from the |
DialogTech also has the ability to forward all DLR content received for each outbound SMS sent via a DialogTech SMS enabled tracking number, to a web-service by utilizing URL parameters. The destination DialogTech will forward these DLR to should be provided when using the SMS Register Number API and the available
|URL Parameter Name||Description|
|uuid||The unique identifier for the outgoing SMS within DialogTech that has an association with this DLR message.|
|from_number||The original destination (to) of the outgoing SMS sent by the SMS Send Message API which this DLR associates, acts as a surrogate caller ID.|
|to_number||The original destination (to) of the outgoing SMS sent by the SMS Send Message API which this DLR associates, acts as a surrogate DialogTech tracking number.|
|dlr_status||A numerical classification type of each DLR received on behalf of the outgoing SMS sent by the SMS Send Message API. This will common be one of:|
2 - Message failed delivery
4 - Message queued by carrier for delivery
8 - Message sent to carrier for delivery
|dlr_text||The raw DLR payload as delivered to us by the carrier involved on behalf of the outgoing SMS sent by the SMS Send Message API.|