Kết nối nhà cung cấp VoIP

Kết nối nhà cung cấp bạn đang sử dụng (Twilio hoặc Telnyx bằng API key; SignalWire, Vonage, Plivo hoặc bất kỳ SIP trunk nào qua SIP), hoặc mở tài khoản Telnyx mới với thiết lập có hướng dẫn.

Lưu lượng thực tế nên chạy trên các số điện thoại bạn sở hữu thông qua nhà cung cấp VoIP của riêng bạn. Trang Kết nối → VoIP trong dashboard (/dashboard/voip-connections) kết nối tài khoản nhà cung cấp của bạn; sau khi kết nối, bạn có thể nhập các số hỗ trợ cuộc gọi cả chiều đến lẫn chiều đi.

Nhấp vào Kết nối mới và chọn một trong hai cách: Kết nối nhà cung cấp bạn đang dùng hoặc Thiết lập tài khoản Telnyx mới.

Kết nối nhà cung cấp bạn đang dùng#

Chọn nhà cung cấp mà số điện thoại của bạn đang sử dụng:

Với Twilio và Telnyx, dán thông tin xác thực rồi nhấp Kết nối & Kiểm tra. ThunderPhone xác minh chúng và cấu hình phía nhà cung cấp cho bạn. Với Telnyx, ThunderPhone thêm một kết nối SIP riêng vào tài khoản Telnyx của bạn (có tên thunderphone-production-<org>-outbound-<id>) và thực hiện cuộc gọi đi thông qua kết nối đó, vì vậy Telnyx sẽ tính phí các cuộc gọi đó cho bạn. ThunderPhone sử dụng cấu hình thoại gọi đi của kết nối Telnyx mà các số của bạn đang dùng, vì vậy các quốc gia được phép và giới hạn chi tiêu của cấu hình đó sẽ được áp dụng. Nếu kết nối đó không có cấu hình thoại gọi đi và tài khoản của bạn chỉ có đúng một cấu hình được bật, ThunderPhone sẽ sử dụng cấu hình đó. Để sử dụng cấu hình khác, hãy gán cấu hình đó cho kết nối trong cổng Telnyx rồi lưu lại kết nối ThunderPhone. Nếu tài khoản không có cấu hình nào được bật, hoặc có nhiều cấu hình, hãy gán một cấu hình cho kết nối trong cổng Telnyx rồi lưu lại kết nối ThunderPhone. Cho đến khi thực hiện việc này, các cuộc gọi đi sẽ thất bại với outbound_trunk_unavailable; cuộc gọi đến vẫn hoạt động.

Khi Telnyx từ chối một cuộc gọi đi (ví dụ: SIP 403 Forbidden), việc từ chối đó đến từ chính tài khoản Telnyx của bạn. Các nguyên nhân thường gặp là không còn tín dụng khả dụng, số gọi đi không thuộc tài khoản Telnyx đó, hoặc cấu hình thoại gọi đi không cho phép quốc gia đích.

Thiết lập SIP cho SignalWire, Vonage và Plivo#

Ba nhà cung cấp này sẽ mở biểu mẫu SIP thủ công với các bước dành cho nhà cung cấp đó ở đầu trang, liên kết đến hướng dẫn thiết lập riêng của nhà cung cấp và một miền SIP mẫu:

• SignalWire: tạo thông tin xác thực SIP cho cuộc gọi đi, nhập miền SIP, tên người dùng và mật khẩu, rồi gán cho mỗi số một tập lệnh SWML kết nối cuộc gọi đến với điểm cuối SIP của ThunderPhone.
• Vonage: trong bảng điều khiển SIP Trunking, tạo một trunk có thông tin xác thực gọi đi, nhập miền của trunk (ví dụ: your-trunk.sip-us.vonage.com) và thông tin xác thực, thêm điểm cuối SIP của ThunderPhone làm URI SIP đến của trunk, rồi liên kết các số của bạn với trunk.
• Plivo: tạo một trunk gọi đi có thông tin xác thực và nhập Miền SIP kết thúc (<trunk-id>.zt.plivo.com), tên người dùng và mật khẩu; tạo một trunk đến có URI chính là điểm cuối SIP của ThunderPhone theo sau bởi ;transport=tcp; sau đó đặt Loại ứng dụng của mỗi số thành trunk đó.

Kết quả là một kết nối SIP thủ công (provider: "manual" trong API), được kiểm tra và xác minh giống hệt kết nối được nhập thủ công. Thẻ kết nối hiển thị tên nhà cung cấp, ví dụ: SignalWire · SIP.

Thiết lập tài khoản Telnyx mới#

Chưa có nhà cung cấp? Quy trình có hướng dẫn sẽ giúp bạn tạo tài khoản Telnyx và kết nối tài khoản đó:

1. Tạo tài khoản

   Nhấp vào Mở đăng ký Telnyx, tạo tài khoản của bạn và chọn "Tôi đã tạo tài khoản."

2. Lấy khóa API

   Nhấp vào Mở trang khóa API, tạo khóa và dán khóa đó vào Khóa API (v2). Bạn có thể đặt tên cho kết nối.

3. Kết nối & kiểm tra

   Nhấp vào Kết nối & kiểm tra — ThunderPhone xác minh thông tin xác thực và thiết lập những gì cần thiết ở phía Telnyx trước khi lưu.

Những gì ThunderPhone thiết lập trong Telnyx#

Trừ khi bạn nhập Connection ID riêng, cả hai cách kết nối Telnyx (thiết lập có hướng dẫn và dán API key) đều tạo cùng một mục trong tài khoản Telnyx của bạn: một kết nối SIP có tên thunderphone-<your organization id>. Đây là một kết nối FQDN có bản ghi FQDN trỏ đến điểm cuối SIP của ThunderPhone, và mọi số điện thoại bạn nhập đều được gán cho kết nối này. Telnyx gửi cuộc gọi đến các số đó trực tiếp đến ThunderPhone qua SIP.

• Các trường webhook của kết nối này được để trống có chủ đích. Không có webhook, ứng dụng Call Control, ứng dụng TeXML hoặc điện thoại SIP đã đăng ký nào liên quan.
• Không chuyển các số đã nhập sang kết nối hoặc ứng dụng khác, và không đăng ký thiết bị với kết nối này.
• Nếu bạn đã nhập Connection ID riêng khi kết nối, ThunderPhone sẽ dùng kết nối đó và không bao giờ thay đổi kết nối này; đó phải là kết nối FQDN trỏ đến điểm cuối SIP của ThunderPhone.

Trước ngày 30 tháng 8 năm 2026, kết nối thunderphone-… do ThunderPhone tạo là một kết nối Credential, không thể nhận cuộc gọi. Nếu kết nối của bạn vẫn hiển thị là kết nối Credential, hãy liên hệ bộ phận hỗ trợ để chúng tôi chuyển đổi kết nối đó.

Cấu hình SIP thủ công#

Các ô SignalWire, Vonage và Plivo đều mở biểu mẫu này, cũng như Tôi sẽ tự nhập mọi cài đặt trong Nhà cung cấp khác. Mọi trunk SIP đều hoạt động, bao gồm DIDWW hoặc PBX do bạn tự vận hành. Nhập tên kết nối, miền / URI SIP, tên người dùng và mật khẩu (không bắt buộc), cổng và giao thức truyền; Cài đặt nâng cao thêm mã hóa phương tiện (SRTP). Biểu mẫu cũng hiển thị địa chỉ SIP mà trunk của bạn phải gửi cuộc gọi đến đến: sip.thunderphone.com, trên cổng 5060 cho UDP hoặc TCP, hoặc 5061 cho TLS. Qua TLS, tín hiệu SIP vẫn được mã hóa xuyên suốt đến LiveKit Cloud, nơi ThunderPhone xử lý cuộc gọi; âm thanh không bao giờ đi qua sip.thunderphone.com, vì vậy SRTP vẫn hoạt động như trước. Đặt địa chỉ mỗi cuộc gọi đến số được quay ở định dạng E.164, dùng cùng một số, bao gồm +, trong cả dòng yêu cầu và tiêu đề To: ví dụ sip:+14155550142@sip.thunderphone.com. Dấu + cho phép ThunderPhone xử lý cuộc gọi ở đúng khu vực (xem ghi chú trong danh sách cho phép IP). Các trunk được thiết lập trước đó với địa chỉ <your-project>.sip.livekit.cloud vẫn hoạt động khi IP nguồn được phép để trống; bạn không cần thay đổi chúng. ThunderPhone chuyển các cài đặt đó thành một cặp trunk SIP chuyên dụng trên LiveKit Cloud: các cuộc gọi đi từ số của kết nối được thực hiện đến miền SIP của bạn bằng thông tin xác thực của bạn, và các cuộc gọi đến các số đó được chấp nhận từ mọi địa chỉ trừ khi bạn điền trường IP nguồn được phép không bắt buộc. Chỉ điền trường này nếu nhà mạng của bạn công bố IP tín hiệu cố định: danh sách sai hoặc không đầy đủ sẽ khiến ThunderPhone từ chối các cuộc gọi đến từ nhà mạng của bạn. Hai nút thực hiện phần việc chính:

• Tạo hướng dẫn thiết lập AI — viết hướng dẫn dành riêng cho nhà cung cấp về cấu hình phía trunk mà bạn cần.
• Kiểm tra và lưu kết nối — kiểm tra endpoint SIP có phân giải tới địa chỉ công khai hay không và, với TCP/TLS, có chấp nhận kết nối trên cổng đã chọn hay không (máy chủ UDP chỉ được kiểm tra DNS), rồi lưu. Nó chưa thể thực hiện cuộc gọi vì kết nối chưa có số; việc xác minh thực sự diễn ra khi nhập số (bên dưới).

Việc chỉnh sửa kết nối sau này sẽ chạy lại cùng kiểm tra trên các cài đặt đã thay đổi trước khi lưu bất kỳ nội dung nào, sau đó tạo lại trunk và xác minh lại mọi số trong kết nối bằng một cuộc gọi kiểm tra ngắn chạy nền — các số hiển thị là Đang cấp phát cho đến khi cuộc gọi kiểm tra thành công. Chỉ thay đổi IP nguồn được phép trên một kết nối Đã kết nối thì khác: việc này không bao giờ ảnh hưởng đến cuộc gọi đi, vì vậy ThunderPhone cập nhật ngay danh sách trên trunk đến và các số vẫn ở trạng thái Đang hoạt động. Kiểm tra cuộc gọi đến của chúng được đặt lại thành chưa kiểm tra; hãy chạy lại hoặc thực hiện một cuộc gọi thực qua nhà mạng của bạn để xác nhận danh sách mới cho phép cuộc gọi đi vào. Kiểm tra sẽ thất bại nếu cuộc gọi của nó bị từ chối theo danh sách. Mật khẩu đã lưu không bao giờ được hiển thị lại; để trống mật khẩu để giữ nguyên, hoặc chọn "Xóa mật khẩu đã lưu" cho trunk được xác thực bằng IP.

Danh sách cho phép IP và xác thực trunk#

Một số nhà cung cấp (DIDWW, kết nối xác thực IP Telnyx, hầu hết PBX sau tường lửa) chỉ chấp nhận lưu lượng SIP từ các địa chỉ bạn đưa vào danh sách cho phép hoặc xác thực cuộc gọi đi theo IP nguồn. ThunderPhone sử dụng hai nhóm địa chỉ.

Biên SIP. Cuộc gọi đến bạn gửi tới sip.thunderphone.com đi qua biên SIP của ThunderPhone, chỉ mang báo hiệu SIP. INVITE đầu tiên đi tới sip.thunderphone.com; phần báo hiệu còn lại của cuộc gọi (ACK, gác máy, chuyển cuộc gọi) chạy giữa nhà cung cấp của bạn và máy chủ biên đã nhận cuộc gọi, sip-1 hoặc sip-2. Nếu tường lửa của bạn lọc báo hiệu SIP, hãy cho phép cả ba địa chỉ, trên cổng UDP và TCP 5060 cùng cổng TLS 5061:

LiveKit Cloud. Âm thanh (RTP) của mọi cuộc gọi và báo hiệu SIP của cuộc gọi đi chạy giữa nhà cung cấp của bạn và LiveKit Cloud, không bao giờ qua biên SIP. Hãy cho phép mọi dải bên dưới cho cả báo hiệu SIP và phương tiện:

LiveKit áp dụng các dải này cho Realtime, báo hiệu và phương tiện SIP cùng Webhook, và chúng bao phủ các cuộc gọi được xử lý tại các khu vực Canada, EU, Ấn Độ, Nhật Bản và Mỹ. Tên khu vực cho endpoint được ghim: canada, eu, india, japan, us.

Một số quy tắc thực hành cho chính trunk:

• ThunderPhone không đăng ký. ThunderPhone không bao giờ gửi SIP REGISTER tới nhà cung cấp của bạn, vì vậy hãy cấu hình trunk để xác thực dựa trên IP và/hoặc thông tin xác thực (tên người dùng + mật khẩu), không phải đăng ký.
• Cuộc gọi đi nên sử dụng thông tin xác thực. Bật xác thực bằng tên người dùng/mật khẩu ở phía nhà cung cấp và nhập cùng các giá trị đó vào biểu mẫu SIP thủ công. Coi danh sách cho phép IP là lớp thứ hai, không phải lớp duy nhất — cuộc gọi đi tới các đích bên ngoài khu vực được hỗ trợ có thể xuất phát từ các địa chỉ khác.
• Cuộc gọi đến theo chiều ngược lại. Trường tùy chọn IP nguồn được phép trong biểu mẫu là nơi bạn nhập địa chỉ báo hiệu của nhà cung cấp của bạn để ThunderPhone chỉ chấp nhận cuộc gọi từ các địa chỉ đó. Nhập địa chỉ IP hoặc dải CIDR; tên máy chủ không bao giờ khớp. Để trống trường này trừ khi nhà cung cấp của bạn công bố danh sách cố định. ThunderPhone kiểm tra danh sách trên mọi cuộc gọi đến dựa trên địa chỉ mà biên SIP nhận thấy, vì vậy sau khi thiết lập danh sách, hãy gửi cuộc gọi tới sip.thunderphone.com. Một cuộc gọi từ địa chỉ không có trong danh sách, hoặc được gửi thẳng tới địa chỉ <your-project>.sip.livekit.cloud, sẽ bị từ chối: cuộc gọi thất bại hoặc kết nối rồi kết thúc ngay.

Các dải này được LiveKit công bố tại Các khu vực, endpoint theo khu vực và IP tĩnh; ThunderPhone kiểm tra trang đó hằng tuần và cập nhật hướng dẫn này khi có thay đổi.

Sau khi kết nối#

Nhập số từ Số điện thoại → Thêm số → Kết nối nhà cung cấp VoIP (hoặc trực tiếp từ kết nối). Mỗi số được nhập sẽ được xác minh trước khi hoạt động. Với kết nối SIP thủ công, quá trình xác minh sẽ thực hiện một cuộc gọi kiểm tra ngắn (vài giây) từ số của bạn, qua SIP trunk của bạn, đến một số ThunderPhone — nhờ đó tên người dùng, mật khẩu, giao thức truyền tải và định tuyến cuộc gọi đi của nhà cung cấp đều được kiểm tra thực tế. Nhà cung cấp của bạn sẽ tính phí cuộc gọi này như mọi cuộc gọi khác. Nếu nhà cung cấp từ chối, số sẽ ở trạng thái Đang cấp phát và trang số điện thoại sẽ hiển thị phản hồi của nhà cung cấp (ví dụ: "đã từ chối thông tin xác thực của ThunderPhone (SIP 401)"); hãy sửa kết nối và xác minh lại. Nếu nhà cung cấp chấp nhận trunk nhưng gói định tuyến của họ không bao gồm số kiểm tra của ThunderPhone (DIDWW phản hồi "Số đích bị đưa vào danh sách chặn bởi gói định tuyến"), số sẽ hiển thị là Đã xác minh · nhà cung cấp đã chấp nhận: số có thể sử dụng, nhưng các cuộc gọi đến đích khác chưa được kiểm tra. Cuộc gọi đó chứng minh trunk của bạn có thể thực hiện cuộc gọi với tư cách là số đó; đây không phải là bằng chứng bạn sở hữu số đó và cũng không kiểm tra các cuộc gọi đến số đó; bài kiểm tra cuộc gọi đến tùy chọn bên dưới sẽ thực hiện việc này. Các số đã xác minh hỗ trợ cuộc gọi đến và đi — qua đó mở khóa chiến dịch gọi đi và cuộc gọi đi theo lập trình.

Kiểm tra cuộc gọi đến#

Xác minh số mở một hộp thoại cũng có thể kiểm tra cuộc gọi đến. Bài kiểm tra gọi đến số của bạn, kiểm tra xem cuộc gọi có đến được ThunderPhone hay không, rồi ngắt máy mà không khởi động tác nhân AI của bạn:

• Số có SIP trunk gọi ra riêng (số SIP thủ công và số Twilio sau khi ThunderPhone đã thiết lập gọi ra trong tài khoản Twilio của bạn) trước tiên sẽ tự gọi đến chính mình: ThunderPhone gọi số đó từ chính số đó, qua trunk này. Hộp thoại sẽ thông báo cho bạn trước khi thực hiện cuộc gọi. Cuộc gọi đi qua nhà mạng của bạn và, nếu định tuyến cuộc gọi đến của bạn chính xác, sẽ quay lại trực tiếp ThunderPhone. Khi cuộc gọi quay lại với caller ID của chính số đó, một cuộc gọi này sẽ chứng minh cả việc nhà mạng của bạn chấp nhận cuộc gọi của ThunderPhone dưới số đó và cuộc gọi đến số đó có thể đến ThunderPhone, ở bất kỳ quốc gia nào. Một số nhà mạng từ chối hoặc không kết nối cuộc gọi từ một số đến chính nó; điều đó không phản ánh gì về định tuyến của bạn, vì vậy ThunderPhone sẽ gọi từ một trong các số của ThunderPhone thay thế. Nếu số của bạn chuyển tiếp đến nơi khác, điện thoại đó có thể đổ chuông hai lần: lần đầu hiển thị caller ID của chính số đó, sau đó là số kiểm tra của ThunderPhone.
• Các số khác (và phương án dự phòng ở trên) được gọi từ một trong các số của ThunderPhone. Hiện tại ThunderPhone chỉ có thể thực hiện các cuộc gọi này đến số ở Mỹ và Canada; đối với các số khác, bài kiểm tra sẽ báo rằng không thể chạy, kèm phản hồi của nhà mạng nếu cuộc gọi tự gọi bị từ chối.

Nếu nhà mạng của bạn thay đổi caller ID trên đường truyền, ThunderPhone không thể nhận diện cuộc gọi, nên tác nhân AI của bạn có thể trả lời cuộc gọi đó trong chốc lát. Kiểm tra cuộc gọi đến là tùy chọn. Bạn có thể bỏ qua và số vẫn hoạt động; trang số điện thoại khi đó hiển thị Chưa kiểm tra cuộc gọi đến, và bạn có thể chạy kiểm tra sau bằng Kiểm tra hoặc mục menu Kiểm tra cuộc gọi đến của số đó. Ngay sau khi nhập, trang số điện thoại cũng yêu cầu bạn kiểm tra cuộc gọi đến trên các số mới. Không có cuộc gọi nào được thực hiện cho đến khi bạn xác nhận trong hộp thoại.

Nếu nhà cung cấp của bạn gửi số đến nơi khác, bất cứ điểm đích nào của số đó cũng có thể đổ chuông tối đa 8 giây mỗi cuộc gọi trước khi ThunderPhone ngắt máy. Nếu có thứ gì đó trả lời trước (ứng dụng Twilio trả lời rồi chuyển tiếp, menu điện thoại), bài kiểm tra sẽ chờ cuộc gọi được chuyển tiếp đến ThunderPhone: tối đa 8 giây đối với cuộc gọi tự gọi và 15 giây đối với cuộc gọi từ một số ThunderPhone. Kết quả vẫn được lưu trên số (Cuộc gọi đến đạt hoặc không đạt) cho đến khi bạn thay đổi kết nối hoặc nhập lại số, thao tác này đặt lại trạng thái thành chưa kiểm tra. Thay đổi kết nối sẽ xác minh lại cuộc gọi đi trong nền nhưng không bao giờ gọi đến số của bạn khi chưa được bạn yêu cầu.

Khắc phục sự cố cuộc gọi đến#

Nút Kiểm tra của kết nối kiểm tra thông tin xác thực, còn bước xác minh kiểm tra việc quay số đi. Để kiểm tra cuộc gọi đến, hãy chạy kiểm tra cuộc gọi đến ở trên hoặc gọi đến số đó từ điện thoại và tìm cuộc gọi trong Lịch sử cuộc gọi. Các bài kiểm tra Nói chuyện trên trình duyệt và mô phỏng bot với bot không đi qua nhà mạng của bạn, vì vậy chúng không cho biết cuộc gọi đến có hoạt động hay không. Mô phỏng nhắm đến số điện thoại (vòng lặp SIP) sẽ quay số qua nhà mạng của bạn, vì vậy một cuộc gọi được trả lời sẽ kiểm tra định tuyến cuộc gọi đến.

• Bạn nghe thông báo của chính nhà mạng di động của mình (ví dụ: "Chào mừng đến với Verizon" hoặc "số điện thoại bạn vừa gọi không còn được sử dụng"): cuộc gọi đã thất bại trước khi đến ThunderPhone. Kiểm tra xem số đó có đang hoạt động trong tài khoản nhà cung cấp của bạn và được gán cho kết nối hoặc trunk ThunderPhone hay không.
• Tín hiệu bận hoặc cuộc gọi đổ chuông nhưng không được trả lời: nhà cung cấp đã chấp nhận cuộc gọi nhưng không thể chuyển tiếp. Với Telnyx, hãy kiểm tra Kết nối của số trong cổng thông tin Telnyx: đó phải là kết nối FQDN thunderphone-… được mô tả ở trên hoặc kết nối FQDN của riêng bạn trỏ đến điểm cuối SIP của ThunderPhone. Với Twilio, số đó phải được gắn với trunk SIP ThunderPhone thay vì webhook Voice hoặc ứng dụng TwiML.
• Nhật ký của nhà mạng hiển thị 404 No trunk found (SIP thủ công): cuộc gọi đã đến ThunderPhone nhưng không khớp với trunk nào. Kiểm tra xem số đó đã được nhập vào kết nối này và trunk có trỏ đến sip.thunderphone.com hay không. Nếu trunk trỏ đến địa chỉ <your-project>.sip.livekit.cloud, thì IP nguồn được phép phải để trống: khi có danh sách được thiết lập, chỉ các cuộc gọi gửi đến sip.thunderphone.com mới được chấp nhận.
• 404 Not Found từ sip.thunderphone.com (SIP thủ công): cuộc gọi không được gửi đến một số điện thoại hoặc dòng yêu cầu và tiêu đề To chỉ các số khác nhau. Gửi số đã quay trong cả hai vị trí, như ở trên.
• 403 Forbidden từ sip.thunderphone.com: dòng yêu cầu chỉ một máy chủ khác. Gửi cuộc gọi đến sip.thunderphone.com, ví dụ: sip:+14155550142@sip.thunderphone.com.
• Cuộc gọi đến ThunderPhone nhưng tác nhân AI không đúng trả lời hoặc không có tác nhân AI nào trả lời: kiểm tra tác nhân AI cho cuộc gọi đến của số đó trong Số điện thoại.

Trợ lý đồng hành trong ứng dụng có thể kiểm tra số điện thoại cho bạn: hãy hỏi trợ lý vì sao các cuộc gọi đến số đó thất bại. Với kết nối Telnyx, trợ lý cũng tra cứu, chỉ đọc và dành cho quản trị viên tổ chức, kết nối mà Telnyx gán cho số đó.

Bước tiếp theo#