Wyślij wiadomość głosową
send_voiceSend voice (TTS)
Place a Polish text-to-speech call (max 600 characters; lectors ewa, jacek, jan, maja). Charges prepaid balance. Wait for explicit user confirmation before calling.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | Yes | Jeden numer, lista numerów (maks. 500) albo grupa kontaktów "group:Nazwa". | |
| text | Yes | Tekst do odczytania. | |
| tries | No | Liczba prób dodzwonienia się (1–6). | |
| lector | No | Głos lektora (domyślnie ewa). | |
| send_at | No | Zaplanowana wysyłka, data ISO 8601 (np. 2026-09-08T09:00:00+02:00). Maks. 90 dni w przód. Pomiń, by wysłać teraz. | |
| reference | No | Własny identyfikator (np. numer zamówienia) do odszukania wiadomości później. | |
| expires_at | No | ISO 8601: po tym czasie dostawca przestaje próbować doręczyć (15 min – 72 h po wysyłce). Np. termin wizyty, po którym przypomnienie nie ma sensu. | |
| send_window | No | Okno godzin wysyłki w czasie polskim, np. "08:00-20:00". Poza oknem wysyłka jest przesuwana na najbliższy początek okna. Pomiń, by użyć ustawienia konta. | |
| idempotency_key | No | Unikalny identyfikator zatwierdzonej wysyłki. Przy ponowieniu zachowaj tę samą wartość; nie zmieniaj po timeoutcie. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | ||
| status | No | ||
| accepted | No | ||
| messages | No |