/ products / sms● new

Codes and alerts to Vodacom, Movitel and Tmcel.
See every carrier receipt.

Send one-time codes (OTPs), alerts and notifications to Mozambican numbers (+258). Receive delivery statuses in your app through webhooks, with confirmation from the carrier.

Create account Read the sending guide →

› 1.30 MZN per SMS› prepaid credits› support from Maputo in Portuguese and English

delivery example3f9c2a1e

AcmePay Your code is 184 720. It expires in 5 minutes.

14:02:07.112accepted by the API202 · queued
14:02:07.180checksauthorized sender · 1 segment
14:02:07.402sent to carriersender AcmePay
14:02:09.861deliveredcarrier receipt · DELIVRD
14:02:09.915webhook receivedsms.delivered · your app responded 200

01 segments · gsm-7 and ucs-2

Count the segments before you send.

A long message is split into parts called segments. Accents outside the GSM-7 alphabet or emojis switch the encoding to UCS-2, which has less room per segment. Try your own text or load an example.

Example message

This simulator does not send SMS. Some symbols and emojis use more than one unit. The segment count does not change the price per SMS.

encodingGSM-7GSM alphabet and compatible symbols

units used54160 in a 1-segment SMS; 153 per segment in longer messages

segments1106 units left in the current segments

estimated cost1.30 MZN1 credit per SMS and recipient

02 sender id · the name your customer sees

Your SMS arrives with your brand name.

A sender ID is the name shown as the sender, such as AcmePay. Request yours by email, with the name you want and the kind of messages you’ll send; we handle registration with the carriers.

› Up to 11 characters: letters and numbers
› Attached to your workspace
› Default sender while registration is pending

Request a sender ID by email

example · sender names (sender IDs)

AcmePayOTP codesactive

AcmeShoporder noticesactive

TORPEDOtestingdefault

03 sending · one call

Send through the API. Get the result by webhook.

A 202 response confirms the SMS is queued. Configure a webhook endpoint to receive the delivery result in your app.

curl -X POST https://api.torpedo.co.mz/v1/sms \
  -H "X-API-Key: $TORPEDO_API_KEY" \
  -H "Idempotency-Key: otp-8f2a41" \
  -H "Content-Type: application/json" \
  -d '{ "from": "AcmePay", "to": "+25884xxxxxxx",
        "body": "Your code is 184 720." }'

# ← 202 { "data": { "id": "3f9c2a1e-…", "status": "queued" } }

webhook events

sms.deliveredThe carrier confirmed delivery to the handset.

sms.undeliveredThe carrier did not deliver the SMS. Check failureCategory for the reason.

sms.failedSending to the carrier failed. Check reason for the cause.

Verify each event’s signature. Torpedo retries if your endpoint fails. When retrying a send request, keep the same Idempotency-Key to avoid duplicate SMS.

04 price · per SMS

1.30 MZN per SMS.

Each SMS per recipient uses 1 credit, even with multiple segments. After the 5 trial SMS, available on paid plans, with prepaid credits.

Create account See plans and SMS pricing

coverage: +258 numbers
billing: Prepaid credits, in MZN or USD
encoding: GSM-7 · UCS-2
receipts: Delivery receipt for every message