Articles in this section

SMS/MMS/RCS/WhatsApp WebHook Documentation

  • Updated

TXTImpact can forward inbound messages, SMS, MMS, RCS and WhatsApp events to your system using one of the webhook formats below.
 

Webhook Versions Supported

  • V2 — POST (JSON body)
  • V2 — GET or POST (Form/QueryString)
  • V1 (Legacy) — GET or POST (Form/QueryString) (deprecated)
    • Supported for SMS and MMS. 

When is a webhook fired?

A webhook is triggered when an inbound message is received and a workflow action is configured as Webhook (Forward to URL).

Common Fields (Concepts)

FieldDescription
messageInbound message text
mobileNumber / mobilenumberSender’s phone number (E.164 digits, e.g. 12129204690)
shortCode / SHORTCODEYour TXTImpact number that received the message
operatorId / OperatoridInternal operator id (carrier/route identifier)
rcvd / RcvdDate/time message was received
smsInboxId / MOLOGIDTXTImpact inbound message ID
subscriberNameSubscriber/customer name (if known)
subjectOptional subject (used in some workflows)
attachments + baseUrl/baseURLAttachment info for inbound media (see notes below)

Attachment Handling

If an inbound message includes media (MMS), TXTImpact may include:

  • attachments (string, optional)
  • baseUrl or baseURL (string)

Base URL example: https://cloud.wire2air.com/mms/Inbound/

How to build a downloadable URL:

  • If attachments is present, combine baseUrl + attachments.
  • If attachments is empty, there is no media for that message.

1) V2 Webhook — POST (JSON Body)

Method

POST

Content Type

application/json; charset=utf-8

Sample JSON Body

{
  "attachments": "",
  "baseURL": "https://cloud.wire2air.com/mms/Inbound/",
  "message": "V2 Get",
  "mobileNumber": "12129204690",
  "operatorId": 470,
  "rcvd": "2026-02-10T15:20:28",
  "shortCode": "17329641232",
  "smsInBoxId": 14121296,
  "subject": "",
  "subscriberName": "Sandeep Gulyani",
  "w2aToken": ""
}

Note: You may see baseUrl or baseURL depending on the sender/config.

V2 JSON Field Definitions

JSON FieldTypeRequiredNotes
smsInBoxId / smsInboxIdnumberYesInbound message id
operatorIdnumber/stringNoInternal operator id
rcvdstringNoReceive timestamp (ISO recommended)
shortCodestringYesTXTImpact receiving number
mobileNumberstringYesSender number
subscriberNamestringNoSubscriber name if known
subjectstringNoOptional
messagestringNoMessage text
attachmentsstringNoAttachment filename(s) or blank
baseUrl / baseURLstringNoAttachment base path
w2aTokenstringNoReserved for authentication (optional)

3) V2 Webhook — GET/POST (Form/QueryString)

This is the “V2 fields, but sent as query params (GET) or form params (POST)” option.

Method

GET or POST

Content Type

  • GET: QueryString parameters
  • POST: application/x-www-form-urlencoded (same fields as GET)

Sample (GET)

ParameterExample
attachments(blank)
baseUrlhttps://cloud.wire2air.com/mms/Inbound/
messageV2 Get
mobileNumber12129204690
operatorId470
rcvd2/10/2026 3:10:07 PM
shortCode17329641232
smsInboxId14121248
subject(blank)
subscriberNameSandeep Gulyani

V2 Form Field Definitions

FieldRequiredNotes
smsInboxIdYesInbound message id
operatorIdNoInternal operator id
rcvdNoReceive timestamp (string)
shortCodeYesTXTImpact receiving number
mobileNumberYesSender number
subscriberNameNoSubscriber name if known
subjectNoOptional
messageNoMessage text
attachmentsNoAttachment filename(s) or blank
baseUrlNoAttachment base path


3) V1 Webhook (Legacy) — GET/POST (Form/QueryString) (deprecated)

Method

GET or POST

Content Type

  • GET: QueryString parameters
  • POST: application/x-www-form-urlencoded (same fields as GET)

Sample (GET)

ParameterExample
MOLOGID13868205
Operatorid470
Rcvd2026-02-10T10:14:50
SESSIONIDmee7e137bbbd4a398a9f58851cda620f
SHORTCODE17329641232
TAGSUBREF(blank)
attachments(blank)
baseUrlhttps://cloud.wire2air.com/mms/Inbound/
messageV2 Get
mobilenumber12129204690

V1 Field Definitions

FieldRequiredNotes
MOLOGIDYesInbound message id (legacy name)
OperatoridNoInternal operator id
RcvdNoReceive timestamp
SESSIONIDNoSession correlation id (legacy)
SHORTCODEYesTXTImpact receiving number
TAGSUBREFNoOptional tag/sub reference (legacy)
mobilenumberYesSender number
messageNoMessage text
attachmentsNoAttachment filename(s) or blank
baseUrlNoAttachment base path

Headers & Client IP

During testing (e.g., Pipedream), you may see values like traceparent or client_ip. Those are receiver/environment details and are not guaranteed as part of the TXTImpact payload format.

Recommended Implementation Notes

  • Treat all fields as strings and parse defensively.
  • Store smsInboxId / smsInBoxId / MOLOGID as the unique inbound id for idempotency.
  • If attachments is present, build the media URL using baseUrl + attachments.