(Excel) WhatsApp - Send a Linked Media Message

Demonstrates how to send a media message where the media content is a link to an external URL. This example demonstrates sending an image (JPG) media message.

For more information, see https://developers.facebook.com/docs/whatsapp/api/messages/media

Download Excel Class Modules Chilkat Excel Class Modules

' This example assumes the Chilkat API to have been previously unlocked.
' See Global Unlock Sample for sample code.

Dim http As Chilkat.Http
Set http = Chilkat.NewHttp

' Implements the following CURL command:

' curl -X POST https://example.com/v1/messages \
'   -H "Authorization: Bearer your-auth-token" \
'   -d '
' {
'     "recipient_type": "individual-or-group",
'     "to": "whatsapp-id-or-group-id",
'     "type": "image",
'     "image": {
'       "link": "http(s)://the-url",
'       "provider": {
'         "name" : "provider-name"
'       },
'     "caption": "your-image-caption"
'   }
' }'

' Use the following online tool to generate HTTP code from a CURL command
' Convert a cURL Command to HTTP Source Code

' Use this online tool to generate code from sample JSON:
' Generate Code to Create JSON

' The following JSON is sent in the request body.

' {
'   "recipient_type": "individual-or-group",
'   "to": "whatsapp-id-or-group-id",
'   "type": "image",
'   "image": {
'     "link": "http(s)://the-url",
'     "provider": {
'       "name": "provider-name"
'     },
'     "caption": "your-image-caption"
'   }
' }

Dim json As Chilkat.JsonObject
Set json = Chilkat.NewJsonObject
Dim success As Boolean
success = json.UpdateString("recipient_type","individual-or-group")
success = json.UpdateString("to","whatsapp-id-or-group-id")
success = json.UpdateString("type","image")
success = json.UpdateString("image.link","http(s)://the-url")
success = json.UpdateString("image.provider.name","provider-name")
success = json.UpdateString("image.caption","your-image-caption")

' Adds the "Authorization: Bearer your-auth-token" header.
http.AuthToken = "your-auth-token"


Set resp = http.PostJson3("https://example.com/v1/messages","application/json",json)
If (http.LastMethodSuccess = False) Then
    Debug.Print http.LastErrorText
    Exit Sub
End If

Dim sbResponseBody As Chilkat.StringBuilder
Set sbResponseBody = Chilkat.NewStringBuilder
success = resp.GetBodySb(sbResponseBody)
Dim jResp As Chilkat.JsonObject
Set jResp = Chilkat.NewJsonObject
success = jResp.LoadSb(sbResponseBody)
jResp.EmitCompact = False

Debug.Print "Response Body:"
Debug.Print jResp.Emit()


respStatusCode = resp.StatusCode
Debug.Print "Response Status Code = "; respStatusCode
If (respStatusCode >= 400) Then
    Debug.Print "Response Header:"
    Debug.Print resp.Header
    Debug.Print "Failed."

    Exit Sub
End If

' Sample JSON response:
' (Sample code for parsing the JSON response is shown below)

' {
'   "messages": [
'     {
'       "id": "gBEGkYiEB1VXAglK1ZEqA1YKPrU"
'     }
'   ]
' }

' Sample code for parsing the JSON response...
' Use the following online tool to generate parsing code from sample JSON:
' Generate Parsing Code from JSON


i = 0

count_i = jResp.SizeOfArray("messages")
Do While i < count_i
    jResp.I = i
    id = jResp.StringOf("messages[i].id")
    i = i + 1
Loop