C++ Requires Chilkat v11.0.0+
C++
Clickatell One API: Send personalized SMS reminders in a batch
See more Clickatell Examples
Send two appointments in one request with a different text and application ID for each. Use two distinct recipient numbers in international digits. For a US two-way integration, add its provisioned from number to each message.
Read each recipient result even when HTTP 207 reports a mixed outcome. Save the accepted provider ID against the appointment. A missing result calls for checking the message report before retrying. A client message ID helps correlate records and does not guarantee deduplication.
Chilkat C++ Downloads
#include <CkHttp.h>
#include <CkJsonObject.h>
#include <CkHttpResponse.h>
void ChilkatSample(void)
{
// Assumes Chilkat is unlocked. See Global Unlock Sample.
CkHttp http;
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");
const char *firstPhone = "FIRST_PHONE_NUMBER";
const char *secondPhone = "SECOND_PHONE_NUMBER";
CkJsonObject body;
body.UpdateString("messages[0].channel","sms");
body.UpdateString("messages[0].to",firstPhone);
body.UpdateString("messages[0].content","Your appointment with Lee is at 10:00.");
body.UpdateString("messages[0].clientMessageId","appt-1042");
body.UpdateString("messages[1].channel","sms");
body.UpdateString("messages[1].to",secondPhone);
body.UpdateString("messages[1].content","Your appointment with Sam is at 14:30.");
body.UpdateString("messages[1].clientMessageId","appt-1043");
CkHttpResponse resp;
bool sent = http.HttpJson("POST","https://platform.clickatell.com/v1/message",body,"application/json",resp);
if (resp.get_StatusCode() == 0) {
std::cout << "No HTTP response. Check the message report before resending." << "\r\n";
return;
}
CkJsonObject reply;
bool parsed = reply.Load(resp.bodyStr());
if ((sent != true) || ((resp.get_StatusCode() != 202) && (resp.get_StatusCode() != 207))) {
std::cout << "Send returned HTTP " << resp.get_StatusCode() << "\r\n";
if (reply.HasMember("error.description") == true) {
std::cout << reply.stringOf("error.description") << "\r\n";
}
return;
}
if (reply.HasMember("error.code") == true) {
if (reply.IsNullOf("error.code") != true) {
std::cout << "Submission error " << reply.stringOf("error.code") << " " << reply.stringOf("error.description") << "\r\n";
return;
}
}
// Look up each submitted appointment in the reply using its unique recipient.
// This works even if the result order changes or clientMessageId is absent.
CkJsonObject results;
int i = 0;
while ((i < 2)) {
body.put_I(i);
const char *appointment = body.stringOf("messages[i].clientMessageId");
const char *phone = body.stringOf("messages[i].to");
CkJsonObject result;
bool found = reply.FindRecord2("messages","to",phone,true,result);
results.put_I(i);
results.UpdateString("appointments[i].clientMessageId",appointment);
if ((found != true) || (result.JsonTypeOf("accepted") != 5)) {
results.UpdateString("appointments[i].outcome","unknown");
std::cout << appointment << " has no confirmed result." << "\r\n";
}
else {
if (result.BoolOf("accepted") == true) {
results.UpdateString("appointments[i].outcome","accepted");
if (result.JsonTypeOf("apiMessageId") == 1) {
results.UpdateString("appointments[i].apiMessageId",result.stringOf("apiMessageId"));
}
std::cout << appointment << " accepted." << "\r\n";
}
else {
results.UpdateString("appointments[i].outcome","rejected");
results.UpdateString("appointments[i].reason",result.stringOf("error.description"));
std::cout << appointment << " rejected: " << result.stringOf("error.description") << "\r\n";
}
}
i = i + 1;
}
// This demo writes a snapshot. In an application, update the two appointment records.
bool saved = results.WriteFile("appointment-send-results.json");
if (saved != true) {
std::cout << "Could not save the results. Reconcile the submitted messages before retrying." << "\r\n";
return;
}
std::cout << "Saved appointment-send-results.json" << "\r\n";
}