202 ACCEPTED means HudumaSMS accepted your message and passed it to the network.
It does not mean the handset received it.
What the statuses mean
How status is updated
HudumaSMS polls the network for delivery reports and updates each message as
reports come back. A message that reads SENT immediately after your request may
read DELIVERED or FAILED a short time later.
To see the outcome, re-read the message from your sending history in the
dashboard, or check it there before reconciling.
callbackUrl is currently not delivered to.The send endpoint accepts a callbackUrl field and echoes it back in the response,
because the older platform’s contract included it. Nothing posts to that URL today —
delivery information is obtained by polling, not pushed to you.Do not build a flow that waits for an inbound callback: it will wait forever. Use
thirdPartyRef to tag each message with your own identifier, then reconcile against
your sending history.
Reconciling reliably
- Set
thirdPartyRef on every envelope to your own record ID.
- Store the
id returned for each outgoing.
- Check status against your history rather than assuming delivery from
202.
Common failure causes
- The number is not a valid Tanzanian mobile number.
- The handset is off or out of coverage for the network’s retry window.
- The sender ID is not approved, or was withdrawn by the network.
- Promotional traffic filtered during a restricted window — see
Sender IDs.