B4X

Clickatell Send SMS Text Message

See more Clickatell Examples

Demonstrate how to send a Clickatell SMS text message. B4X

Dim success As Boolean = False

'  This example assumes the Chilkat API to have been previously unlocked.
'  See Global Unlock Sample for sample code.

Dim http As ChilkatHttp
http.Initialize("http")

'  Implements the following CURL command:

'  curl -i \
'  -X POST \
'  -H "Content-Type: application/json" \
'  -H "Accept: application/json" \
'  -H "Authorization: API_KEY" \
'  -d '{"content": "Test Message Text", "to": ["PHONE_NUMBER"], "from": "FROM_PHONE_NUMBER" }' \
'  -s https://platform.clickatell.com/messages

'  Use this online tool to generate code from sample JSON:
'  Generate Code to Create JSON

'  The following JSON is sent in the request body.

'  {
'    "content": "Test Message Text",
'    "to": [
'      "PHONE_NUMBER"
'    ]
'  }

Dim json As ChilkatJsonObject
json.Initialize
json.UpdateString("content", "Test Message Text")
json.UpdateString("to[0]", "PHONE_NUMBER")
json.UpdateString("from", "FROM_PHONE_NUMBER")

http.SetRequestHeader("Authorization", "API_KEY")
http.SetRequestHeader("Accept", "application/json")
http.SetRequestHeader("Content-Type", "application/json")

'  If the following URL does not work, then try "https://platform.clickatell.com/v1/message"
Dim resp As ChilkatHttpResponse
resp.Initialize
success = http.HttpJson("POST", "https://platform.clickatell.com/messages", json, "application/json", resp)
If success = False Then
    Log(http.LastErrorText)
    Return
End If


Dim sbResponseBody As ChilkatStringBuilder
sbResponseBody.Initialize
resp.GetBodySb(sbResponseBody)
Dim jResp As ChilkatJsonObject
jResp.Initialize
jResp.LoadSb(sbResponseBody)
jResp.EmitCompact = False

Log("Response Body:")
Log(jResp.Emit)

Dim respStatusCode As Int = resp.StatusCode
Log("Response Status Code = " & respStatusCode)
If respStatusCode >= 400 Then
    Log("Response Header:")
    Log(resp.Header)
    Log("Failed.")
    Return
End If


'  Sample JSON response:
'  (Sample code for parsing the JSON response is shown below)

'  {
'    "messages": [
'      {
'        "apiMessageId": "66c06ac68e5c4afb953ea9328babfde6",
'        "accepted": true,
'        "to": "16302581871",
'        "errorCode": null,
'        "error": null,
'        "errorDescription": null
'      }
'    ],
'    "errorCode": null,
'    "error": null,
'    "errorDescription": null
'  }

'  Sample code for parsing the JSON response...
'  Use the following online tool to generate parsing code from sample JSON:
'  Generate Parsing Code from JSON

Dim errorCode As String
Dim error As String
Dim errorDescription As String
Dim i As Int
Dim count_i As Int
Dim apiMessageId As String
Dim accepted As Boolean
Dim v_to As String

errorCode = jResp.StringOf("errorCode")
error = jResp.StringOf("error")
errorDescription = jResp.StringOf("errorDescription")
i = 0
count_i = jResp.SizeOfArray("messages")
Do While i < count_i
    jResp.I = i
    apiMessageId = jResp.StringOf("messages[i].apiMessageId")
    accepted = jResp.BoolOf("messages[i].accepted")
    v_to = jResp.StringOf("messages[i].to")
    errorCode = jResp.StringOf("messages[i].errorCode")
    error = jResp.StringOf("messages[i].error")
    errorDescription = jResp.StringOf("messages[i].errorDescription")
    i = i + 1
Loop