🧠 Documantaion & examples

Welcome to the Programmable Chat feature!

This allows developers to inject custom JavaScript logic into the chat system and interact with messages in real time. Below you’ll find a full explanation of how this works, what tools are available, and how to write and test your own handler functions.

🔹 Introduction

❔ What is Programmable Chat?

Programmable Chat enables message-level moderation, transformation, or dynamic response handling by attaching custom JavaScript code to your chat. It runs before a message is submitted to the database and allows for fine-grained control.

📝 Use Cases

You can customize how messages are processed using programmable logic. Common use cases include:

• Message moderation — Block messages with harmful content, profanity, or spoilers.
• Content rewriting — Automatically fix formatting, redact links, or normalize text (e.g., converting ALL CAPS to lowercase).
• Auto-replies — Respond to greetings, keywords, or help requests with custom messages.
• Attachment injection — Replace or respond to specific keywords with images, files, or other media attachments.
• Spam filtering — Detect and reject repetitive, all-caps, or link-heavy messages.
• Dynamic interaction — Modify messages in real time before they're shown, based on user input or context.

These use cases can be combined or expanded to tailor chat behavior to your community’s needs. And of course, you can always experiment with your own logic.