Sample code for 30+ languages & platforms
Visual Basic 6.0 Requires Chilkat v11.0.0+

Clickatell One API: Schedule a time-limited SMS reminder

See more Clickatell Examples

Schedule a reminder 15 minutes from now in UTC. The scheduledDeliveryTime includes its time zone and validityPeriod is expressed in minutes. Set both from the appointment and the period for which the reminder will still be useful. Use the returned message ID for a later status lookup.

Supply an international number as digits. Set the sender to the provisioned number when the integration requires it.

Clickatell API reference

Chilkat Visual Basic 6.0 Downloads

Visual Basic 6.0
'  Assumes Chilkat is unlocked. See Global Unlock Sample.
Dim http As New ChilkatHttp
http.RequireSslCertVerify = 1
'  Load the key for this One API integration from your application configuration.
http.SetRequestHeader "Authorization","ONE_API_KEY"
http.SetRequestHeader "Accept","application/json"

Dim schedule As New CkDateTime
success = schedule.SetFromCurrentSystemTime()
success = schedule.AddSeconds(900)
Dim sendAt As String
sendAt = schedule.GetAsTimestamp(0)
Dim body As New ChilkatJsonObject
success = body.UpdateString("messages[0].channel","sms")
success = body.UpdateString("messages[0].to","PHONE_NUMBER")
success = body.UpdateString("messages[0].content","Appointment reminder: please check in at reception.")
success = body.UpdateString("messages[0].scheduledDeliveryTime",sendAt)
success = body.UpdateInt("messages[0].validityPeriod",60)
Dim sender As String
sender = ""
If (sender <> "") Then
    success = body.UpdateString("messages[0].from",sender)
End If

Debug.Print "Requested send time (UTC): " & sendAt

Dim resp As New ChilkatHttpResponse
Dim sent As Long
sent = http.HttpJson("POST","https://platform.clickatell.com/v1/message",body,"application/json",resp)
If (resp.StatusCode = 0) Then
    Debug.Print "No HTTP response. Check the message report before resending."
    Exit Sub
End If

Dim reply As New ChilkatJsonObject
Dim parsed As Long
parsed = reply.Load(resp.BodyStr)
If ((sent <> 1) Or (resp.StatusCode <> 202)) Then
    Debug.Print "Send returned HTTP " & resp.StatusCode
    If (reply.HasMember("error.description") = 1) Then
        Debug.Print reply.StringOf("error.description")
    End If

    Exit Sub
End If

If (reply.HasMember("error.code") = 1) Then
    If (reply.IsNullOf("error.code") <> 1) Then
        Debug.Print "Submission error " & reply.StringOf("error.code") & "  " & reply.StringOf("error.description")
        Exit Sub
    End If

End If

'  HTTP acceptance and the recipient result are separate checks.
If ((parsed <> 1) Or (reply.JsonTypeOf("messages[0].accepted") <> 5)) Then
    Debug.Print "Missing recipient result. Check the message report."
    Exit Sub
End If

If (reply.BoolOf("messages[0].accepted") <> 1) Then
    Debug.Print "Message rejected: " & reply.StringOf("messages[0].error.code") & "  " & reply.StringOf("messages[0].error.description")
    Exit Sub
End If

If (reply.JsonTypeOf("messages[0].apiMessageId") <> 1) Then
    Debug.Print "Accepted without a message ID. Check the message report."
    Exit Sub
End If

Debug.Print "Accepted. Message ID: " & reply.StringOf("messages[0].apiMessageId")