Danh sách kiểm tra trước khi nhận mã đăng nhập Telegram trên số thử nghiệm

Cần chuẩn bị gì trước khi đặt số Telegram?

Hãy rà soát danh sách này trước; phần lớn các bài kiểm thử Telegram thất bại đều bắt nguồn từ một trong những mục sau.

• Mục đích rõ ràng. Bạn đang kiểm thử một bot, một Mini App, một widget đăng nhập hoặc một quy trình hỗ trợ do chính nhóm của bạn vận hành, và bạn cần một tài khoản Telegram mới không gắn với điện thoại cá nhân của bất kỳ nhân viên nào.
• Một quốc gia mục tiêu. Hãy quyết định tài khoản nên có vẻ thuộc về thị trường nào. Ngôn ngữ mặc định và một số màn hình onboarding đi theo quốc gia của số điện thoại.
• Tiền trong ví hoặc sandbox. Một ví trả trước đã nạp tiền, hoặc một tài khoản phát triển được bộ phận hỗ trợ chuyển sang sandbox để chạy thử.
• Khóa API, nếu tự động hóa. Tạo một khóa có tiền tố or_live_ trong Developer console.
• Một thiết bị hoặc trình giả lập sạch. Telegram gửi mã ngay trong ứng dụng tới bất kỳ phiên nào đã đăng nhập, nên một thiết bị chưa có phiên nào giúp đường đi qua SMS dễ dự đoán.
• Thời gian. Mỗi activation mở trong 20 phút; đừng bắt đầu cho đến khi tester sẵn sàng nhập số.

Khi nào Telegram thực sự gửi mã qua SMS?

Telegram nhận diện mọi tài khoản bằng số điện thoại. Nó yêu cầu mã khi có người đăng ký tài khoản mới và khi một tài khoản hiện có đăng nhập trên thiết bị mới. Nếu tài khoản đó đang hoạt động ở nơi khác, Telegram thường gửi mã đăng nhập dưới dạng tin nhắn trong phiên hiện có thay vì qua SMS; vì vậy một số hoàn toàn mới trên thiết bị mới là cách sạch nhất để kiểm thử bước SMS. Telegram cũng có thể đề nghị một cuộc gọi hoặc gửi lại sau một khoảng chờ ngắn.

Xác minh hai bước trên Telegram là một mật khẩu đám mây riêng được đặt trong ứng dụng. Nó không phải yếu tố SMS, vì vậy hãy lưu mật khẩu đó trong trình quản lý secret của nhóm nếu bạn bật nó trên một tài khoản thử nghiệm.

Tôi có thể chọn những quốc gia nào cho Telegram, và vì sao điều đó quan trọng?

Dịch vụ telegram hiện được liệt kê ở 199 quốc gia, trong đó có Ấn Độ, Đức, Brazil, Nigeria, Indonesia, Vương quốc Anh, Ukraine, Kazakhstan, Uzbekistan, Thổ Nhĩ Kỳ, Tây Ban Nha, Mexico, Philippines, Việt Nam và Ai Cập.

Hãy khớp quốc gia với trường hợp kiểm thử. Một bot trả lời bằng tiếng Bồ Đào Nha nên được thử từ tài khoản Brazil; một nhóm hỗ trợ phụ trách Trung Á có thể muốn một số Kazakhstan. Telegram cũng có thể đối xử thận trọng hơn với số của một số quốc gia so với số khác, nên nếu một tuyến cứ thất bại, một thị trường lân cận là phương án dự phòng hợp lý. Tình trạng khả dụng thay đổi suốt trong ngày, vì vậy hãy đọc nó từ API thay vì từ một danh sách đã lưu.

Làm sao tự động hóa việc lấy mã Telegram bằng API?

1. Tùy chọn, xác nhận chi phí bằng GET /api/v1/prices?country=<id>&service=telegram.
2. Tạo đơn: POST /api/v1/activations với {"service": "telegram", "country": "<id>"}, trong đó mã quốc gia lấy từ GET /api/v1/countries (ví dụ br hoặc de).
3. Chuyển số được trả về cho trình chạy kiểm thử của bạn, nơi nhập nó vào ứng dụng Telegram hoặc trình giả lập.
4. Chờ mã. Với webhook, hãy lắng nghe activation.sms_received; nếu không, hãy thăm dò GET /api/v1/activations/{id} với khoảng cách hợp lý.
5. Dọn dẹp bằng POST /api/v1/activations/{id}/cancel nếu lượt chạy bị hủy giữa chừng.

Với webhook, hãy xác minh X-OTPRoute-Signature bằng cách tính lại HMAC-SHA256 trên <t>.<raw body> với secret của endpoint, từ chối các dấu thời gian cũ, và ghi lại mỗi activation id bạn đã xử lý để sự kiện được gửi lại sẽ bị bỏ qua. Mỗi tài khoản có tối đa 5 endpoint webhook và 300 yêu cầu mỗi phút. Hướng dẫn pipeline CI đề cập đến việc chạy song song.

Tôi có thể làm các bước tương tự thủ công trong dashboard không?

Có. Đăng nhập, mở OTP Gateway, chọn Telegram và quốc gia, kiểm tra giá rồi đặt số. Sao chép số vào màn hình nhập điện thoại của Telegram, chọn mã quốc gia tương ứng và yêu cầu mã. Khi SMS đến, nó hiển thị bên cạnh đơn hàng, sẵn sàng để dán.

Mã Telegram không đến. Danh sách xử lý sự cố gồm những gì?

• Có phiên nào đang tồn tại không? Nếu số từng được dùng trước đó, Telegram có thể đã gửi mã trong ứng dụng. Một activation mới sẽ tránh được điều này.
• Khung thời gian đã kết thúc chưa? Hãy để bộ đếm 20 phút chạy hết. Bạn chỉ trả tiền nếu mã đến; hết hạn hoặc hủy sẽ tự động hoàn toàn bộ số tiền.
• Tuyến có được chấp nhận không? Telegram có thể từ chối một số số ảo. Điều đó nằm ngoài tầm kiểm soát của chúng tôi và chính là lý do quy tắc hoàn tiền tồn tại.
• Thử lại có giãn cách. Đặt lại sau hoặc ở quốc gia khác; đừng đặt lại liên tục trong một vòng lặp dày, vì điều đó không giúp ích cho việc gửi mã lẫn giới hạn tốc độ của bạn.
• Kiểm tra mã quốc gia trên thiết bị. Việc quốc gia được chọn không khớp với số điện thoại là lỗi dễ mắc khi kiểm thử thủ công.

Khi nào Dedicated Number phù hợp hơn cho Telegram?

Một số OTP Gateway dùng một lần phù hợp với các bài kiểm thử đăng ký. Nếu tài khoản Telegram phải đăng nhập lại vào tháng sau, ví dụ một tài khoản nhóm vận hành kênh hỗ trợ hoặc đăng nhập quản trị của một bot, nó cần một số điện thoại mà nhóm bạn vẫn còn kiểm soát. Các Dedicated Number tại Hoa Kỳ và Canada, từ $1.95/month, vẫn thuộc về bạn trong khi được gia hạn và chuyển tiếp SMS đến tới dashboard cũng như webhook của bạn dưới dạng number.sms_received. Bài so sánh số tạm thời và số chuyên dụng giải thích sự đánh đổi này.

Kiểm thử Telegram có trách nhiệm trông như thế nào?

Hãy tuân thủ điều khoản dịch vụ của Telegram. Tạo một tài khoản cho mỗi cá nhân thực hoặc mục đích kinh doanh, dùng nó cho các sản phẩm, bot và hoạt động của chính bạn, và tuyệt đối không dùng cho spam, tạo tài khoản hàng loạt hay lách lệnh cấm. Mọi đơn Telegram bạn đặt cũng nằm trong phạm vi Chính sách Sử dụng Chấp nhận được (Acceptable Use Policy) của OTP Route. Telegram là nhãn hiệu của chủ sở hữu nó, và OTP Route không có liên kết nào với họ.

Câu hỏi thường gặp

Tôi có thể nhận mã xác minh Telegram mà không dùng điện thoại cá nhân không?

Có. Hãy đặt một số Telegram từ OTP Gateway của OTP Route, nhập nó vào ứng dụng và đọc mã SMS trong dashboard hoặc qua API.

Mã dịch vụ của Telegram trong API là gì?

Đó là telegram. Kết hợp nó với mã quốc gia từ GET /api/v1/countries khi tạo activation.

Xác minh SMS Telegram để kiểm thử có giá bao nhiêu?

Từ $0.20 mỗi mã; giá chính xác phụ thuộc vào quốc gia và được endpoint giá trả về trực tiếp.

Vì sao Telegram gửi mã trong ứng dụng thay vì qua SMS?

Telegram gửi mã đăng nhập tới phiên hiện có khi có sẵn. Hãy dùng một số mới và thiết bị chưa đăng nhập phiên nào để kiểm thử đường đi qua SMS.

Tôi có thể dùng lại số dùng một lần để đăng nhập lại Telegram sau này không?

Không, số OTP Gateway chỉ dành cho một mã. Với các lần đăng nhập lặp lại, hãy dùng Dedicated Number tại Hoa Kỳ hoặc Canada.

Tôi có bị tính phí nếu Telegram từ chối số không?

Không. Nếu không có mã nào đến số trong 20 phút, hoặc bạn hủy, toàn bộ số tiền được hoàn về ví của bạn.

Tên dịch vụ là nhãn hiệu của chủ sở hữu tương ứng. OTP Route không liên kết với họ. Hãy sử dụng số hợp pháp, tuân thủ điều khoản của từng dịch vụ và Chính sách sử dụng chấp nhận được của chúng tôi.