Can Someone Please Clarify the Chat Bot Whisper Situation

You can use whispers, and in some situations they may work, but at other times your usage may be detected as spam, for whatever reason, and not allowed through.

If you think the documentation should be changed, the correct place to suggest that would be a feature request on UserVoice https://twitch.uservoice.com/forums/310213-developers?category_id=358000