Download the PHP package arodu/tebo without Composer

TeBo: CakePHP plugin for Telegram Bot

TeBo is a plugin that integrates a Telegram bot into CakePHP 5 applications, allowing configuration and management of custom commands with an easy setup.

Installation

1. Install the plugin using Composer:

2. Load the plugin in your project:

3. Add your Telegram bot token to the .env file, or set it as an environment variable:

Webhook Configuration

TeBo offers commands to manage the webhook setup in Telegram. To run these commands, use:

The available options are:

1. Get Webhook URL: Displays the current webhook URL configured on the local system.
2. Set Webhook to telegram: Sets the webhook on Telegram, linking the bot to a specific URL to receive updates.
3. Delete Webhook from telegram: Deletes the webhook from Telegram, stopping the bot from receiving updates.
4. Get Webhook info from telegram: Shows information about the webhook configured on Telegram, including status and connection details.
5. Get bot info: Displays information about the bot, including the bot's name, username, and ID.

Additional Configuration (Optional)

You can add the following values to the .env file to enhance webhook functionality:

• WEBHOOK_OBFUSCATION: Obfuscates the webhook URL, adding an additional security layer.
• WEBHOOK_BASE: Sets the base domain for the webhook URL. If not specified, 127.0.0.1 is used, which is incompatible with the Telegram API.

Configuring CSRF Protection

CakePHP includes built-in protection against Cross-Site Request Forgery (CSRF) attacks. However, to allow Telegram webhooks to work properly with TeBo, you need to exclude requests coming from the plugin from this protection.

To do this, adjust the middleware configuration in the src/Application.php file. Modify the middleware method to include the following logic:

[!WARNING] Why Is This Necessary? Telegram cannot send custom headers (such as CSRF tokens), which would cause webhook requests to be rejected if CSRF protection is enabled. By configuring this exclusion, we allow Telegram to interact with our application without compromising the overall security.

Bot Testing

Once the webhook and token are configured, the bot should be ready to work. You can test it on Telegram using the following commands:

• /start
• /hello
• /about

Customization

To customize the bot's options, you can create a configuration file in config/tebo.php with the following structure:

[!NOTE] You can find more information about this file on config/tebo.php in the plugin's directory.

Usage

The plugin provides a default Action that can be extended to create custom actions. To create a new action, follow these steps:

1. Create a new command class in the src/Actions directory.
2. Extend from \TeBo\Action\Action or Implement the \TeBo\Action\ActionInterface interface.
3. Add the command to the config/tebo.php file.

To add the command to the configuration file config/tebo.php, use the following code:

[!NOTE] After adding the command, you can test it by sending /prices to the bot.

Bake a New Action

Also, you can bake a new action using the following command:

Send an HTML Formatted Message

To send a message with HTML formatting, use HtmlMessage:

[!NOTE] In this example, HTML tags such as <b>, <i>, <a>, and <code> are supported for text formatting.

Send a Photo

• Example 1: Send a Local Photo
  If the image is stored locally, use the path to the image file:

• Example 2: Send a Photo from a URL with a Caption
  You can also send a photo from a URL with a custom caption:

Sending with a chat ID

To send a message to a specific chat ID, use the following code:

Notes

• Ensure that the .env file is properly configured before testing the bot.
• The default command executed by the plugin is \TeBo\Action\Command\NotFoundAction::class. You can disable it by setting it to null.

License

The MIT License (MIT). Please see License File for more information.