> ## Documentation Index
> Fetch the complete documentation index at: https://chatbotx.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Kết nối Telegram vào ChatbotX

> Hướng dẫn tạo Telegram và kết nối vào ChatbotX để tự động hóa hội thoại.

**Telegram** là một trong những kênh nhắn tin phổ biến nhất. Khi kết nối Telegram Bot với ChatbotX, bạn có thể nhận tin nhắn trực tiếp vào hộp thư (Inbox) chung, thiết lập các luồng trả lời tự động (Flows) và sử dụng AI Agent để chăm sóc khách hàng 24/7.

Quá trình kết nối Telegram rất đơn giản và không yêu cầu xét duyệt ứng dụng phức tạp như Facebook hay Zalo. Bạn chỉ cần tạo Bot và lấy Bot Token.

## Tạo Telegram Bot

Nếu bạn chưa có Telegram Bot, hãy làm theo các bước sau để tạo bot mới trên ứng dụng Telegram thông qua **BotFather** (công cụ quản lý bot chính thức của Telegram).

<Steps>
  <Step title="Mở BotFather">
    Mở ứng dụng Telegram và tìm kiếm từ khóa **@BotFather**, hoặc truy cập trực tiếp link: [https://t.me/BotFather](https://t.me/BotFather). Nhấn **Start** để bắt đầu trò chuyện.
  </Step>

  <Step title="Tạo bot mới">
    Gửi lệnh `/newbot` cho BotFather. Hệ thống sẽ yêu cầu bạn nhập 2 thông tin:

    * **Name:** Tên hiển thị của bot (ví dụ: Chăm sóc khách hàng ChatbotX).
    * **Username:** Tên người dùng duy nhất của bot, bắt buộc phải kết thúc bằng chữ `bot` (ví dụ: `chatbotx_support_bot`).
  </Step>

  <Step title="Sao chép Bot Token">
    Sau khi tạo thành công, BotFather sẽ gửi cho bạn một thông báo chứa **API Token**. Mã này có dạng tương tự như `123456789:ABCDEF1234ghIkl-zyx57W2v1u123ew11`. Hãy sao chép toàn bộ đoạn mã này để sử dụng ở bước tiếp theo.
  </Step>
</Steps>

<Frame>
  <img src="https://mintcdn.com/chatbotx/49Ui_fPVyLShWBNl/images/image-297.png?fit=max&auto=format&n=49Ui_fPVyLShWBNl&q=85&s=abcad16670837ba704c8b800a32ea5b4" alt="create_bot_by_botfather" width="2136" height="1880" data-path="images/image-297.png" />
</Frame>

<Note>
  **Bảo mật Token:** Bot Token giống như chìa khóa nhà của bạn. Không bao giờ chia sẻ công khai mã này. Nếu nghi ngờ token bị lộ, bạn có thể gửi lệnh `/revoke` cho BotFather để tạo mã mới.
</Note>

## Tích hợp vào ChatbotX

Sau khi đã có Bot Token, bạn chỉ cần dán mã này vào ChatbotX để hoàn tất việc kết nối. Dựa theo giao diện quản lý của ChatbotX, hãy làm theo các bước sau:

<Steps>
  <Step title="Vào mục quản lý kênh">
    Đăng nhập vào ChatbotX, chọn menu **Settings** ở thanh điều hướng bên trái, sau đó mở tab **Channels**.
  </Step>

  <Step title="Mở phần Telegram">
    Bấm vào hàng **Telegram** trong danh sách các kênh. Sau đó nhấn vào nút **Add Telegram** ở góc bên phải.

    <Frame>
      <img src="https://mintcdn.com/chatbotx/49Ui_fPVyLShWBNl/images/image-298.png?fit=max&auto=format&n=49Ui_fPVyLShWBNl&q=85&s=3149e22a9c4cac5f635dc5519fddd5b6" alt="chatbotx_settings_channels_tab" width="3021" height="1330" data-path="images/image-298.png" />
    </Frame>
  </Step>

  <Step title="Nhập Bot Token">
    Hệ thống sẽ hiển thị cửa sổ bật lên "Add Telegram". Dán toàn bộ mã **Bot Token** bạn vừa sao chép từ BotFather vào ô nhập liệu.

    <Frame>
      <img src="https://mintcdn.com/chatbotx/49Ui_fPVyLShWBNl/images/image-299.png?fit=max&auto=format&n=49Ui_fPVyLShWBNl&q=85&s=270541bb5e997680eef89fc9ce7a80e0" alt="chatbotx_add_telegram_bot_token_modal" width="3027" height="1344" data-path="images/image-299.png" />
    </Frame>
  </Step>

  <Step title="Xác nhận kết nối">
    Nhấn nút **Connect** màu xanh. ChatbotX sẽ tự động thiết lập liên kết (webhook) với Telegram để bắt đầu nhận và gửi tin nhắn.
  </Step>
</Steps>

## Kiểm tra hoạt động

Sau khi kết nối thành công, bạn nên kiểm tra thử để đảm bảo hệ thống đang hoạt động ổn định:

* **Cách 1: Nhắn tin trực tiếp**
  * Mở ứng dụng Telegram, tìm username của bot bạn vừa tạo.
  * Gửi một tin nhắn bất kỳ (ví dụ: "Xin chào").
  * Mở màn hình **Inbox** trên ChatbotX. Tin nhắn của bạn sẽ xuất hiện ở đó và bạn có thể phản hồi trực tiếp cho khách hàng.
* **Cách 2: Gắn Flow phản hồi tự động**
  * Tạo một kịch bản đơn giản trong mục **Flows** hoặc thiết lập một AI Agent.
  * Nhắn tin lại cho bot trên Telegram để xem bot có phản hồi tự động đúng như bạn đã cài đặt hay không.