The SendTransactionalWhatsapp function sends transactional WhatsApp messages to recipients.
You must use your own partnerId (which you can find in the dEngage Panel > Instant Message Partner Details page) along with the payload to send messages.
One important note: you can send only one message to a single recipient at a time.
The template must be approved, and the request is validated against the selected template (required components, parameter counts, button types and order). If validation fails, the response returns HasError: true with the reason in ErrorMessage, and the message is not sent.
A successful response means the message was accepted for sending; it can still be rejected later by WhatsApp.
Language Selection Logic for WhatsApp REST API
When sending WhatsApp messages via REST API, multi-language template support is now available. The system determines which template to send by following this order of checks:
1. Request-level languageCode
If languageCode is provided in the request and a template exists in that language, that template is used.
languageCode must be sent in upper case (e.g. EN, TR). If it does not match any template language, no error is returned and the next check is applied.
2. Recipient’s language
If no matching template is found for the request’s languageCode, the system checks the recipient’s language.
If a template exists in the recipient’s language, it will be used.
3. Account-level language
If no recipient language match is found, the system checks the account’s default language.
If a matching template exists for the account language, it is used.
4. Fallback to default template
If none of the above provide a match, the system falls back to the first available template in the list.
Idempotency Support: This endpoint supports idempotency via the optional traceId parameter. For more information, see Rest API Idempotency.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
429Too Many Requests