Send a Command to a Sim
Machine-to-machine commands sent to/from devices
Send a Command to a Sim.
Body
-
CallbackMethod string(http-method)
The HTTP method we use to call
callback_url
. Can be:POST
orGET
, and the default isPOST
.Values are
HEAD
,GET
,POST
,PATCH
,PUT
, orDELETE
. -
CallbackUrl string(uri)
The URL we call using the
callback_url
when the Command has finished sending, whether the command was delivered or it failed. -
The message body of the Command. Can be plain text in text mode or a Base64 encoded byte string in binary mode.
-
CommandMode string
The mode to use when sending the SMS message. Can be:
text
orbinary
. The default SMS mode istext
.Values are
text
orbinary
. -
DeliveryReceiptRequested boolean
Whether to request delivery receipt from the recipient. For Commands that request delivery receipt, the Command state transitions to 'delivered' once the server has received a delivery receipt from the device. The default value is
true
. -
IncludeSid string
Whether to include the SID of the command in the message body. Can be:
none
,start
, orend
, and the default behavior isnone
. When sending a Command to a SIM in text mode, we can automatically include the SID of the Command in the message body, which could be used to ensure that the device does not process the same Command more than once. A value ofstart
will prepend the message with the Command SID, andend
will append it to the end, separating the Command SID from the message body with a space. The length of the Command SID is included in the 160 character limit so the SMS body must be 128 characters or less before the Command SID is included. -
Sim string
The
sid
orunique_name
of the SIM to send the Command to.
curl \
-X POST https://wireless.twilio.com/v1/Commands \
--user "username:password" \
-H "Content-Type: application/x-www-form-urlencoded" \
-d 'CallbackMethod=HEAD&CallbackUrl=https%3A%2F%2Fexample.com&Command=string&CommandMode=text&DeliveryReceiptRequested=true&IncludeSid=string&Sim=string'
{
"CallbackMethod": "HEAD",
"CallbackUrl": "https://example.com",
"Command": "string",
"CommandMode": "text",
"DeliveryReceiptRequested": true,
"IncludeSid": "string",
"Sim": "string"
}
{
"CallbackMethod": "HEAD",
"CallbackUrl": "https://example.com",
"Command": "string",
"CommandMode": "text",
"DeliveryReceiptRequested": true,
"IncludeSid": "string",
"Sim": "string"
}
{
"account_sid": "string",
"command": "string",
"command_mode": "text",
"date_created": "2023-05-04T09:42:00+00:00",
"date_updated": "2023-05-04T09:42:00+00:00",
"delivery_receipt_requested": true,
"direction": "from_sim",
"sid": "string",
"sim_sid": "string",
"status": "queued",
"transport": "sms",
"url": "https://example.com"
}
{
"account_sid": "string",
"command": "string",
"command_mode": "text",
"date_created": "2024-05-04T09:42:00+00:00",
"date_updated": "2024-05-04T09:42:00+00:00",
"delivery_receipt_requested": true,
"direction": "from_sim",
"sid": "string",
"sim_sid": "string",
"status": "queued",
"transport": "sms",
"url": "https://example.com"
}