Trợ giúp

Bắt đầu

Từ đăng ký đến khách hàng trả lời đầu tiên — sáu bước. Khi đăng ký lần đầu, bạn sẽ được dùng thử một tháng với toàn quyền truy cập.

Kết nối kênh

Hướng dẫn từng bước cho từng kênh. Các kênh được kết nối trên mỗi trang web (tiện ích) trong trang tổng quan, trong phần “Kênh”; sau khi một kênh được lưu, Smartbtn sẽ kiểm tra xem nền tảng có chấp nhận tin nhắn hay không. Tin nhắn từ mọi kênh sẽ đến trong “Cuộc trò chuyện”.

bot điện tínBạn sẽ cần: một bot từ @BotFather, tên người dùng và mã thông báo của nó.6 bước → cộng đồng VKBạn sẽ cần: khóa truy cập cộng đồng và liên kết hoặc ID cộng đồng.5 bước → MAX botBạn sẽ cần: một tổ chức đã được xác minh trên business.max.ru, biệt hiệu và mã thông báo bot.6 bước → WhatsApp Business (API đám mây)Bạn sẽ cần: ứng dụng Meta Business có WhatsApp, một số, ID số điện thoại, ID WABA và mã thông báo vĩnh viễn.6 bước · khoảng 10 phút → tài khoản AvitoBạn sẽ cần: một tài khoản Avito với gói đăng ký phù hợp; ủy quyền thông qua Avito.4 bước → CIANBạn sẽ cần: gói CIAN “Cơ bản”, khóa API CIAN và địa chỉ tài khoản.5 bước → Facebook MessengerBạn sẽ cần: mã thông báo truy cập Trang tồn tại lâu dài và địa chỉ Trang.5 bước → Viber botBạn sẽ cần: một bot Viber thương mại, URI và mã thông báo (khóa ứng dụng) của nó.5 bước → được rồi nhómBạn sẽ cần: một khóa truy cập và liên kết hộp thoại nhóm.6 bước → AliExpressBạn sẽ cần: mã thông báo API từ tài khoản người bán AliExpress và địa chỉ hoặc ID cửa hàng.5 bước → Tin nhắn của Apple dành cho doanh nghiệpBạn sẽ cần: một tài khoản Messages for Business được liên kết với Infobip, ID Apple Business và khóa API Infobip.7 bước → WordPress và CMS khácCài đặt mã tiện ích trên trang web được xây dựng bằng CMS.3 bước →

bot điện tín

Khách hàng viết thư cho bot của bạn trong Telegram, bạn trả lời từ Smartbtn — câu trả lời sẽ đến Telegram.

1. Tạo bot với @BotFatherTrong Telegram, mở @BotFather, gửi lệnh /newbot và đặt tên cũng như tên người dùng của bot. Tên người dùng phải kết thúc bằng “bot”.
2. Sao chép mã thông báoBotFather gửi mã thông báo như 123456:AAH… — sao chép hoàn toàn.
3. Nhập tên người dùng botTrong bảng điều khiển, mở “Kênh”, chọn Telegram và nhập tên người dùng bot không có @.
4. Dán mã thông báoDán mã thông báo vào trường “Mã thông báo Bot”.
5. Kết nối TelegramNhấp vào “Kết nối Telegram”. Smartbtn hỏi Telegram xem bot có phản hồi hay không – dấu màu xanh lá cây chỉ xuất hiện sau câu trả lời của nó.
6. Gửi/bắt đầu tới botMở bot trong Telegram và gửi nó /start. Sau đó nó có thể nói chuyện với khách hàng.

cộng đồng VK

Tin nhắn tới cộng đồng VK của bạn sẽ đến Smartbtn; các câu trả lời sẽ thay mặt cộng đồng quay lại VK. Bạn có thể kết nối một số cộng đồng.

1. Tạo khóa truy cập cộng đồngTrong cộng đồng, hãy mở “Quản lý” → “Nâng cao” → “Sử dụng API” → tab “Mã thông báo truy cập” → “Tạo mã thông báo”. Đánh dấu vào quyền “Tin nhắn cộng đồng”, “Quản lý cộng đồng”, “Ảnh”, “Tài liệu” và nhấp vào “Tạo”; xác nhận trong ứng dụng VK hoặc bằng SMS.
2. Dán chìa khóaTrong bảng điều khiển, mở “Kênh” → VK và dán khóa vào trường “Mã thông báo cộng đồng”.
3. Chỉ định cộng đồngTrong trường “Liên kết cộng đồng hoặc ID”, dán địa chỉ cộng đồng (ví dụ: vk.com/club123456) hoặc ID số của cộng đồng đó.
4. Kết nối cộng đồngNhấp vào “Kết nối”. Việc nhận tin nhắn (API gọi lại, sự kiện message_new) được định cấu hình tự động — không cần phải làm gì khác.
5. Kiểm traGửi tin nhắn thử nghiệm tới cộng đồng - tin nhắn đó sẽ xuất hiện trong “Cuộc trò chuyện”.

MAX bot

Tin nhắn tới bot của bạn trong MAX Messenger sẽ đến Smartbtn, các tin nhắn trả lời sẽ quay lại MAX.

1. Tạo bot trên nền tảng đối tác MAXĐăng nhập vào business.max.ru (hoặc ứng dụng nhỏ “MAX for business”), tạo và xác minh hồ sơ tổ chức, chủ sở hữu duy nhất hoặc cá nhân tự kinh doanh của bạn (có sẵn cho cư dân Nga), sau đó trong “Chat trò chuyện” nhấp vào “Tạo”.
2. Điền vào thẻ botTải lên logo, đặt tên và mô tả. Biệt hiệu được tạo tự động (như idINN_bot). Sau khi tạo, bot sẽ được kiểm duyệt.
3. Sao chép mã thông báoSau khi kiểm duyệt, hãy mở “Chat bot” → bot của bạn → ⋮ → “Cài đặt” và sao chép mã thông báo.
4. Nhập biệt hiệu botTrong bảng điều khiển, mở “Kênh” → MAX và nhập biệt hiệu không có @.
5. Dán mã thông báoDán mã thông báo vào trường “Mã thông báo Bot”.
6. LưuNhấp vào “Lưu cài đặt”.

WhatsApp Business (API đám mây)

WhatsApp được kết nối thông qua API đám mây kinh doanh Meta WhatsApp chính thức: một số câu trả lời trong các cuộc hội thoại và gửi thư với các mẫu đã được phê duyệt. Quá trình thiết lập trong phần “Kết nối” mất khoảng 10 phút.

1. Tạo một ứng dụng MetaTrong Meta dành cho nhà phát triển, hãy tạo ứng dụng Doanh nghiệp (hoặc sử dụng ứng dụng hiện có) và thêm sản phẩm WhatsApp.
2. Thêm sốWhatsApp → Thiết lập API: thêm số của bạn (không được sử dụng số này trong ứng dụng WhatsApp), xác nhận số đó bằng mã và chờ phê duyệt tên hiển thị.
3. Sao chép IDSao chép ID số điện thoại và ID tài khoản WhatsApp Business.
4. Tạo mã thông báo vĩnh viễnMeta Business → Cài đặt → Người dùng hệ thống: tạo quản trị viên, cấp ứng dụng và tài khoản WhatsApp, tạo mã thông báo không bao giờ hết hạn với các quyền whatsapp_business_messaging và whatsapp_business_management.
5. Lưu và kiểm traTrong bảng điều khiển, mở “Kết nối” → WhatsApp, dán dữ liệu và nhấp vào “Lưu và kiểm tra”.
6. Bật tin nhắn đếnNhấp vào “Kết nối tự động” và chọn các trang web (dự án) để trả lời và gửi thư.

tài khoản Avito

Các cuộc trò chuyện trên Avito được kết nối bằng các tài khoản: mỗi tài khoản là một ủy quyền riêng biệt trong Avito, bạn có thể thêm một số tài khoản. Yêu cầu đăng ký Avito: “Tối đa” cho Hàng hóa và Công việc, “Mở rộng” hoặc “Tối đa” cho Dịch vụ.

1. Đặt tên cho tài khoảnTrong “Kênh” → Avito nhập tên tài khoản (tối đa 50 ký tự) — điều này giúp phân biệt các tài khoản.
2. Thêm tài khoảnNhấp vào “Thêm tài khoản” - trang ủy quyền Avito sẽ mở ra.
3. Cho phép truy cậpĐăng nhập vào đúng tài khoản Avito, kiểm tra quyền đọc và sửa đổi tin nhắn trong Avito Messenger và nhấp vào “Ủy quyền ứng dụng”.
4. Quản lý tài khoảnThêm nhiều tài khoản hơn hoặc xóa những tài khoản không cần thiết — danh sách nằm trên cùng một trang.

CIAN

Tin nhắn từ tài khoản CIAN của bạn sẽ đến Smartbtn.

1. Nhận khóa API CIANKế hoạch "Cơ bản" là bắt buộc. Trong tài khoản CIAN, hãy mở phần API và nhấp vào “Nhận khóa API”.
2. Tìm chìa khóa trong email của bạnCIAN gửi KEY TRUY CẬP tới email của tài khoản. Ngoài ra, hãy đảm bảo tính năng nhận tin nhắn được bật trong my.cian.ru/settings/chats.
3. Nhập địa chỉ tài khoảnTrong “Kênh” → CIAN dán địa chỉ tài khoản CIAN của bạn.
4. Dán chìa khóaDán khóa vào trường “Khóa API CIAN (KEY ACCESS)”.
5. LưuNhấp vào “Lưu cài đặt”.

Facebook Messenger

Tin nhắn được gửi tới Trang Facebook của bạn trong Messenger sẽ đến Smartbtn. Messenger cho phép trả lời dưới dạng tự do trong vòng 24 giờ sau tin nhắn của khách hàng.

1. Chọn MessengerTrong “Kênh”, hãy nhấp vào biểu tượng Messenger.
2. Nhận mã thông báo TrangNhận mã thông báo truy cập Trang tồn tại lâu dài theo Hướng dẫn Meta dành cho nhà phát triển.
3. Nhập địa chỉ TrangDán địa chỉ Trang Facebook vào trường “Địa chỉ Trang Facebook”.
4. Dán mã thông báoDán mã thông báo Trang vào trường “Khóa bí mật”.
5. LưuNhấp vào “Lưu cài đặt”.

Viber bot

Tin nhắn tới bot Viber của bạn sẽ đến Smartbtn.

1. Chọn ViberTrong “Kênh”, hãy nhấp vào biểu tượng Viber.
2. Nhận bot ViberKể từ ngày 5 tháng 2 năm 2024, bot Viber chỉ được tạo theo các điều khoản thương mại: áp dụng trực tiếp cho Viber hoặc thông qua đối tác chính thức của Viber (developers.viber.com). Mã thông báo có trong Viber: Thêm → Cài đặt → Bot → Chỉnh sửa thông tin → “Khóa ứng dụng của bạn”.
3. Nhập URI botDán URI bot (giống như trong liên kết viber://pa?chatURI=…) vào trường “Bot URI”.
4. Dán mã thông báoDán khóa ứng dụng vào trường “Mã thông báo Bot”.
5. LưuNhấp vào “Lưu cài đặt”.

được rồi nhóm

Tin nhắn tới nhóm OK của bạn sẽ đến Smartbtn.

1. Nhận chìa khóa truy cậpNhận khóa truy cập nhóm như được mô tả trong Hướng dẫn OK API.
2. Chọn đồng ýTrong “Kênh”, hãy nhấp vào biểu tượng OK.
3. Nhập địa chỉ nhómTrong cài đặt nhóm, sao chép từ “Liên kết trực tiếp đến hộp thoại nhóm”, phần như group/58269558636565/messages và dán vào trường “Địa chỉ nhóm”.
4. Dán chìa khóaDán khóa từ bước 1 vào trường “Khóa truy cập (mã thông báo)”.
5. LưuNhấp vào “Lưu cài đặt”. Webhook được đăng ký tự động.
6. Kiểm traSmartbtn hiển thị liệu OK đã xác nhận nhận tin nhắn hay chưa. Gửi tin nhắn kiểm tra cho nhóm - nó sẽ xuất hiện trong “Cuộc trò chuyện”.

AliExpress

Tin nhắn của người mua từ AliExpress đến Smartbtn.

1. Mở trang mã thông báo APIĐăng nhập vào tài khoản người bán (seller.aliexpress.ru) và mở sell.aliexpress.ru/token‑management/active.
2. Tạo mã thông báoNhấp vào “Tạo mã thông báo”, sau đó nhấp vào mã thông báo và sao chép nó.
3. Chỉ định cửa hàngTrong “Kênh” → AliExpress nhập địa chỉ hoặc ID cửa hàng của bạn.
4. Dán mã thông báoDán mã thông báo vào trường “Mã thông báo API”.
5. LưuNhấp vào “Lưu cài đặt”.

Apple Messages for Business

Tin nhắn từ Apple Messages for Business (trước đây là Business Chat) đến Smartbtn thông qua nhà cung cấp Infobip: Apple không cấp cho doanh nghiệp quyền truy cập trực tiếp.

1. Đăng ký với AppleTrong Apple Business Register (register.apple.com), hãy đăng ký tổ chức và tạo tài khoản Tin nhắn cho doanh nghiệp; chọn Infobip làm Nhà cung cấp dịch vụ nhắn tin.
2. Liên kết tài khoản với InfobipLiên kết tài khoản với tài khoản Infobip của bạn và chờ sự chấp thuận của Apple - trạng thái sẽ TRỰC TUYẾN.
3. Nhập URL cơ sở InfobipTrong “Kênh” → Tin nhắn dành cho doanh nghiệp, dán URL cơ sở Infobip của bạn (như xxxxx.api.infobip.com).
4. Nhập ID doanh nghiệp AppleSao chép nó trong Apple Business Register: tài khoản Tin nhắn dành cho doanh nghiệp → “Liên kết” → “Sao chép ID”.
5. Dán khóa API InfobipTạo khóa API trong Infobip (quản lý khóa API) và dán nó — URL gọi lại xuất hiện bên dưới.
6. Đặt URL gọi lại trong InfobipTrong Infobip: Kênh và số → Kênh → Apple Messages for Business → Người gửi → ⋮ → Chỉnh sửa cấu hình gửi đến → Chuyển tiếp tới HTTP, dán URL gọi lại.
7. LưuNhấp vào “Lưu cài đặt”.

WordPress, Tilda và CMS khác

Tiện ích này được cài đặt bằng một mã cài đặt — tiện ích này hoạt động trên mọi trang web và CMS.

1. Sao chép mã cài đặtTrong bảng điều khiển, mở “Widget” và sao chép mã cài đặt.
2. Dán nó vào trang webThêm mã vào mỗi trang trước thẻ đóng : trong WordPress — thông qua chủ đề (footer.php) hoặc bất kỳ plugin nào để chèn mã vào đầu trang/chân trang; trong CMS khác — trong trường dành cho mã HTML/JS tùy chỉnh.
3. Kiểm traMở trang web - nút xuất hiện; những thay đổi thiết kế tiếp theo được thực hiện trong bảng điều khiển mà không cần cài đặt lại mã.

Cơ sở tri thức

Sẽ giúp đỡ, gợi ý, giảng dạy. Bắt đầu nhập — danh sách sẽ lọc khi bạn nhập.

smartbtn_widget_api.setContactInfo({
  name: "Alex Morgan",
  email: "email@example.com",
  phone: "+17584987855",
  description: "Description text"
});

smartbtn_widget_api.setCustomData([
  {
    title: "Actions",
    content: "Add contact",
    link: "https://crm.example.com/contacts/new"
  },
  {
    content: "Open customer profile",
    link: "https://crm.example.com/customers/42"
  }
]);

curl -H "Authorization: Bearer <token>" https://<host>/api/v1/chats

// → { "data": [...], "next_cursor": "..." | null }

• Cửa sổ PWA độc lập không có thanh địa chỉ trình duyệt, có huy hiệu Dock và thông báo Web Push
• Truy cập tức thì vào tất cả các công cụ: WhatsApp, Telegram, Instagram, Messenger, AI co‑pilot, chatbot, gọi lại, Chỉ đường, Giá cả
• Thông báo đẩy cho tin nhắn mới và yêu cầu gọi lại
• Giám sát người vận hành, tính giờ và thống kê SLA — ngay trong ứng dụng

Liên hệ với chúng tôi

Có một câu hỏi hoặc một gợi ý? Hãy viết thư cho chúng tôi!

Chi tiết công ty

Chi tiết nhà điều hành cho các hợp đồng và hóa đơn.

Văn bản pháp luật

Điều khoản sử dụng dịch vụ và xử lý dữ liệu cá nhân.