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

Clickatell One API: Upload and send a WhatsApp PDF

See more Clickatell Examples

Send a local invoice.pdf during the customer’s open WhatsApp service window. Upload the binary PDF for one recipient, then reference the returned fileId in a separate message to the same recipient. The upload and message submission have separate acceptance results.

Clickatell API reference

Chilkat Visual FoxPro Downloads

Visual FoxPro
LOCAL loHttp
LOCAL lcRecipient
LOCAL loPdf
LOCAL lnLoaded
LOCAL loUpload
LOCAL lnUploaded
LOCAL loMedia
LOCAL lnDecoded
LOCAL lcFileId
LOCAL loBody
LOCAL loResp
LOCAL lnSent
LOCAL loReply
LOCAL lnParsed

*  Assumes Chilkat is unlocked. See Global Unlock Sample.
loHttp = CreateObject('Chilkat.Http')
loHttp.RequireSslCertVerify = 1
*  Load the key for this One API integration from your application configuration.
loHttp.SetRequestHeader("Authorization","ONE_API_KEY")
loHttp.SetRequestHeader("Accept","application/json")

lcRecipient = "PHONE_NUMBER"
loPdf = CreateObject('Chilkat.BinData')
lnLoaded = loPdf.LoadFile("invoice.pdf")
IF (lnLoaded <> 1) THEN
    ? "Could not read invoice.pdf."
    RELEASE loHttp
    RELEASE loPdf
    CANCEL
ENDIF

*  Restrict this customer's invoice to that customer's number.
loHttp.SetUrlVar("recipient",lcRecipient)
loUpload = CreateObject('Chilkat.HttpResponse')
lnUploaded = loHttp.HttpBd("POST","https://platform.clickatell.com/v1/media?fileName=invoice.pdf&to={$recipient}",loPdf,"application/pdf",loUpload)
IF ((lnUploaded <> 1) OR (loUpload.StatusCode <> 201)) THEN
    ? "PDF upload failed. HTTP status " + STR(loUpload.StatusCode)
    RELEASE loHttp
    RELEASE loPdf
    RELEASE loUpload
    CANCEL
ENDIF

loMedia = CreateObject('Chilkat.JsonObject')
lnDecoded = loMedia.Load(loUpload.BodyStr)
IF ((lnDecoded <> 1) OR (loMedia.BoolOf("accepted") <> 1)) THEN
    ? "Upload was not accepted: " + loMedia.StringOf("error.description")
    RELEASE loHttp
    RELEASE loPdf
    RELEASE loUpload
    RELEASE loMedia
    CANCEL
ENDIF

lcFileId = loMedia.StringOf("fileId")
IF ((loMedia.JsonTypeOf("fileId") <> 1) OR (lcFileId = "")) THEN
    ? "Upload returned no file ID."
    RELEASE loHttp
    RELEASE loPdf
    RELEASE loUpload
    RELEASE loMedia
    CANCEL
ENDIF

loBody = CreateObject('Chilkat.JsonObject')
loBody.UpdateString("messages[0].channel","whatsapp")
loBody.UpdateString("messages[0].to",lcRecipient)
loBody.UpdateString("messages[0].media.fileId",lcFileId)
loBody.UpdateString("messages[0].media.contentType","application/pdf")
loBody.UpdateString("messages[0].media.fileName","invoice.pdf")

loResp = CreateObject('Chilkat.HttpResponse')
lnSent = loHttp.HttpJson("POST","https://platform.clickatell.com/v1/message",loBody,"application/json",loResp)
IF (loResp.StatusCode = 0) THEN
    ? "No HTTP response. Check the message report before resending."
    RELEASE loHttp
    RELEASE loPdf
    RELEASE loUpload
    RELEASE loMedia
    RELEASE loBody
    RELEASE loResp
    CANCEL
ENDIF

loReply = CreateObject('Chilkat.JsonObject')
lnParsed = loReply.Load(loResp.BodyStr)
IF ((lnSent <> 1) OR (loResp.StatusCode <> 202)) THEN
    ? "Send returned HTTP " + STR(loResp.StatusCode)
    IF (loReply.HasMember("error.description") = 1) THEN
        ? loReply.StringOf("error.description")
    ENDIF

    RELEASE loHttp
    RELEASE loPdf
    RELEASE loUpload
    RELEASE loMedia
    RELEASE loBody
    RELEASE loResp
    RELEASE loReply
    CANCEL
ENDIF

IF (loReply.HasMember("error.code") = 1) THEN
    IF (loReply.IsNullOf("error.code") <> 1) THEN
        ? "Submission error " + loReply.StringOf("error.code") + "  " + loReply.StringOf("error.description")
        RELEASE loHttp
        RELEASE loPdf
        RELEASE loUpload
        RELEASE loMedia
        RELEASE loBody
        RELEASE loResp
        RELEASE loReply
        CANCEL
    ENDIF

ENDIF

*  HTTP acceptance and the recipient result are separate checks.
IF ((lnParsed <> 1) OR (loReply.JsonTypeOf("messages[0].accepted") <> 5)) THEN
    ? "Missing recipient result. Check the message report."
    RELEASE loHttp
    RELEASE loPdf
    RELEASE loUpload
    RELEASE loMedia
    RELEASE loBody
    RELEASE loResp
    RELEASE loReply
    CANCEL
ENDIF

IF (loReply.BoolOf("messages[0].accepted") <> 1) THEN
    ? "Message rejected: " + loReply.StringOf("messages[0].error.code") + "  " + loReply.StringOf("messages[0].error.description")
    RELEASE loHttp
    RELEASE loPdf
    RELEASE loUpload
    RELEASE loMedia
    RELEASE loBody
    RELEASE loResp
    RELEASE loReply
    CANCEL
ENDIF

IF (loReply.JsonTypeOf("messages[0].apiMessageId") <> 1) THEN
    ? "Accepted without a message ID. Check the message report."
    RELEASE loHttp
    RELEASE loPdf
    RELEASE loUpload
    RELEASE loMedia
    RELEASE loBody
    RELEASE loResp
    RELEASE loReply
    CANCEL
ENDIF

? "Accepted. Message ID: " + loReply.StringOf("messages[0].apiMessageId")

RELEASE loHttp
RELEASE loPdf
RELEASE loUpload
RELEASE loMedia
RELEASE loBody
RELEASE loResp
RELEASE loReply