Inbound SMS Received

Event

Event Name	Description
Inbound message received	Triggered when a message has been received on your Webex Interact inbox.

Payload Samples

{
  "specversion": "1.0",
  "type": "com.interact.messages.sms.status",
  "source": "https://api.webexinteract.com/v1/sms",
  "id": "evt_3F1PcvvRVhBBPawkitvn3mxn3O4",
  "time": "2026-04-07T08:23:05Z",
  "datacontenttype": "application/json",
  "data": {
    "status": "inbound",
    "channel": "sms",
    "message": "SUBSCRIBE - keep me up to date with your latest updates please",
    "phone_number": "+447838970000",
    "inbound_number": "+447860000000",
    "inbound_number_id": "num_6C1Oy46vFl1GSaPIxLGpSuveTMn",
    "rules": [
      {
        "rule": "Newsletter Signup",
        "trigger_keyword": "SUBSCRIBE",
        "target_lists": [
          "LST_3BfW95mzxDy5NH4V64FNtYmkMAS",
          "LST_30e5wMJ4nRsxMYMiUeNGYG7onTy"
        ]
      }
    ]
  },
  "correlation_id": "cid_3C4PcZoMswjiFvhci24RrhkXrUJ"
}

Field Definitions

Parameter	Description
type	Specifies the event type.
source	Indicates the event's origin, such as the API URL..
id	Unique webhook event identifier.
time	Timestamp (ISO 8601 format) of the event.
datacontenttype	Specifies the data format, typically "application/json".
→ status	SMS message status "inbound".
→ channel	Specifies channel that the message was received on.
→message	Message body received.
→phone_number	The senders phone number.
→inbound_number	Your Webex Interact asset that the message was received on.
→inbound_number_id	The UID of the Webex Interact asset that the message was received on.
→rules	Provided if the message matched on aRule condition. See our Rules documentation for more details on Rules.
→→rule	Name of the Rule that has been triggered.
→→trigger_keyword	The keyword that met the condition for the Rule.
→→target_lists	The target lists that the inbound number was added to as a result of triggering a Rule.
correlation_id	A system generated unique identifier assigned to each request for tracking and reference.