Sử dụng HTTPS và xác thực HTTP Basic với thông tin xác thực API đã được phê duyệt. Hãy giữ thông tin xác thực trên máy chủ ứng dụng của bạn. Các điểm cuối PBX được lưu trữ này dùng /hpbx/ trên api.multitel.net; không chèn /v3. Hãy kiểm tra cả kết quả HTTP và trạng thái kết quả xử lý ở cấp ứng dụng trong phản hồi JSON.
Chọn số và PBX
Định dạng địa chỉ API là POST /hpbx/dids/{operation}/{billing_code}. Các thao tác được hỗ trợ gồm tạo, chỉnh sửa và xóa. Mã thanh toán phải xác định một PBX thuộc tài khoản đã được xác thực. Việc tạo bản ghi định tuyến không đồng nghĩa với mua số điện thoại mới trên mạng điện thoại công cộng.
Các trường định tuyến
| Trường | Mục đích |
|---|---|
| number / fullnumber | Số DID tương ứng với bản ghi định tuyến PBX. |
| comment | Mô tả dành cho quản trị viên. |
| maxchannels | Số cuộc gọi đồng thời tối đa của tuyến PBX. |
| destination | Các giá trị điểm đến theo thứ tự cho PBX đã chọn. |
| unconditional | Đích chuyển tiếp vô điều kiện khi được sử dụng. |
| cnam | Cài đặt tra cứu tên người gọi; có thể áp dụng phí sử dụng. |
| recording | Chính sách ghi âm: no, yes, yeschange hoặc nochange. |
| di_emailrecording / di_minemailrecording | Email đích nhận bản ghi âm và thời lượng tối thiểu. |
| allowemergency / emergencynotes | Cài đặt mã người gọi (caller-ID) cho cuộc gọi khẩn cấp; các cài đặt này không đăng ký địa chỉ sử dụng dịch vụ cho cuộc gọi khẩn cấp. |
| didprefix / didnameprefix | Tiền tố số/tên người gọi. |
| fax / faxprotocol / faxstore / faxemail | Phát hiện fax, giao thức và các lựa chọn gửi/lưu trữ. |
| sms_destination / di_smstofield / di_sms_store | Các cài đặt gửi/lưu trữ tin nhắn đang được bật. |
Chuẩn bị các đích cuộc gọi hợp lệ
Các giá trị đích phải lấy từ PBX đã chọn; mẫu Array() trước đây không phải là payload JSON hoặc biểu mẫu. Hãy xác định các máy nhánh, IVR hoặc nhóm trước khi tạo yêu cầu. Sử dụng lược đồ định tuyến số hiện hành cho giao diện API mà bạn đang tích hợp.
Xác minh kết quả
Kiểm tra trạng thái kết quả xử lý ở tầng ứng dụng trong phản hồi JSON của API, mở lại cấu hình của số và thực hiện một cuộc gọi đến có kiểm soát. Kiểm tra riêng từng đường xử lý khi bận, không trả lời, hết thời gian và ghi âm/fax/tin nhắn. Làm theo hướng dẫn định tuyến trên cổng thông tin để cấu hình từng bước.