Cách tạo bot Telegram từ A đến Z: BotFather, token và tin nhắn đầu tiên

Cập nhật: 29 tháng 10, 2026 · 7 phút đọc

Muốn tạo bot Telegram, bạn chỉ cần mở @BotFather, gửi lệnh /newbot, đặt tên và username kết thúc bằng bot. Khoảng hai phút sau bạn đã có token để gọi Bot API. Bài này hướng dẫn từng bước: tạo bot, kiểm tra token bằng getMe, lấy chat id và gửi tin nhắn đầu tiên bằng curl và Python.

Bot Telegram là gì và cần chuẩn bị gì?

Bot Telegram là tài khoản đặc biệt do chương trình của bạn điều khiển và không cần số điện thoại. Người dùng nhắn tin, gõ lệnh hoặc bấm nút; server của bạn nhận các update và trả lời qua Bot API — một giao diện HTTPS đơn giản. Bot không thể chủ động nhắn trước: người dùng phải bấm Start hoặc thêm bot vào nhóm.

Bạn cần chuẩn bị:

• Tài khoản Telegram trên điện thoại hoặc Telegram Desktop.
• Terminal có curl, hoặc Python 3 kèm thư viện requests (pip install requests).
• Hoặc chỉ cần trình duyệt: Bot API Tester gọi được mọi method mà không phải cài gì.

Bước 1: Tạo bot Telegram với @BotFather

1. Mở @BotFather — bot chính thức của Telegram, có dấu tích xanh. Cẩn thận với các tài khoản giả mạo có tên na ná.
2. Bấm Start, sau đó gửi lệnh /newbot.
3. Nhập tên hiển thị, ví dụ Shop Thông Báo. Tên này viết được tiếng Việt có dấu và đổi lại sau bằng /setname.
4. Nhập username: 5–32 ký tự, chỉ gồm chữ Latin, chữ số, dấu gạch dưới và phải kết thúc bằng bot, ví dụ shop_thongbao_bot hoặc ShopThongBaoBot. Nếu username đã có người dùng, BotFather sẽ yêu cầu chọn tên khác.
5. BotFather gửi tin nhắn chúc mừng kèm link t.me/shop_thongbao_bot và token của bot.

Hãy chọn username thật kỹ: khác với tên hiển thị, username không đổi được sau khi tạo.

Bước 2: Sao chép và giữ bí mật token

Token có dạng 123456789:AAEexampleTokenReplaceWithYours: phần số trước dấu hai chấm là ID của bot, phần sau là khóa bí mật. Ai có token đều toàn quyền điều khiển bot, vì vậy:

• Lưu token trong biến môi trường hoặc file .env (đã thêm vào .gitignore), không viết thẳng vào code.
• Không đưa token vào code frontend, ảnh chụp màn hình hay repo công khai.
• Lỡ làm lộ thì thu hồi ngay bằng lệnh /revoke trong BotFather.

Cách tìm lại, kiểm tra và thu hồi token được trình bày chi tiết trong bài cách lấy token bot Telegram.

Bước 3: Kiểm tra token bằng getMe

Method getMe không cần tham số và trả về thông tin của bot — cách nhanh nhất để biết token có dùng được không:

export TOKEN="123456789:AAEexampleTokenReplaceWithYours"
curl "https://api.telegram.org/bot$TOKEN/getMe"

Token đúng sẽ cho kết quả tương tự:

{
  "ok": true,
  "result": {
    "id": 123456789,
    "is_bot": true,
    "first_name": "Shop Thông Báo",
    "username": "shop_thongbao_bot",
    "can_join_groups": true,
    "can_read_all_group_messages": false
  }
}

Nhận về 401 Unauthorized nghĩa là token sai, thiếu ký tự hoặc đã bị thu hồi. Chữ bot phải đứng ngay trước token trong URL; thiếu nó, server trả về 404 Not Found. Ngại dùng terminal? Mở getMe trong Bot API Tester, dán token rồi bấm chạy.

Bước 4: Nhắn /start cho bot và lấy chat id

Để bot gửi được tin cho bạn, cần biết chat_id. Mở link t.me/shop_thongbao_bot, bấm Start (Telegram sẽ gửi lệnh /start tới bot), sau đó gọi getUpdates:

curl "https://api.telegram.org/bot$TOKEN/getUpdates"

Trong phản hồi (đã rút gọn), giá trị cần lấy là message.chat.id:

{
  "ok": true,
  "result": [{
    "update_id": 815000001,
    "message": {
      "message_id": 1,
      "from": {"id": 123456789, "is_bot": false, "first_name": "Minh"},
      "chat": {"id": 123456789, "first_name": "Minh", "type": "private"},
      "date": 1793260800,
      "text": "/start"
    }
  }]
}

Với chat riêng, chat.id là số dương và trùng với ID của bạn. Nếu result rỗng, hãy nhắn thêm một tin cho bot rồi gọi lại. Chat id của nhóm, kênh và topic lấy hơi khác — xem bài chat id Telegram lấy ở đâu.

Bước 5: Gửi tin nhắn đầu tiên bằng sendMessage

Có chat_id rồi, thử gửi tin bằng curl:

curl -X POST "https://api.telegram.org/bot$TOKEN/sendMessage" \
  -H "Content-Type: application/json" \
  -d '{"chat_id": 123456789, "text": "Xin chào! Bot đã hoạt động."}'

Hoặc bằng Python với thư viện requests:

import os
import requests

API = f"https://api.telegram.org/bot{os.environ['TOKEN']}"

resp = requests.post(f"{API}/sendMessage", json={
    "chat_id": 123456789,
    "text": "Xin chào! Đây là tin nhắn đầu tiên từ bot.",
}, timeout=10)
print(resp.json())

Thấy "ok": true là tin nhắn đã tới. Lỗi 400 Bad Request: chat not found thường do sai chat_id hoặc bạn chưa bấm Start. Định dạng chữ đậm, nút bấm inline và cách gửi vào nhóm, kênh có trong bài API gửi tin nhắn Telegram; muốn thử nhanh thì dùng sendMessage trong Bot API Tester.

Tùy chọn: mô tả, ảnh đại diện và danh sách lệnh

• /setdescription — đoạn giới thiệu (tối đa 512 ký tự) hiện ra khi người dùng mở chat trống với bot.
• /setabouttext — mô tả ngắn (tối đa 120 ký tự) trên trang hồ sơ của bot.
• /setuserpic — ảnh đại diện của bot.
• /setcommands — danh sách lệnh gợi ý khi người dùng gõ /. Gửi cho BotFather mỗi lệnh một dòng theo dạng lệnh - mô tả.

Cũng có thể đặt lệnh từ code bằng setMyCommands. Tên lệnh dài 1–32 ký tự, chỉ gồm chữ thường Latin, chữ số và dấu gạch dưới:

curl -X POST "https://api.telegram.org/bot$TOKEN/setMyCommands" \
  -H "Content-Type: application/json" \
  -d '{"commands": [{"command": "start", "description": "Bắt đầu"}, {"command": "help", "description": "Hướng dẫn sử dụng"}]}'

Bước tiếp theo: polling hay webhook, chọn thư viện nào?

Để bot tự trả lời, chương trình phải liên tục nhận update theo một trong hai cách:

• Long polling — gọi getUpdates với tham số timeout. Chạy được ngay trên máy cá nhân, không cần domain hay HTTPS, rất hợp để học.
• Webhook — gọi setWebhook một lần, sau đó Telegram tự gửi update tới URL HTTPS của bạn. Hợp khi deploy lên server.

Ví dụ bot "nhại lời" tối giản bằng long polling:

import os
import requests

API = f"https://api.telegram.org/bot{os.environ['TOKEN']}"
offset = 0

while True:
    r = requests.get(f"{API}/getUpdates",
                     params={"offset": offset, "timeout": 30}, timeout=40)
    for upd in r.json()["result"]:
        offset = upd["update_id"] + 1
        msg = upd.get("message")
        if msg and "text" in msg:
            requests.post(f"{API}/sendMessage", json={
                "chat_id": msg["chat"]["id"],
                "text": "Bạn vừa gửi: " + msg["text"],
            }, timeout=10)

Khi bot phức tạp hơn, hãy dùng thư viện: Python có python-telegram-bot, aiogram, pyTelegramBotAPI; Node.js có grammY, Telegraf; Go có telebot và go-telegram-bot-api. Cần giao diện web ngay trong Telegram thì tìm hiểu Mini Apps và thử JS API bằng Mini App Tester. Các bài về webhook và những chủ đề khác nằm trong mục hướng dẫn.