Sample code for 30+ languages & platforms
Android™ 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 Android™ Downloads

Android™
// Important: Don't forget to include the call to System.loadLibrary
// as shown at the bottom of this code sample.
package com.test;

import android.app.Activity;
import com.chilkatsoft.*;

import android.widget.TextView;
import android.os.Bundle;

public class SimpleActivity extends Activity {

  private static final String TAG = "Chilkat";

  // Called when the activity is first created.
  @Override
  public void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);

    //  Assumes Chilkat is unlocked. See Global Unlock Sample.
    CkHttp http = new CkHttp();
    http.put_RequireSslCertVerify(true);
    //  Load the key for this One API integration from your application configuration.
    http.SetRequestHeader("Authorization","ONE_API_KEY");
    http.SetRequestHeader("Accept","application/json");

    CkDateTime schedule = new CkDateTime();
    schedule.SetFromCurrentSystemTime();
    schedule.AddSeconds(900);
    String sendAt = schedule.getAsTimestamp(false);
    CkJsonObject body = new CkJsonObject();
    body.UpdateString("messages[0].channel","sms");
    body.UpdateString("messages[0].to","PHONE_NUMBER");
    body.UpdateString("messages[0].content","Appointment reminder: please check in at reception.");
    body.UpdateString("messages[0].scheduledDeliveryTime",sendAt);
    body.UpdateInt("messages[0].validityPeriod",60);
    String sender = "";
    if (sender != "") {
        body.UpdateString("messages[0].from",sender);
        }

    Log.i(TAG, "Requested send time (UTC): " + sendAt);

    CkHttpResponse resp = new CkHttpResponse();
    boolean sent = http.HttpJson("POST","https://platform.clickatell.com/v1/message",body,"application/json",resp);
    if (resp.get_StatusCode() == 0) {
        Log.i(TAG, "No HTTP response. Check the message report before resending.");
        return;
        }

    CkJsonObject reply = new CkJsonObject();
    boolean parsed = reply.Load(resp.bodyStr());
    if ((sent != true) or (resp.get_StatusCode() != 202)) {
        Log.i(TAG, "Send returned HTTP " + String.valueOf(resp.get_StatusCode()));
        if (reply.HasMember("error.description") == true) {
            Log.i(TAG, reply.stringOf("error.description"));
            }

        return;
        }

    if (reply.HasMember("error.code") == true) {
        if (reply.IsNullOf("error.code") != true) {
            Log.i(TAG, "Submission error " + reply.stringOf("error.code") + "  " + reply.stringOf("error.description"));
            return;
            }

        }

    //  HTTP acceptance and the recipient result are separate checks.
    if ((parsed != true) or (reply.JsonTypeOf("messages[0].accepted") != 5)) {
        Log.i(TAG, "Missing recipient result. Check the message report.");
        return;
        }

    if (reply.BoolOf("messages[0].accepted") != true) {
        Log.i(TAG, "Message rejected: " + reply.stringOf("messages[0].error.code") + "  " + reply.stringOf("messages[0].error.description"));
        return;
        }

    if (reply.JsonTypeOf("messages[0].apiMessageId") != 1) {
        Log.i(TAG, "Accepted without a message ID. Check the message report.");
        return;
        }

    Log.i(TAG, "Accepted. Message ID: " + reply.stringOf("messages[0].apiMessageId"));

  }

  static {
      System.loadLibrary("chilkat");

      // Note: If the incorrect library name is passed to System.loadLibrary,
      // then you will see the following error message at application startup:
      //"The application <your-application-name> has stopped unexpectedly. Please try again."
  }
}