Xbase++ Requires Chilkat v11.0.0+
Xbase++
Clickatell One API: Send an approved WhatsApp shipment template
See more Clickatell Examples
Send a business-initiated shipment update, including outside an open customer service window. First approve a template on the WhatsApp integration with two positional body placeholders for the order number and delivery date. Supply its exact name and approved language. The keys 1 and 2 refer to those placeholders in order.
Chilkat Xbase++ Downloads
LOCAL oHttp
LOCAL oBody
LOCAL oResp
LOCAL nSent
LOCAL oReply
LOCAL nParsed
// Assumes Chilkat is unlocked. See Global Unlock Sample.
oHttp := CreateObject("Chilkat.Http")
oHttp:RequireSslCertVerify := 1
// Load the key for this One API integration from your application configuration.
oHttp:SetRequestHeader("Authorization", "ONE_API_KEY")
oHttp:SetRequestHeader("Accept", "application/json")
// Example approved wording: Order {{1}} is due for delivery on {{2}}.
oBody := CreateObject("Chilkat.JsonObject")
oBody:UpdateString("messages[0].channel", "whatsapp")
oBody:UpdateString("messages[0].to", "PHONE_NUMBER")
oBody:UpdateString("messages[0].template.templateName", "shipment_update")
oBody:UpdateString("messages[0].template.language", "en_US")
oBody:UpdateString("messages[0].template.body.parameters.1", "ORD-1042")
oBody:UpdateString("messages[0].template.body.parameters.2", "March 19")
oResp := CreateObject("Chilkat.HttpResponse")
nSent := oHttp:HttpJson("POST", "https://platform.clickatell.com/v1/message", oBody, "application/json", oResp)
IF (oResp:StatusCode == 0)
? "No HTTP response. Check the message report before resending."
oHttp:destroy()
oBody:destroy()
oResp:destroy()
RETURN
ENDIF
oReply := CreateObject("Chilkat.JsonObject")
nParsed := oReply:Load(oResp:BodyStr)
IF ((nSent != 1) .OR. (oResp:StatusCode != 202))
? "Send returned HTTP " + Str(oResp:StatusCode)
IF (oReply:HasMember("error.description") == 1)
? oReply:StringOf("error.description")
ENDIF
oHttp:destroy()
oBody:destroy()
oResp:destroy()
oReply:destroy()
RETURN
ENDIF
IF (oReply:HasMember("error.code") == 1)
IF (oReply:IsNullOf("error.code") != 1)
? "Submission error " + oReply:StringOf("error.code") + " " + oReply:StringOf("error.description")
oHttp:destroy()
oBody:destroy()
oResp:destroy()
oReply:destroy()
RETURN
ENDIF
ENDIF
// HTTP acceptance and the recipient result are separate checks.
IF ((nParsed != 1) .OR. (oReply:JsonTypeOf("messages[0].accepted") != 5))
? "Missing recipient result. Check the message report."
oHttp:destroy()
oBody:destroy()
oResp:destroy()
oReply:destroy()
RETURN
ENDIF
IF (oReply:BoolOf("messages[0].accepted") != 1)
? "Message rejected: " + oReply:StringOf("messages[0].error.code") + " " + oReply:StringOf("messages[0].error.description")
oHttp:destroy()
oBody:destroy()
oResp:destroy()
oReply:destroy()
RETURN
ENDIF
IF (oReply:JsonTypeOf("messages[0].apiMessageId") != 1)
? "Accepted without a message ID. Check the message report."
oHttp:destroy()
oBody:destroy()
oResp:destroy()
oReply:destroy()
RETURN
ENDIF
? "Accepted. Message ID: " + oReply:StringOf("messages[0].apiMessageId")
oHttp:destroy()
oBody:destroy()
oResp:destroy()
oReply:destroy()