SMS provider webhooks

After you connect an SMS provider, some providers need a webhook URL registered on their side so Pushwoosh can receive delivery receipts, incoming replies, or channel-specific events such as Viber subscription status. Other providers submit this URL automatically with every message, so no extra setup is required.

All webhooks are received at https://tw-callback.svc-nue.pushwoosh.com/api/v1/.... Where a URL includes {APP_CODE}, replace it with your Pushwoosh application code (Settings → Applications).

Automatic setup

For these providers, Pushwoosh submits the callback URL automatically with every message. No action is required on the provider’s side.

• Twilio: delivery status is submitted automatically with each message. To also receive replies (two-way SMS), set your Twilio phone number’s “A message comes in” webhook in the Twilio Console to:

  https://tw-callback.svc-nue.pushwoosh.com/api/v1/smsCallback/{APP_CODE}

• SMSGlobal: both delivery and incoming URLs are submitted automatically with each message.

• SMSAla: the delivery URL is submitted automatically with each message. SMSAla does not support incoming SMS.

Manual setup required

For these providers, register the webhook URL once in the provider’s own dashboard.

Provider	Event	Method	URL
MStat	Delivery	POST	.../mstatCallback
MStat	Incoming	POST	.../mstatIncoming/{APP_CODE}
MStat	Viber subscription	POST	.../mstatViberSubscription/{APP_CODE}
Amazon SNS	Delivery	POST	.../awsSmsCallback
CapitoleMobile	Delivery	GET	.../capitoleMobileCallback
CapitoleMobile	Incoming	GET	.../capitoleMobileIncoming/{APP_CODE}
AbleMobile	Delivery	GET / POST	.../amSmsCallback
SMSTraffic	Delivery	POST	.../smsTrafficCallback
TextMe.co.il	Delivery	GET	.../textMeCoilCallback
TextMe.co.il	Incoming	GET	.../textMeCoilCallback/{APP_CODE}

Each URL above is relative to https://tw-callback.svc-nue.pushwoosh.com/api/v1.

Amazon SNS

Delivery receipts arrive through an SNS topic subscription, not a per-message parameter.

1. In the AWS Console, add an HTTPS subscription to your SMS delivery status topic. Use the awsSmsCallback URL from the table above.
2. When AWS sends a SubscriptionConfirmation request, find the SubscribeURL in the AWS Console under the pending subscription.
3. Open that URL to confirm the subscription.

Until you confirm the subscription, Pushwoosh does not receive delivery receipts.

No webhook support

Mobipace and SMSCenter don’t send delivery or incoming webhooks to Pushwoosh. No setup is possible or required for these providers.