teleCast

Description

teleCast connects your Telegram group to your WordPress website, turning it into a live chat
system (aka “widget”) your visitors can use directly from any page where you place our shortcode.

IMPORTANT

This plugin requires an account at thesaasfactory.net** to function. There is a
one-time registration fee of USD15.00 to onboard. If you wish to use the translation option then
you will also need to top up translation credit once an initial 50000 characters have been used
for evaluation/testing. Pre-purchase of 1M (one million) characters costs USD25.00.

The plugin loads the teleCast widget JavaScript from thesaasfactory.net servers, and all chat
messages are relayed through the teleCast service to enable real-time communication between your
website and Telegram. Our translation services are powered by DeepL Pro. Available languages
therefore match those available from DeepL.

How it works

  1. Visitors send messages through the widget on your WordPress site
  2. Messages are transmitted to thesaasfactory.net servers via WebSocket connection
  3. thesaasfactory.net relays messages to your Telegram group
  4. Replies from your Telegram group follow the same path back to your website visitors
  5. Messages are translated in both directions when visitors use a different language than your
    group

Messages flow in both directions — visitors on your site chat with your Telegram group in real
time. No page reloads, no polling delays. teleCast uses a persistent WebSocket connection for
instant delivery and harnesses the power of Telegram bots to place/read messages in the group.

Key features

Telegram bridge
— your Telegram group becomes your chat backend. Manage conversations from any device using the
Telegram app you already use and know.

Real-time, bi-directional
— messages from your Telegram group appear almost instantly in the widget, and visitor messages
appear in your group.

Multilingual translation
— teleCast includes English and your choice of a second language. Messages are automatically
translated in both directions so visitors and group members can communicate naturally in their
own language. Powered by DeepL Pro.

Shadow DOM isolation
— the widget is fully isolated from your theme’s CSS. It looks great on any site without style
conflicts but may be further customized if desired. Light and dark themes are configured with a
simple attribute but more options are available for precise styling.

Simple shortcode
— add [telecast token="YOUR_TOKEN" channel="your-channel"] to any page or post. * No jQuery,
no dependencies
— a single lightweight vanilla JS file.

Service requirements

  1. Create a Telegram bot via @BotFather and add it to your group as an admin.
  2. Register for an account at thesaasfactory.net and create a
    teleCast channel.
  3. Add the [telecast] shortcode to any page with your token and channel slug.

Translation credits are managed via your account at thesaasfactory.net. Recognising that some
phrases are used repeatedly in chat sessions, we cache translations and try to match our cache
first. All such matches are free — credits are only consumed when a fresh translation is required.

External Services

This plugin requires and relies on the teleCast service hosted at thesaasfactory.net to
function.

What data is transmitted:

When you use this plugin, the following data is sent to thesaasfactory.net:

Chat messages
— All messages sent by website visitors through the widget are transmitted to thesaasfactory.net
servers, which relay them to your Telegram group. Replies from your Telegram group are
transmitted through thesaasfactory.net back to your website visitors.

Visitor display names
— The display name entered by visitors when they start chatting is transmitted to identify the
sender in your Telegram group.

Translation requests
— When messages need translation (visitor language differs from group language), the message
content is sent to thesaasfactory.net for translation via DeepL Pro before being relayed.

WebSocket connections
— The widget establishes a persistent WebSocket connection to wss://ws.thesaasfactory.net for
real-time message delivery. * Widget JavaScript — The plugin loads the teleCast widget
JavaScript file from https://thesaasfactory.net/telecast/assets/telecast.js on every page where
the shortcode is used.

When data is sent:
– When a visitor opens a page containing the [telecast] shortcode (widget JavaScript loads)
– When a visitor enters their name and starts chatting (WebSocket connection establishes)
– Every time a message is sent or received (messages are relayed through the service)
– When messages require translation (sent to DeepL Pro via thesaasfactory.net)

Service information:
– Service provider: the SaaS factory (thesaasfactory.net) * Terms of Service:
https://thesaasfactory.net/terms.php * Privacy Policy: https://thesaasfactory.net/privacy.php

By using this plugin, you acknowledge that chat messages and visitor display names will be
transmitted through thesaasfactory.net servers to enable the Telegram bridge functionality.
Messages are encrypted in transit but are processed by the service to enable translation and
relay to Telegram.

Installation

  1. Upload the telecast folder to /wp-content/plugins/. 2. Activate the plugin through the
    Plugins menu in WordPress. 3. Register for a free account at
    thesaasfactory.net. 4. Create a teleCast channel in your dashboard
    and note your token and channel slug. 5. Add the shortcode to any page or post:

    [telecast token=”YOUR_TOKEN” channel=”your-channel”]

To set the theme, add theme="light" or theme="dark" (default is light):

[telecast token="YOUR_TOKEN" channel="your-channel" theme="dark"]

FAQ

Do I need a Telegram account?

Yes. teleCast bridges your WordPress site to a Telegram group. You will need a Telegram account
and a group to connect.

Is teleCast free?

The plugin is free and has a GPL v2 licence. An account at thesaasfactory.net gives you access to two languages
(English plus your choice of a second language). There is a one-time fee of USD15.00 payable to register a new
account. This includes 50000 (fifty thousand) translation characters for test/evaluation. Further translation
credits are required for multilingual chat and are available to purchase from your dashboard.

What languages are supported?

teleCast currently supports English and one additional language per channel. More languages are
coming soon, along with default (other than English) language options for the widget GUI and documentation.

Who provides the translation?

Translation is powered by DeepL Pro, one of the most accurate machine translation services
available. teleCast aggregates all customer traffic through a single DeepL Pro account, which
means better cache efficiency and lower costs passed on to you.

Does it work with page builders?

Yes — the [telecast] shortcode works anywhere WordPress shortcodes are supported, including
Elementor, Divi, and the block editor (via a Shortcode block).

Will the widget conflict with my theme?

No. The widget runs inside a Shadow DOM, which fully isolates it from your theme’s CSS. It will
not affect or be affected by your site’s styles.

Where do I find my token and channel slug?

Log in to your dashboard at thesaasfactory.net, go to the Channels
tab, and copy your token and channel slug from there.

Reviews

There are no reviews for this plugin.

Contributors & Developers

“teleCast” is open source software. The following people have contributed to this plugin.

Contributors

Translate “teleCast” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.

Changelog

1.0.3

  • Initial public release.
  • Telegram-to-WordPress live chat bridge via WebSocket.
  • Real-time bi-directional multilingual translation powered by DeepL Pro.
  • Shadow DOM widget isolation.
  • Light and dark theme support.
  • Simple [telecast] shortcode.