Documentation

Requirements

• WordPress 5.0+
• PHP 7.4+
• A free Telegram account
• A Telegram Supergroup with Forum Topics enabled

Step 1: Create Your Telegram Bot (2 minutes)

1. Open Telegram, search for @BotFather
2. Send /newbot
3. Choose a name: e.g. "My Site Support"
4. Choose a username: e.g. mysitesupport_bot
5. BotFather gives you a Bot Token — copy it (looks like: 7123456789:AAF...)
6. Also run /mybots → select your bot → Bot Settings → Allow Groups → Turn on

Step 2: Create Your Telegram Supergroup

1. Create a new Telegram group
2. Go to Group Settings → Edit → Group Type → set to Supergroup (or it auto-converts)
3. Go to Group Settings → Topics → Enable Topics
4. Add your bot to the group as Admin with these permissions:

• ✓ Manage Topics
• ✓ Send Messages
• ✓ Pin Messages

Step 3: Get Your Group Chat ID

1. Add @userinfobot to your group temporarily
2. It will post the group's Chat ID (looks like: -1001234567890)
3. Remove @userinfobot after

Step 4: Install the Plugin

1. Purchase and download from for-wordpress.org
2. WP Admin → Plugins → Add New → Upload Plugin
3. Upload the .zip → Install → Activate

Step 5: Connect Bot to Plugin

Go to WP Admin → WP-TG Live Chat → Settings:

• Bot Token: paste your BotFather token
• Group Chat ID: paste your group ID (with the minus sign)
• Webhook Secret: generate a random string (or use the auto-generate button)
• Save Settings → click "Register Webhook"

Widget Appearance

• Primary Color: your brand color
• Position: bottom-right or bottom-left
• Border Radius: 0px (square) to 24px (rounded)
• Animation: slide up, fade, or bounce

All changes preview live in the admin panel.

Business Hours

Set open hours per day. Outside hours:

• Widget shows "We're offline" message
• Visitor messages are saved
• You receive email notification

Auto-Open Triggers

• Time delay: open widget after X seconds on page
• Scroll depth: open when visitor scrolls X% of page
• Combine both: open on whichever comes first

Quick Replies

Pre-set answers your team can send with one click in Telegram.

Configure up to 10 quick replies in admin settings.

Page Visibility Rules

• Show on all pages (default)
• Show only on specific URLs
• Hide on specific URLs (e.g. checkout page)

Conversation History

Every conversation is stored locally. Browse by date, filter by rating, search by visitor email.

Statistics

• Total conversations per day/week/month
• Average response time
• Satisfaction rating breakdown
• Peak hours chart

Troubleshooting

Changelog