Ruka hadi maudhui makuu

Tafsiri inakuja — ukurasa huu unaonyeshwa kwa Kiingereza wakati tafsiri ya Kiswahili inaandaliwa. Soma kwa Kiingereza

Transactional SMS

Transactional SMS that arrives when it matters

Order confirmations, payment receipts, delivery updates and account alerts travel on a priority lane — so a customer's urgent message never waits behind someone else's campaign.

YO YOURSHOP Jina la mtumaji lililoidhinishwa

Payment received: TZS 45,000 for order #1042. Thank you!

09:30 Imefika

Your parcel is out for delivery. The driver will call you on arrival.

09:41 Imefika

Your appointment is confirmed for Tue 21 Oct at 10:30.

10:05 Imefika

Built for messages that cannot wait

  • A priority lane

    Transactional messages travel on a high-priority lane, separate from bulk campaigns.

  • Triggered by your system

    Send from your app or website with one API call, or bind over SMPP for high volumes.

  • Safe retries

    Idempotency keys mean a retried request never sends the same SMS twice.

  • Status you can trust

    Per-message delivery receipts by webhook, so your system knows what actually happened.

  • References that match your records

    Attach your own reference, such as an order number, and use it to find the message later.

  • Test without sending

    Test keys run the whole flow without a real SMS or any credits used.

From first test to production

  1. 1

    Register a sender ID

    Choose the name customers will see and get it approved.

  2. 2

    Create an API key and test it

    Use a test key to try the full flow without sending a real SMS.

  3. 3

    Send from your system

    Trigger messages from your app and listen for delivery webhooks.

What belongs in a transactional message

  • Messages a customer expects because of something they did: orders, payments, bookings, sign-ins.
  • Short, clear and specific — include the reference the customer will recognise.
  • No promotions: keep marketing in bulk campaigns so the priority lane stays fast.
  • Include only what is needed; SMS is not end-to-end encrypted.

One request per message

Single sends use the priority lane by default. Send the order confirmation the moment your system records it.

POST /v1/messages
curl -X POST 'https://api.lundosms.co.tz/v1/messages' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Idempotency-Key: order-1001' \
  -H 'Content-Type: application/json' \
  -d '{
    "sender_id": "YOURBRAND",
    "recipients": ["255712345678"],
    "message": "Your order has been confirmed.",
    "client_reference": "ORDER-1001",
    "type": "transactional"
  }'

Transactional SMS questions

Nitajuaje kama ujumbe umefika?

Kila ujumbe una hali yake: uko kwenye foleni, umetumwa kwenye mtandao, umefika, au umeshindikana. "Umetumwa kwenye mtandao" inamaanisha mtandao umeukubali ujumbe; "umefika" inamaanisha simu ya mpokeaji imethibitisha. Unaweza kuona hali hizi kwenye dashibodi, kuzipakua, au kuzipokea kwa webhook au SMPP. Simu iliyozimwa au isiyo na mtandao inaweza kupokea ujumbe baadaye au isiupokee kabisa — hakuna mtoa huduma anayeweza kuhakikisha kufika pale mtandao usipothibitisha.

Naweza kutuma kutoka kwenye mfumo wangu mwenyewe?

Ndiyo. REST API inapokea ombi moja la HTTPS lenye ufunguo wa API, inasaidia funguo za idempotency ili kujaribu tena kusisababishe kutuma mara mbili, na inaripoti mabadiliko ya hali kwa webhook iliyosainiwa. Funguo za majaribio zinakuwezesha kujaribu kila kitu bila kutuma ujumbe halisi.

Naweza kujaribu kabla ya kununua salio?

Ndiyo. Fungua akaunti kisha tumia ufunguo wa API wa majaribio: unapitia ukaguzi uleule na kurudisha marejeo halisi, lakini hakuna kinachotumwa kwenye simu na hakuna salio linalotumika.

Uko tayari kufikia kila simu nchini Tanzania?

Fungua akaunti, sajili jina la mtumaji na utume ujumbe wako wa kwanza leo. Nunua salio la SMS unalohitaji — halikwisha muda.

Unalipia salio kabla ya kutumia. Bei kwa TZS, VAT imejumuishwa.