Skip to content
Translate Ideas and Comments
Choose language:
There was an error during translation
← Developers

How can we improve the developer experience on Twitch?

Developers: Documentation

Categories

Add existing IRC WHISPER command to IRC documentation

The IRC gateway passes whispers using the WHISPER code:

[16:36:15] [@] @badges=bits-charity/1;color=#3E2E18;display-name=foo;emotes=;message-id=2;thread-id=21001676_470220570;turbo=0;user-id=2109996;user-type= :foo!foo!foo.twitch.tv WHISPER myuser :this is a whisper

But I am unable to find any reference to that code on https://dev.twitch.tv/docs/irc/commands where I would expect it, or any other documentation page under the "Chatbots and IRC" section.

I would suggest adding the WHISPER command to the list of commands at the top of the page on the IRC: Commands section, something similar to:

WHISPER Receive a Whisper message from another user

and then the prototype at the bottom, to include the fact that it appears the WHISPER command is (appears to be) a one-way command (the server can send a WHISPER to you, but you can't send a WHISPER to other users. (When I tried to send a whisper, I got: [16:45:58] tmi.twitch.tv reported an error: WHISPER :Unknown command).

Or maybe this is deprecated or not final yet, but I figured I'd point it out just in case it was an oversight. Thanks for all the hard work!
15 votes

We're glad you're here

Please sign in to leave feedback
Signed in as (Sign out)
Close
Close

We’ll send you updates on this idea

eggdroptest shared this idea  ·   ·  Report…  ·  Admin →
Comments are closed An error occurred while saving the comment
  • adrian_learns commented  ·   ·  Report

    Hello!

    It seems the documentation for the [WHISPER](https://dev.twitch.tv/docs/irc/commands/#whisper) command has since been added under the requested _Twitch IRC Commands_ section of the documentation.

    However, the <to-user> and <from-user> parameters are mixed up, both in the prototype:

    ```plaintext
    :<to-user>!<to-user>@<to-user>.tmi.twitch.tv WHISPER <from-user> :<message>
    ```

    As well as in the text description of the example command:

    ```plaintext
    :petsgomoo!petsgomoo@petsgomoo.tmi.twitch.tv WHISPER foo :hello
    ```

    In the documentation the text says that _foo_ sent a whisper to _petsgomoo_, but it's the other way around?

    As an example, here's a message from _roilisi_ to my bot _adrianbotjs_:

    ```plaintext
    :roilisi!roilisi@roilisi.tmi.twitch.tv WHISPER adrianbotjs :message
    ```

    This agrees with eggdrop's snipped and the fields follow the same order as they do in the `PRIVMSG` command.

    Kindly,
    Adrian.