Receiving Messages

The BEAM Chat API provides robust functionality for receiving messages, offering two distinct modes: intercept and inspect. In intercept mode, the bot has the capability to prevent a message from appearing in the public chat. This is particularly useful for commands like !drop, where the message can be made visible only to the sender or the streamer. This mode allows for a more controlled and moderated chat environment, ensuring that certain messages do not disrupt the public conversation.

In addition to controlling message visibility, intercept mode also allows the bot to augment messages. For example, the bot can attach a sticker, badge, or tag to a message. These augmentations can be configured to be visible to everyone in the chat or restricted to the streamer and moderators. This feature enables a richer and more interactive chat experience, where messages can carry additional context or flair, enhancing user engagement.

On the other hand, inspect mode allows the bot to monitor messages without altering their visibility or content. This mode is ideal for analytics, logging, or triggering specific actions based on message content. By using inspect mode, developers can gather insights into chat activity and user behavior without interfering with the natural flow of conversation. Both modes provide powerful tools for managing and enhancing chat interactions, catering to different needs and use cases.