You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/features/sending-messages.md
+12-2Lines changed: 12 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -108,14 +108,14 @@ The **Sending Messages** feature provides a comprehensive API for delivering bot
108
108
!!! info "Additional Notes"
109
109
- Phone numbers must be **E.164-compatible**—except when **the message is encrypted** or `skipPhoneValidation=true`
110
110
- `ttl` and `validUntil` are mutually exclusive
111
-
- Priorities ≥100 bypass all limits/delays
111
+
- Priorities ≥100 are expedited but may still be subject to delay
112
112
- Data messages require app v1.40.0+ and server v1.24.0+
113
113
114
114
## 💻 Code Examples
115
115
116
116
### Text Message
117
117
118
-
Send `Your OTP is 1234` to `+1234567890` without phone number validation via device with ID `yVULogr4Y1ksRfnos1Dsw` if it was active within the last 12 hours. Skip phone number validation and expire the message after 1 hour. Use SIM card slot #1 and set priority to 100 to bypass all limits/delays.
118
+
Send `Your OTP is 1234` to `+1234567890` without phone number validation via device with ID `yVULogr4Y1ksRfnos1Dsw` if it was active within the last 12 hours. Skip phone number validation and expire the message after 1 hour. Use SIM card slot #1 and set priority to 100 to expedite processing.
119
119
120
120
=== "cURL"
121
121
```bash title="Send Text Message using cURL"
@@ -355,6 +355,16 @@ Control message processing order using the `priority` field. Higher priority mes
355
355
| Normal | 0 to 99 | Standard processing (default) |
356
356
| Low | -128 to -1 | Low priority |
357
357
358
+
!!! note Priority-Aware Throttling
359
+
High-priority messages use intelligent throttling that prevents message bursts while maintaining urgency for truly high-priority messages.
360
+
361
+
Standard rate limits and delays apply based on priority comparison with the previously sent message:
362
+
363
+
- **Skip delays**: High-priority messages skip delays ONLY when they have higher priority than the last sent message
364
+
- **Apply delays**: Standard rate limits apply when:
365
+
- Message is not expedited (priority < 100)
366
+
- Message is expedited but previous message had equal or higher priority
367
+
358
368
!!! note "Equal Priority Handling"
359
369
When messages share the same `priority` value, the processing order can be configured. By default, messages are processed in **LIFO order** (Last-In-First-Out), but **FIFO order** (First-In-First-Out) can be chosen in the application settings.
0 commit comments