1. What Is a Telegram Bot Token? #
- A bot token is like an API key for your Telegram bot.
- It’s generated by @BotFather, the official Telegram bot manager.
- It looks something like:
1234567890:AA...something...XYZ
You must keep it secret, exactly like the OpenAI API key.
2. Step 1 – Open BotFather in Telegram #
- Open the Telegram app (desktop or mobile).
- In the search bar, type
@BotFather. - Open the verified BotFather chat (blue checkmark).
image IMAGE PLACEHOLDER: Screenshot of Telegram search results showing @BotFather and its verified badge. IMAGE image
- Click Start (or send
/start).
3. Step 2 – Create a New Bot #
With BotFather open:
- Send command:
/newbot. - BotFather will ask for:
- A bot name (displayed to users), e.g.
Davix Support Bot. - A bot username, which must end with
bot, e.g.davix_support_bot.
- A bot name (displayed to users), e.g.
- After you provide both correctly, BotFather will reply with:
- A confirmation.
- An HTTP API token (your bot token).
- A link to your bot, e.g.
t.me/davix_support_bot.
image IMAGE PLACEHOLDER: Screenshot of a BotFather conversation showing
/newbot, asking for name and username, then returning the bot token and bot link. IMAGE image
Important:
- Copy the bot token and store it in a safe place.
- Anyone with this token can send messages as your bot.
4. Step 3 – Basic Bot Settings (Optional but Recommended) #
Still inside BotFather you can:
- Use
/setdescription,/setabouttext,/setuserpicto give your bot:- A description.
- About text.
- Profile picture (e.g. your Davix logo). Telegram+1
These don’t affect Davix integration, but look more professional.
5. Step 4 – Insert the Bot Token into Davix AI Engine (Chatbot) #
Your plugin uses the Telegram bot token mainly for:
- Human handoff / live chat integration (chatbot ↔ Telegram).
- Telegram notifications in Forms / Auto-Reply modules.
For Chatbot/Telegram integration:
- Go to WordPress admin → Davix AI Engine → Chatbot.
- Open the Telegram or Human Handoff tab (use your actual tab name).
- Find the field “Telegram Bot Token”.
- Paste the token you got from BotFather.
- Save changes.
image IMAGE PLACEHOLDER: Screenshot of Davix AI Engine → Chatbot → Telegram tab showing the “Telegram Bot Token” field and a note like “Generated via BotFather in Telegram”. IMAGE image
6. Step 5 – Configure Telegram Chat IDs / Channels (if your plugin uses them) #
Your docs mention sending messages to:
- A specific user chat ID (for human handoff).
- Or a group/channel where your team can reply.
Typical flow (matching your plugin):
- Create a private group in Telegram for your team (optional).
- Add your bot to that group.
- Send at least one message in the group.
- Use a small helper (from your plugin or a simple script) or a Telegram bot debug tool to discover the chat ID of that group. Telegram+1
- Paste that chat ID in the appropriate field in Davix:
- “Telegram Chat ID for handoff”.
- “Telegram Chat ID for Forms alerts”.
- “Telegram Chat ID for Comment/Review alerts” (depending on module).
image IMAGE PLACEHOLDER: Screenshot of Davix → Forms → Telegram settings showing fields: “Telegram Bot Token”, “Telegram Chat ID”, with descriptions. IMAGE image
(Use your exact field names from your plugin’s docs.)
7. Step 6 – Test the Telegram Integration #
For Chatbot human handoff:
- Enable human mode in Davix → Chatbot → Telegram / Human settings.
- Open your site, send a message to the chat bubble.
- Trigger a condition that sends the chat to human (e.g. user clicks “Talk to human”).
- Check Telegram:
- You should receive a message in your configured chat/group.
- Reply in Telegram and verify the answer appears in the website chat.
For Forms notifications:
- Enable Telegram alerts in Davix → Forms → Telegram.
- Submit a test form.
- Check your Telegram chat/group:
- You should see a message with form details.
If nothing arrives:
- Re-check bot token and chat ID.
- Enable Debug Logs for the relevant module and attempt again to see any errors.

