Download the PHP package telegram-bot-essentials/essence without Composer

On this page you can find all versions of the php package telegram-bot-essentials/essence. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Example code of telegram-bot-essentials/essence

Informations about the package essence

Telegram Bot Essentials (Essence)

tests Latest Version

A Laravel package for running many Telegram bots from one codebase, each bot its own tenant. Instead of one giant update handler per bot, incoming webhook updates are dispatched through typed buses - Commands, ReplyKeys, CallbackQueries, and StateAnswers - so a multi-tenant, multi-locale bot platform stays organized as it grows past a handful of features.

Requirements

Installation

Publish config and translations:

Initialize your main bot and set the webhook:

Configure config/tbe-essence.php and .env values (MAIN_TELEGRAM_BOT_TOKEN, MAIN_UNIQUE_ID, MAIN_ADMIN_CHAT_ID, etc.) before running init.

Webhook URL

Each bot receives updates at:

Authentication uses the Telegram secret_token header, verified against the hashed token stored on the bots table when you run tbe:set-webhook.

Core Concepts

Concept Trigger Purpose
Commands /start, /help, … Slash-command handlers
ReplyKeys Keyboard button text Main menu and navigation
CallbackQueries Inline button presses Menus, actions, starting input flows
StateAnswers Text/media while user has active state Multi-step input, form wizards
Features Called from queries/answers Build TelegramResponse messages
MessageMeta Associated with messages Lock, revert, and update bot messages
StateData Referenced by ID JSON payload storage for wizards and deeplinks

Project Layout (in your Laravel app)

Handlers are discovered from app/Telegram/** once per process/worker at boot, after every companion package has registered its own - so your app's handlers always win a naming collision. Package defaults are loaded from vendor/telegram-bot-essentials/essence/src/Telegram/.

Documentation

The full documentation site — the single source of truth — is maintained separately and being published. It covers:

Artisan Generators

Testing

Extend TelegramBotEssentials\Essence\Testing\TestCase (a Testbench base essence ships in src/) instead of wiring up Testbench yourself - every companion package already depends on essence, so no extra dependency is needed:

postWebhookUpdate() sends a real request through routing, TelegramBotAuthentication, and the controller - not a hand-wired shortcut. Outbound Telegram API calls are faked automatically (Http::fake() in setUp()): LaravelHttpClient, essence's default http_client_handler, routes every SDK call through Illuminate\Support\Facades\Http, so no bespoke SDK mocking is needed.

Related Packages

Essence is the core framework. Optional companion packages, all on Packagist under telegram-bot-essentials/*, extend it:

Register their CallbackQueries and StateAnswers in each package's service provider via callbackQueryBus() and stateAnswerBus().

Contributing

See CONTRIBUTING.md for local setup, the test/lint/analyse commands CI runs, and commit conventions.

License

MIT

All versions of essence with dependencies

PHP Build Version
Package Version
Requires php Version ^8.3
irazasyed/telegram-bot-sdk Version ^3.15
laravel/framework Version ^12 || ^13
ramsey/uuid Version ^4.7
stancl/tenancy Version ^3.9
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package telegram-bot-essentials/essence contains the following files

Loading the files please wait ...