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!
-
adrian_learns commented
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.