The rule
Messages from one line to one contact are delivered in the order you created them. While an earlier message to that contact is still on its way (pending, queued, sending or scheduled), a
later message waits behind it. When the earlier one is delivered, or fails for good, the next one goes.
This keeps conversations readable: your follow-up never lands before your intro, and a link never lands
before the message that explains it.
It is not a global queue:
- Different contacts on the same line are not affected.
- The same contact on a different line is not affected.
What does not hold the queue
Once a contact has received at least one message on this line, two kinds of earlier message no longer hold later ones back:
A first message (nothing delivered to this contact on this line yet) keeps the strict rule: nothing
overtakes the earliest message.
How to tell a message is waiting
A message held by the queue has:status: "scheduled"rescheduleReason: "fifo:serial_lock_blocked"fifoBlockedBy: the id of the earlier message it waits behindfifoBlockerAt: when that earlier message is due, if it is planned for a set time
GET /api/messages. The Tuco Unibox and
mobile app show the message in its thread as waiting, with the reason.
Tuco re-checks a waiting message on its own (after about 10 s, 30 s, then every 90 s), so it goes soon after
the one in front of it is delivered. You don’t need to do anything.
Send now, and skip the queue
Sometimes the message in front is not urgent, for example a reminder planned for tonight, and you want the new one out now. Ask for that per message, either when you send it:passFifo: truelets this one message go ahead of the earlier ones. It never changes the order of anything else.- It is refused on a first message. If nothing has been delivered to this contact on this line yet, the answer
says
fifo.passFifoRefused: "first_message"and the message keeps waiting. - It works on a message that is waiting in the queue, and on a reply still in its Undo window.
- It never happens by default. Without
passFifo, every message keeps its place.