B4X
B4X
MessageMedia - Send Messages
See more MessageMedia Examples
Submit one or more (up to 100 per request) SMS, MMS, or text to voice messages for delivery.Chilkat B4X Downloads
Dim success As Boolean = False
' This example assumes the Chilkat API to have been previously unlocked.
' See Global Unlock Sample for sample code.
Dim http As ChilkatHttp
http.Initialize("http")
' Implements the following CURL command:
' curl --request POST \
' --header "Content-Type: application/json" \
' --header "Accept: application/json" \
' --data-binary "{
' \"messages\": [
' {
' \"callback_url\": \"https://my.callback.url.com\",
' \"content\": \"My first message\",
' \"destination_number\": \"+61491570156\",
' \"delivery_report\": true,
' \"format\": \"SMS\",
' \"message_expiry_timestamp\": \"2016-11-03T11:49:02.807Z\",
' \"metadata\": {
' \"myKey\": \"myValue\",
' \"anotherKey\": \"anotherValue\"
' },
' \"scheduled\": \"2016-11-03T11:49:02.807Z\",
' \"source_number\": \"+61491570157\",
' \"source_number_type\": \"INTERNATIONAL\"
' },
' {
' \"callback_url\": \"https://my.callback.url.com\",
' \"content\": \"My second message\",
' \"destination_number\": \"+61491570158\",
' \"delivery_report\": true,
' \"format\": \"MMS\",
' \"subject\": \"This is an MMS message\",
' \"media\": [ \"https://images.pexels.com/photos/1018350/pexels-photo-1018350.jpeg?cs=srgb&dl=architecture-buildings-city-1018350.jpg\" ],
' \"message_expiry_timestamp\": \"2016-11-03T11:49:02.807Z\",
' \"metadata\": {
' \"myKey\": \"myValue\",
' \"anotherKey\": \"anotherValue\"
' },
' \"scheduled\": \"2016-11-03T11:49:02.807Z\",
' \"source_number\": \"+61491570159\",
' \"source_number_type\": \"INTERNATIONAL\"
' }
' ]
' }" \
' https://private-anon-ecbaffbc28-messages32.apiary-mock.com/v1/messages
' 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.
' {
' "messages": [
' {
' "callback_url": "https://my.callback.url.com",
' "content": "My first message",
' "destination_number": "+61491570156",
' "delivery_report": true,
' "format": "SMS",
' "message_expiry_timestamp": "2016-11-03T11:49:02.807Z",
' "metadata": {
' "myKey": "myValue",
' "anotherKey": "anotherValue"
' },
' "scheduled": "2016-11-03T11:49:02.807Z",
' "source_number": "+61491570157",
' "source_number_type": "INTERNATIONAL"
' },
' {
' "callback_url": "https://my.callback.url.com",
' "content": "My second message",
' "destination_number": "+61491570158",
' "delivery_report": true,
' "format": "MMS",
' "subject": "This is an MMS message",
' "media": [
' "https://images.pexels.com/photos/1018350/pexels-photo-1018350.jpeg?cs=srgb&dl=architecture-buildings-city-1018350.jpg"
' ],
' "message_expiry_timestamp": "2016-11-03T11:49:02.807Z",
' "metadata": {
' "myKey": "myValue",
' "anotherKey": "anotherValue"
' },
' "scheduled": "2016-11-03T11:49:02.807Z",
' "source_number": "+61491570159",
' "source_number_type": "INTERNATIONAL"
' }
' ]
' }
Dim json As ChilkatJsonObject
json.Initialize
json.UpdateString("messages[0].callback_url", "https://my.callback.url.com")
json.UpdateString("messages[0].content", "My first message")
json.UpdateString("messages[0].destination_number", "+61491570156")
json.UpdateBool("messages[0].delivery_report", True)
json.UpdateString("messages[0].format", "SMS")
json.UpdateString("messages[0].message_expiry_timestamp", "2016-11-03T11:49:02.807Z")
json.UpdateString("messages[0].metadata.myKey", "myValue")
json.UpdateString("messages[0].metadata.anotherKey", "anotherValue")
json.UpdateString("messages[0].scheduled", "2016-11-03T11:49:02.807Z")
json.UpdateString("messages[0].source_number", "+61491570157")
json.UpdateString("messages[0].source_number_type", "INTERNATIONAL")
json.UpdateString("messages[1].callback_url", "https://my.callback.url.com")
json.UpdateString("messages[1].content", "My second message")
json.UpdateString("messages[1].destination_number", "+61491570158")
json.UpdateBool("messages[1].delivery_report", True)
json.UpdateString("messages[1].format", "MMS")
json.UpdateString("messages[1].subject", "This is an MMS message")
json.UpdateString("messages[1].media[0]", "https://images.pexels.com/photos/1018350/pexels-photo-1018350.jpeg?cs=srgb&dl=architecture-buildings-city-1018350.jpg")
json.UpdateString("messages[1].message_expiry_timestamp", "2016-11-03T11:49:02.807Z")
json.UpdateString("messages[1].metadata.myKey", "myValue")
json.UpdateString("messages[1].metadata.anotherKey", "anotherValue")
json.UpdateString("messages[1].scheduled", "2016-11-03T11:49:02.807Z")
json.UpdateString("messages[1].source_number", "+61491570159")
json.UpdateString("messages[1].source_number_type", "INTERNATIONAL")
http.SetRequestHeader("Content-Type", "application/json")
http.SetRequestHeader("Accept", "application/json")
Dim resp As ChilkatHttpResponse
resp.Initialize
success = http.HttpJson("POST", "https://private-anon-ecbaffbc28-messages32.apiary-mock.com/v1/messages", json, "application/json", resp)
If success = False Then
Log(http.LastErrorText)
Return
End If
Dim sbResponseBody As ChilkatStringBuilder
sbResponseBody.Initialize
resp.GetBodySb(sbResponseBody)
Dim jResp As ChilkatJsonObject
jResp.Initialize
jResp.LoadSb(sbResponseBody)
jResp.EmitCompact = False
Log("Response Body:")
Log(jResp.Emit)
Dim respStatusCode As Int = resp.StatusCode
Log("Response Status Code = " & respStatusCode)
If respStatusCode >= 400 Then
Log("Response Header:")
Log(resp.Header)
Log("Failed.")
Return
End If
' Sample JSON response:
' (Sample code for parsing the JSON response is shown below)
' {
' "messages": [
' {
' "message_id": "04fe9a97-a579-43c5-bb1a-58ed29bf0a6a",
' "callback_url": "https://my.url.com",
' "status": "delivered",
' "content": "My first message",
' "destination_number": "+61491570156",
' "delivery_report": true,
' "format": "SMS",
' "message_expiry_timestamp": "2016-11-03T11:49:02.807Z",
' "metadata": {
' "myKey": "myValue",
' "anotherKey": "anotherValue"
' },
' "scheduled": "2016-11-03T11:49:02.807Z",
' "source_number": "+61491570157",
' "source_number_type": "INTERNATIONAL"
' }
' ]
' }
' Sample code for parsing the JSON response...
' Use the following online tool to generate parsing code from sample JSON:
' Generate Parsing Code from JSON
Dim message_id As String
Dim callback_url As String
Dim status As String
Dim content As String
Dim destination_number As String
Dim delivery_report As Boolean
Dim format As String
Dim message_expiry_timestamp As String
Dim MyKey As String
Dim AnotherKey As String
Dim scheduled As String
Dim source_number As String
Dim source_number_type As String
Dim i As Int = 0
Dim count_i As Int = jResp.SizeOfArray("messages")
Do While i < count_i
jResp.I = i
message_id = jResp.StringOf("messages[i].message_id")
callback_url = jResp.StringOf("messages[i].callback_url")
status = jResp.StringOf("messages[i].status")
content = jResp.StringOf("messages[i].content")
destination_number = jResp.StringOf("messages[i].destination_number")
delivery_report = jResp.BoolOf("messages[i].delivery_report")
format = jResp.StringOf("messages[i].format")
message_expiry_timestamp = jResp.StringOf("messages[i].message_expiry_timestamp")
MyKey = jResp.StringOf("messages[i].metadata.myKey")
AnotherKey = jResp.StringOf("messages[i].metadata.anotherKey")
scheduled = jResp.StringOf("messages[i].scheduled")
source_number = jResp.StringOf("messages[i].source_number")
source_number_type = jResp.StringOf("messages[i].source_number_type")
i = i + 1
Loop