New in v0.6.6 (beta)

The message verb is used to send an SMS via a carrier using the SMPP protocol. It requires that you have added a BYOC carrier configured that supports SMS.

You can also send SMS via the REST API. See here for more details on that.

{
  "verb": "message",
  "to": "15083084809",
  "from": "16173334567",
  "text": "Your one-time passcode is 1234",
  "actionHook": "/sms/action"
}

You can use the following options in the message verb:

option	description	required
from	sending number	yes
to	destination number	yes
text	text message to send	yes
carrier	name of BYOC carrier to use (useful only when you have multiple carriers configured with SMPP support, otherwise leave out)	no
actionHook	A webhook that is called when the message verb completes	no

The actionHook that is invoked when the message command completes will include the following properties:

property name	description
message_sid	the unique identifier for the message assigned by jambonz
message_status	the final status of the message attempt; will be one of:- success- failure- no carriers- smpp configuration error, or- system error
message_failure_reason	in the case of message_status 'failure', this will contain detail describing why the outbound smpp request failed
carrier	the name of the carrier selected to send the SMS
carrier_message_id	the message identifier assigned by the carrier for this SMS