Search Results

Vendor Emulators

As a value-add, Aerialink supports formats for other aggregators in order to make customer migration to Aerialink as smooth as possible. The articles on this page provide documentation dedicated to specified vendors.

Vonage Emulator (SMS-Only)

Endpoint: apix5.aerialink.net/v5/messages/v/

The following table depicts the Aerialink parameter on the left and the equivalent Vonage parameter on the right.

Aerialink FieldVonage Field
sourcefrom
destinationto
messageTexttext
registeredDeliverystatus-report-req
dcsmessage-class

Unsupported Vonage Parameters

The following Vonage parameters are not supported by Aerialink:

  • ttl
  • callback
  • type
  • body
  • udh
  • protocol-id
  • client-ref
  • account-ref
  • entity-id
  • content-id

Vonage Emulator Response Samples

Outbound (MT) Samples

Vonage Sample MT Success

{
   "message-count": "1",
   "messages": [
      {
         "to": "12345678910",
                 "message-id": "f99d106a-9d3b-4b37-9278-b491f719c3a7",
       "status": "0",
       "remaining-balance": "1.97015000",
       "message-price": "0.15000000",
       "network": "310090"
         "client-ref": "my-personal-reference",
         "account-ref": "customer1234"
      }
   ]
}

Vonage Sample MT Error

{
     "message-count": "1",
     "messages": [
             {
                     "status": "2",
                     "error-text": "Missing from param"
             }
     ]
}

Inbound (MO) Message Samples

Vonage Sample MO

{
 "api-key": "abcd1234",
 "msisdn": "447700900001",
 "to": "447700900000",
 "messageId": "aaaaaaaa-bbbb-cccc-dddd-0123456789ab",
 "text": "Hello world",
 "type": "text",
 "keyword": "HELLO",
 "message-timestamp": {},
 "timestamp": "1578787200",
 "nonce": "aaaaaaaa-bbbb-cccc-dddd-0123456789ab",
 "concat": "true",
 "concat-ref": "1",
 "concat-total": "3",
 "concat-part": "2",
 "data": "string",
 "udh": "string"
}

Aerialink Emulated MO

/?connectionGUID=C8CE34EF-8768-465F-B0B3-1A2650DDAEC7&sourceCountry=United%20States%20of%20America%20or%20Canada&sourceCountryCode=1&sourceCountryAbbreviation=US&sourceNational=5635083351&concatenatedMessageSegmentHash=0a97beccb248bf5ab4ff978fa687d2fd3f68b03758d0053d61dba7457aec6865&apiKey=secure&msisdn=N%2FA&to=13192195227&from=15635083351&messageID=ffa06d43-7a12-4395-802d-1f4319116697&text=y%20to%20central%20Georgia%2C%20subfreezing%20overnight%20temperatures%20could%20create%20icy%20patches%20in%20places%20where%20winter%20storms%20occurred.&type=text&keyword=N%2FA&timestamp=1738183883112&nonce=N%2FA&concat=true&concatRef=bd&concatTotal=02&concatPart=02&data=7920746f2063656e7472616c2047656f726769612c20737562667265657a696e67206f7665726e696768742074656d70657261747572657320636f756c642063726561746520696379207061746368657320696e20706c616365732077686572652077696e7465722073746f726d73206f636375727265642e&udh=050003bd0202
    {
    connectionGUID: "C8CE34EF-8768-465F-B0B3-1A2650DDAEC7",
    sourceCountry: "United%20States%20of%20America%20or%20Canada",
    sourceCountryCode: 1,
    sourceCountryAbbreviation: "US",
    sourceNational: "5635083351",
    apiKey: "secure",
    msisdn: "N/A",
    to: "13192195227",
    from: "15635083351",
    messageID: "7f9ad4da-3d0f-4373-8204-c98c1d10ae85",
    text: "test text",
    type: "text",
    keyword: "N/A",
    timestamp: 1738183429056,
    nonce: "N/A",
    concat: "true",
    concatRef: "26",
    concatTotal: "2",
    concatPart: "2",
    data: "0x7920746f2063656e7472616c2047656f726769612c20737562667265657a696e67206f7665726e696768742074656d70657261747572657320636f756c642063726561746520696379207061746368657320696e20706c616365732077686572652077696e7465722073746f726d73206f636375727265642e",
    udh: "0x050003bd0202"
    }

Inbound Delivery Receipt (DLR) Samples

Vonage DLR

{
   "msisdn": "447700900000",
   "to": "AcmeInc",
   "network-code": "12345",
   "messageId": "0A0000001234567B",
   "price": "0.15000000",
   "status": "delivered",
   "scts": "2001011400",
   "err-code": "0",
   "api-key": "abcd1234",
   "message-timestamp": "2020-01-01 12:00:00"
}

Aerialink Emulated DLR

{
  "connectionGUID": "62eba45f-cc04-4fa3-8e96-96c0978e4576",
  "source": "13097212689",
  "sourceCountry": "United States of America or Canada",
  "sourceCountryCode": "1",
  "sourceCountryAbbreviation": "US",
  "sourceNational": "3097212689",
  "concatenatedMessage": false,
  "messageText": "id:3b1f9be7-2dce-49ad-b179-7b6e357e78ce sub:000 dlvrd:000 submit date:2502101612 done date:2502101612 stat:DELIVRD err:000 text:rk jk ext sahljdhasl",
  "msisdn": "N/A",
  "to": "13192195227",
  "from": "13097212689",
  "networkCode": "N/A",
  "messageID": "0e9baa51-7007-46d7-8585-285f60a4a2da",
  "price": "N/A",
  "status": "delivered",
  "scts": "N/A",
  "errCode": "N/A"
}

JSON DLR Sample

forwardData: {  
     connectionGUID: 'C8CE34EF-8768-465F-B0B3-1A2650DDAEC7',
     source: '12345678910',
     sourceCountry: 'United States of America or Canada',
     sourceCountryCode: 1,
     sourceCountryAbbreviation: 'US',
     sourceNational: '2345678910',
     concatenatedMessage: false,
     messageText: 'id:143c94ea-ff9b-48ff-be40-b88c8d57ac44 sub:000 dlvrd:000 submit date:2503191443 done date:2503191443 stat:UNDELIV err:00B text:hey there',
     msisdn: 'N/A',
     to: '12223334444',
     from: '12345678910',
     networkCode: 'N/A',
     messageID: 'b5e225e6-7c0c-419c-9308-fd43a2803739',
     price: 'N/A',
     status: 'undelivered',
     scts: 'N/A',
     errCode: 'N/A',
     dlr: {  
         id: '143c94ea-ff9b-48ff-be40-b88c8d57ac44',
         sub: '000',
         dlvrd: '000',
         submit_date: '2503191443',
         done_date: '2503191443',
         stat: 'UNDELIV',
         err: '00B',
         text: 'hey there'
        }
    }

Vonage Emulator Error Codes

The following is a non-exhaustive list of error codes which may be encountered when using the Vonage-to-Aerialink emulator API. The Aerialink Vonage Emulator only supports error codes 1-5. Any error code past 5 will show up as “5.”

CodeDefinitionDescriptionRemediation
1ThrottledSMS send rate exceeds account limitsRefer to Vonage Documentation.
2Missing ParametersRequest missing one or more of the following required parameters:
- ‘from’
- ‘to’
- ‘api_key’
- ‘api_secret’
- ‘text’
Check parameters and retry
3Invalid ParametersThe value of one or more parameters is invalidCheck parameters and retry.
4Invalid CredentialsAPI key and/or secret incorrect, invalid or disabledCheck credentials on Vonage Dashboard
5Internal ErrorAn error occurred in the Vonage platform during message processingContact Vonage Support