API & DOCS

My Account            

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

https://secure.dialogtech.com/ibp_api.php

Parameter List

ParameterRequiredAcceptsMax LengthNotesUsage
actionYesString: sms.register_numbern/aOnly accepts sms.register_number to register a tracking number as SMS capableDefines the API Call as "SMS Register Number" type
access_keyYesStringn/aAccess Key from the Key Manager within a DialogTech accountCredentials used for access to the API for a particular DialogTech account
secret_access_keyYesStringn/aSecret Access Key from the Key Manager within a DialogTech accountCredentials used for access to the API for a particular DialogTech account
numberYesString: Unformatted Phone Number10Local phone number* from within a DialogTech account which is hosted with an SMS-capable carrierDefines which phone number is being enabled for SMS
urlNoString URL1024URL which inbound SMS content will be forwarded toWhen receiving an SMS, DialogTech can forward the SMS to a URL
dlr_urlNoString URL1024URL which DLR conent generated from outbound SMS will be forwarded toWhen 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 NameDescription
from_numberThe Caller ID of the number which sent an SMS to a tracking number
to_numberThe tracking number which was sent an SMS
messageThe 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 NameDescription
uuidThe unique identifier for the outgoing SMS within DialogTech that has an association with this DLR message.
from_numberThe 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_numberThe 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_statusA 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_textThe raw DLR payload as delivered to us by the carrier involved on behalf of the outgoing SMS sent by the SMS Send Message API.