WHMCSBot for Telegram

WHMCSBot for Telegram

Developed By Chenzo David

Compatible with WHMCS v9.0

WHMCSBot for Telegram

WHMCSBot for Telegram (WBFT) connects your Telegram bot with your client workflow so customers can interact with your business faster, more securely, and in a more convenient way.

It is built for hosting companies and service providers who want Telegram to become an extension of their client experience without exposing unsafe direct account access.

What this module does

WBFT allows Telegram users to:

  • Link their account securely using email OTP verification
  • Unlink and relink accounts when needed
  • Browse your services in sets directly from Telegram
  • Search domains and see availability
  • Open checkout for available domains
  • View account summary details
  • View owned domains
  • View unpaid invoices
  • Open the client area with secure one-time access
  • Reach support from Telegram
  • Use a locked company-support AI assistant

Built for real company workflows

This module is not just a message bot. It is designed to work as a proper business integration layer between Telegram and your client platform.

The goal is to help you:

  • reduce friction for customers
  • increase engagement
  • improve order discovery
  • make support easier to access
  • give customers a faster path to billing and service actions
  • provide AI assistance without turning the bot into a general public chatbot

Core features

1. Secure account linking

Customers can link their Telegram account using a one-time verification code sent to their account email address.

This helps ensure the Telegram user is the real account owner before account-related functions become available.

2. Account security controls

The module includes:

  • user-side unlink option
  • admin-side unlink option
  • optional automatic unlink after a configured number of hours
  • support for relinking another account later

This is especially useful if a Telegram account is lost, compromised, or shared.

3. Client account tools

After linking, users can access:

  • Account summary
  • Owned domains
  • Open invoices
  • Secure client area access

4. Domain search and order handoff

Users can search domains from Telegram.

They can:

  • check exact domain availability
  • get suggestion-based alternatives
  • see pricing where configured
  • continue to checkout on your site

5. Guest service browsing

Even without linking an account, visitors can browse your services from Telegram.

Services are shown in sets so the experience stays clean and not overloaded.

This helps turn Telegram into a lightweight sales channel.

6. Support routing

The module supports direct support routing with buttons such as:

  • Open Support
  • Visit Website
  • Start Live Chat

You can configure these links from the admin side.

7. Locked AI support mode

The built-in AI system is designed for company support only.

Admin can choose:

  • OpenAI
  • Claude
  • Gemini

You can configure:

  • API key
  • model name
  • allowed topics
  • refusal message
  • system prompt

This means the bot can answer support-related questions while staying restricted to your business scope instead of behaving like a general chatbot.

Designed for practical deployment

WBFT is suitable for companies that want to use Telegram as:

  • a support entry point
  • a billing entry point
  • a domain discovery tool
  • a service discovery tool
  • an account access convenience layer

Use cases

Examples include:

  • hosting companies
  • domain sellers
  • server providers
  • digital service agencies
  • billing-based online service businesses

Admin controls

The module provides admin-side controls for:

  • bot token setup
  • webhook setup
  • AI provider selection
  • support links
  • auto unlink timing
  • service catalog display
  • domain search configuration
  • linked user management

Why use WHMCSBot for Telegram?

Many customers prefer messaging platforms over logging into a dashboard first.

WBFT helps bridge that gap by giving them a guided and secure way to interact with your business directly from Telegram.

It improves convenience without removing your control.

Included functionality summary

  • Telegram bot integration
  • secure email OTP linking
  • unlink and relink flow
  • auto unlink protection
  • admin unlink action
  • account summary display
  • domain display
  • unpaid invoice display
  • secure client area access
  • guest service browsing
  • domain search and checkout handoff
  • direct support buttons
  • locked AI support mode
  • admin configuration dashboard

Requirements

  • WHMCS 8.x
  • PHP environment with cURL enabled
  • Telegram bot token from BotFather
  • valid public HTTPS URL
  • optional OpenAI, Claude, or Gemini API key for AI support

Installation Guide

1. Upload the module

Upload the wbft folder to:

/modules/addons/wbft/

2. Confirm required files

Make sure the folder contains the main module file, webhook file, hooks file, and the lib directory.

3. Activate the module

In the admin area, go to:

Setup > Addon Modules

Find WHMCSBot for Telegram and click Activate.

4. Configure access permissions

Set which administrator roles can access the module.

5. Open module settings

After activation, click Configure and fill in:

  • Company Name
  • Public Client Area URL
  • Telegram Bot Token
  • Telegram Bot Username
  • Webhook Secret Key
  • OTP settings
  • Services catalog settings
  • Domain search settings
  • Support links
  • Auto unlink timing
  • AI provider settings (optional)

6. Enable the bot

Tick Enable Bot and save.

7. Set the webhook

Open the module dashboard and use:

  • Test Bot Token
  • Set Webhook

8. Test the bot

In Telegram, open your bot and send:

/start

Then test the menu options one by one.

9. Optional AI setup

To enable AI support:

  • enable AI support
  • choose OpenAI, Claude, or Gemini
  • enter the matching API key
  • configure allowed topics
  • configure refusal message
  • configure the system prompt

10. Cron note

If you use automatic unlink expiry, ensure your normal scheduled automation is already running properly so the module hook can process expiry.

11. Recommended testing checklist

Test the following before launch:

  • account linking
  • unlink and relink
  • admin unlink
  • services catalog
  • domain search
  • invoice display
  • secure client-area access
  • support buttons
  • AI support mode

Notes

This module is designed to work as an addon module with admin controls and scheduled automation support.

It is ideal for businesses that want a more modern Telegram-based customer flow while keeping account access controlled and support-focused.

Quick Start

  1. Create your Telegram bot with BotFather
  2. Copy the bot token
  3. Upload the module
  4. Activate it from Setup > Addon Modules
  5. Enter your bot token and public URL
  6. Generate a webhook secret
  7. Enable the bot
  8. Set the webhook from the module dashboard
  9. Send /start to the bot
  10. Test linking, services, domains, and support

 

There are no reviews yet!

Be the first to review WHMCSBot for Telegram.

Version Compatibility


Compatible with WHMCS v9.0

Full Version Compatibility


  • All versions of WHMCS v9.0
  • Selected versions of WHMCS v8.13
        8.13.0 - 8.13.1
  • All versions of WHMCS v8.12
  • All versions of WHMCS v8.11

System Requirements


  • 8.11+

* Requirements listed are in addition to the WHMCS default system requirements.

Support for this product

The best place to start if you need help with a specific product is to contact the developer. All WHMCS Marketplace developers have both a website and support URL listed.

Developed By Chenzo David

Changelog

v1.6.0 Released April 8th, 2026

Latest Version


Changelog

1.6.0

  • Added guest services catalog
  • Added services menu entry
  • Added separate AI menu entry
  • Added paged service browsing flow

1.5.0

  • Added locked AI support mode
  • Added OpenAI, Claude, and Gemini support
  • Added AI prompt, topic, and refusal controls

1.4.0

  • Added admin unlink
  • Added support routing
  • Added automatic unlink expiry hook

1.3.0

  • Added domain search and checkout handoff

1.2.0

  • Added account tools, domains, invoices, and secure client-area access

1.1.0

  • Added OTP account-linking flow

1.0.0

  • Initial release

 

See also

cPanel DNS Manager Module for WHMCS

cPanel DNS Manager for WHMCS is an addon module which allows customers who have only domain names without a hosting package to manage DNS zones of their domain names.

Commercial
Project Management Addon

Track and Bill for your Projects using WHMCS

Commercial
CyberESXI

CyberESXI is a module designed for hosting companies using the WHMCS system. With Esx Addon, you can enable your clients to manage the virtual servers you created with Vmware ESX, ESXi software.

Commercial
Nameserver details widget hook by SparrowHost

This hook will let your customers know what is your nameservers on their client area at services page.

Free
Enhanced Support System

Enhanced Support System brings you an alternative support experience with clear department layout and ticket counts for each ticket status in every department.

Free