(PowerShell) 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

Chilkat .NET Downloads Chilkat .NET Assemblies

Add-Type -Path "C:\chilkat\ChilkatDotNet47-x64\ChilkatDotNet47.dll"

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

$http = New-Object Chilkat.Http

# 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"
#   }
# }

$json = New-Object Chilkat.JsonObject
$json.UpdateString("recipient_type","individual-or-group")
$json.UpdateString("to","whatsapp-id-or-group-id")
$json.UpdateString("type","image")
$json.UpdateString("image.link","http(s)://the-url")
$json.UpdateString("image.provider.name","provider-name")
$json.UpdateString("image.caption","your-image-caption")

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

$resp = $http.PostJson3("https://example.com/v1/messages","application/json",$json)
if ($http.LastMethodSuccess -eq $false) {
    $($http.LastErrorText)
    exit
}

$sbResponseBody = New-Object Chilkat.StringBuilder
$resp.GetBodySb($sbResponseBody)
$jResp = New-Object Chilkat.JsonObject
$jResp.LoadSb($sbResponseBody)
$jResp.EmitCompact = $false

$("Response Body:")
$($jResp.Emit())

$respStatusCode = $resp.StatusCode
$("Response Status Code = " + $respStatusCode)
if ($respStatusCode -ge 400) {
    $("Response Header:")
    $($resp.Header)
    $("Failed.")

    exit
}

# 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")
while ($i -lt $count_i) {
    $jResp.I = $i
    $id = $jResp.StringOf("messages[i].id")
    $i = $i + 1
}