Hello! Thank you for purchasing WPmaT. This guide will walk you step by step through the installation and setup of WPmaT, and will also answer some of the most frequently asked questions from our users.

logo WPmaT | Mini Apps Telegram WordPress plugin

Create a tiket

ini Apps Telegram WordPress Plugin
WPmaT Technical Requirements
Activate a license
Bot token in Telegram
Token Integration
Bot Navigation Buttons
Message Fields
Mini Apps Telegram is Successfully
Sending Notifications
Frequently Asked Questions
Latest Updates

WPmaT Technical Requirements

  • SSL certificate and HTTPS (without a local server)
  • PHP version 7.6 or higher
  • WordPress version 5.2.2 or higher

Activate a license for a theme purchased from ThemeForest

  1. Obtain Your License Key (Item Purchase Code):

    • Log in to your ThemeForest account.
    • Hover over your username at the top of the page and select "Downloads" from the dropdown menu.
    • Find the purchased theme in the list and click the "Download" button.
    • In the dropdown, select "License Certificate & Purchase Code."
    • Open the downloaded file; your license key will be listed as the "Item Purchase Code."

  2. Activate the Theme in WordPress:

    • Log in to the WordPress admin panel of your website.
    • Navigate to Appearance > Theme License (the name of the section may vary depending on the theme).
    • Paste the previously copied license key in the appropriate field.
    • Click Save Changes or Activate to complete the activation process.

Notes:

  • Some themes may not require license activation through the WordPress admin panel. In such cases, it’s enough to install and set up the theme without additional activation.
  • If you do not see a section to enter the license key or if you face difficulties during activation, refer to the documentation provided with the theme or contact the theme's author for support.

Important: A Regular License allows you to use the theme to create a single end product (e.g., one website), which can be made available to users for free. For products that will be sold or require payment for access, an Extended License may be required.

If you have further questions or issues with activation, it is recommended to contact ThemeForest support or the author of the purchased theme.

To get a bot token in Telegram

To get a bot token in Telegram, follow these steps:

  1. Open Telegram and Start a Chat with BotFather:

    • In the Telegram app, search for BotFather or go directly to t.me/BotFather.
    • BotFather is the official bot used for creating and managing Telegram bots.

  2. Create a New Bot:

    • Type the command /newbot and send it to BotFather.
    • BotFather will ask for a name for your new bot. Enter a name that clearly describes your bot's purpose.
    • Next, you will be asked to create a username for the bot. The username must be unique and end with "bot" (e.g., MyGreatBot).

  3. Receive the Token:

    • After choosing a name and username, BotFather will generate an API token for you.
    • This token will be in the format of a long string (e.g., 123456789:ABCDefGhIjKlmNoPQrsTuVwxyz012345678).
    • Save this token—it's important for integrating your bot with your application or platform.

Token Integration with the WPmaT Plugin

Save the Token
After creating a bot through BotFather, save the token. This token will be used to integrate the bot with your WordPress site via the WPmaT plugin.

Upload the Token

  1. Go to the WPmaT plugin settings on your WordPress site.
  2. Find the "Bot Token" field.
  3. Paste the token into this field.

Set Up Basic Bot Buttons
Below the token input field, you can enable or disable the display of the basic Telegram bot buttons using a checkbox. Important! If your Mini App requires authorization transfer, the transition to the website should be left on the button labeled with demo text “Open Web App.” The link will lead to the homepage of the WordPress site.

Customize Button Text
If you want to personalize the button text:

  1. In the plugin settings, find the section for editing button text.
  2. Enter the desired labels and save the changes.

Bot Navigation Buttons

Adding Buttons with Redirects

Create any number of buttons for your bot.
Customize redirects within Telegram Mini Apps.
If opening an external website within the mini-app is required, add the following line to the header:

htmlКопировать код<script async src="https://telegram.org/js/telegram-web-app.js"></script>

Note: No additional settings are required on the site where this plugin is installed!

Redirects to External Resources

Add links to other Telegram bots or channels.

Exiting Telegram Mini Apps

Add buttons for exiting the Telegram Mini Apps shell to the user's default browser.

Changing Button Text

Edit button text to make it clear and user-friendly.
Support for any language for button text.

Welcome Message Fields in WPmat

First Entry Welcome Message
In this field, you can specify the text that will be displayed to users upon their first entry into the Telegram Mini Apps.
Use the shortcode %FIRST_NAME% to automatically display the user's name, authorized through Telegram.
To correctly display a space after the name, add \n\.
Example text:
"Welcome, %FIRST_NAME%! We're glad to see you in our Telegram Mini App. Use the buttons below to navigate."

Returning User Welcome Message
This field is intended for the text that will be displayed to users upon their return to the app.
The shortcodes %FIRST_NAME% and \n\ are also supported.
Example text:
"Hello again, %FIRST_NAME%! It's great to see you back. How can we assist you today?"

Fill in both fields to create a personalized and comfortable experience for your users! 🎉

Your WordPress Mini Apps Telegram is Successfully

Congratulations! Your WordPress Mini Apps Telegram is Successfully Set Up and Ready to Use

Saving Changes
After setting up the welcome messages and buttons, click the "Save" button to apply the changes.

Syncing with the Bot
After saving, click the "Sync with Bot" button to ensure the updates are reflected in your Telegram bot.

All Done!
Congratulations! Your WordPress Mini Apps Telegram is successfully set up and ready to use.
Now users can interact with your website through a convenient mini-app in Telegram. 🚀

Enjoy smooth operation and high conversions! 🎉

Sending Notifications with WPmat

Effective Marketing Tool
Your website, transformed through WPmat, now has the ability to send notifications to all users interacting with the Telegram bot.
Notifications are delivered in real-time directly to the Telegram messenger.

Creating a Broadcast
Enter the notification text in the corresponding field.
Attach an image to create a visual impact.

Notification Preview
A preview of your message and attachment will be displayed in real time.
If you need to send a video, upload it to YouTube and provide the link.

Sending the Notification
Click the "Send to All" button, and your broadcast will be instantly delivered to all users.

WPmat turns your Telegram bot into a powerful channel for fast and effective marketing! 🚀

Frequently Asked Questions (FAQs)

Can I add an inline button next to the bot's message to open my website through a mini-app?
Answer:
Yes, you can. Check out an example of a WordPress website transformed into a Telegram Mini App using the WPmat plugin.

  1. Telegram Mini Apps Image
  2. Mini Apps Text
    "Tarot and Astrology"
  3. Button

All of these settings are configured via BotFather. See the image below for reference.
Note: WPmat's standard features cannot control BotFather settings.

Best regards, Valery.

On my channel, you will find video tutorials dedicated to working with the WPmat WordPress plugin. You can watch them here: YouTube channel.

Additionally, you can join the discussion and ask questions in the Telegram group "WordPress in WPmaT.": https://t.me/UE_WordPress.

Stay tuned to learn more! 🚀

Latest Updates

We're constantly working on improving our plugin. Here you can see the latest updates and added features.

 
get acquainted with the changes and improvements Wpmat