Add position announcements

Enable position announcements on an existing queue.

1. Turn on announcements on the queue and tune the timing.

   {
     "id": "q_01j160r23gw5zkpfjme3fwzs5k", "name": "Support",
     "announce_position": 1,
     "announce_first_sec": 15,
     "announce_interval_sec": 30
   }

   • announce_first_sec: wait this long before the first announcement.
   • announce_interval_sec: the repeat interval; set to 0 to announce once.

2. (Optional) set the announcement language per queue. Otherwise the account/system default is used.

   { "id": "q_01j160r23gw5zkpfjme3fwzs5k", "language": "es-ES" }

3. Test it. Call into a busy queue. After ~15s you’ll hear your position; you’ll only hear it again when your position actually changes, so the hold music isn’t interrupted by a number that hasn’t moved.

Tip

Announcements are push-based and change-aware: the brain only breaks the audio when your position genuinely changes, which keeps stream-mode hold music effectively gapless.

Why it sounds right

Numbers are spoken with the correct grammar for each language. This includes gender-correct number agreement across languages like Hebrew, Arabic, Spanish, French and Russian (in Hebrew, for instance, the position number agrees masculine with “number” while wait-time minutes agree feminine with “minutes”). Each unique line is synthesized once and cached.