message

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
actionHook properties

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

Prev: listen Next: pause