API used to enable SMS on a DialogTech tracking number
NOTICE
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.
Use the SMS Register Number API to enable SMS
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
Parameter List
Parameter | Required | Accepts | Max Length | Notes | Usage |
---|---|---|---|---|---|
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.
Using this API
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 ""
Example Response
<?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>[5556667777] Registered</result_description>
</response>
Forwarding SMS from DialogTech
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.
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 from_number to the to_number |
Forwarding SMS DLR from DialogTech
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 dlr_url
parameter.
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. |