Transform

Modifying Incoming Messages

What It Does

The /transform command allows you to modify or filter all incoming messages before they are forwarded to the target chat. If you don’t want to modify the messages, you can directly start forwarding by using the /work command.

Prerequisite

Incoming and Outgoing Chats Configured:

• Incoming Chat: This is the chat where Auto_Forwarder_Bot will monitor and pick up messages to forward. You need to set this up using the /incoming command.

• Outgoing Chat: This is the chat where Auto_Forwarder_Bot will send the forwarded messages. You need to configure this using the/outgoing command.

Both the incoming and outgoing chats must be configured beforehand. Without an incoming chat, there will be no messages to transform. Similarly, without an outgoing chat, there will be no destination for the transformed messages. The transformations you apply (like filters, blacklists, or whitelists) will only work on messages moving from this source to the destination. If either one isn't set, Auto_Forwarder_Bot won't be able to do its job.

How to Use It

You can customize which types of content Auto_Forwarder_Bot forwards by toggling the following options:

Options

• Media:

  • Enabled: The bot will forward media files (images, videos, documents, etc.) included in messages.

  • Disabled: Only text messages will be forwarded; no media files will be sent.

• Text:

  • Enabled: The bot will forward all text messages from the incoming chat.

  • Disabled: Only media files will be forwarded; no text messages will be sent.

• URL Preview:

  • Enabled: When a message contains a link, the bot will display a URL preview, which includes an image, title, and description of the linked content.

  • Disabled: Only the raw URL will be forwarded without any preview. (Note: Disabling this option does not remove all URLs, it only blocks URL previews. To remove URLs from messages entirely, use the /filter command.)

Important Notes

• Note 1: At least one of TEXT or MEDIA must remain enabled for message forwarding to work. If both are turned off, no messages will be forwarded.

• Note 2: This is a URL preview, not just the URL itself. The bot will display a URL preview when the message contains a link; otherwise, it will not.

What is a URL preview? A URL preview provides a snapshot of the link being shared, showing its title, description, and an image. This helps users understand the content before clicking. Learn more about URL previews here.

Real-Life Use Cases

• Text Replacement: Replace certain usernames in incoming messages with new ones for branding or privacy purposes.

• Ad Blocking: Block messages containing unwanted advertisements by adding common ad terms to the blacklist.

• Content Filtering: Ensure that only relevant messages are forwarded by setting up a whitelist with specific keywords.

Try using /blacklists, /whitelists, or /filter to achieve more effective transformations. Each approach can help refine your processes and improve outcomes.