Skip to content
twitch.apiv2.0

Reference / API groups

twitch.whispers

Whispers: send a private message to a user.

Every method of twitch.whispers, with its parameters, what it returns and the token it needs.

twitch.whispers.send(params, options?): Promise<void>

Sends a whisper to a user. Twitch can discard a whisper it finds suspicious and still report success, so a resolved call is no proof of delivery. Limited to 40 different recipients per day, 3 whispers per second and 100 per minute.

Token: user, scope user:manage:whispers.

NameTypeDescription
from_user_idstringUser who sends the whisper. Their account needs a verified phone number. Defaults to the user making the call.
to_user_id requiredstringUser who receives the whisper.
message requiredstringText of the whisper. Twitch cuts it at 500 characters when the recipient never whispered the sender, at 10,000 otherwise.

options: Request options for this call: as, token, signal, timeout, retries.

Promise<void>

await twitch.whispers.send({ to_user_id: "198704263", message: "Thanks for the raid" });

Twitch reference