Logo GRANDSTREAMMạng Grandstream, Inc.
Dòng GSC3505/3510/3506/3516
Hướng dẫn CTI

GSC35XX : Hướng dẫn CTI

Yêu cầu định dạng

Định dạng yêu cầu lệnh CTI chung là:  http://phone-IP-Address-cgi-bin-function.passcode.PASSWORD&param.value

“Chức năng” là một trong các hàm CTI như được mô tả trong chương tiếp theo (api-get_line_status for example)
“Mật khẩu” là mật khẩu cấp quản trị viên của điện thoại “Param=value” là tham số cho loại chức năng CTI cụ thể

Định dạng phản hồi
Câu trả lời tích cực không có giá trị trả về
{“response”:”thành công”, “nội dung”: “hoàn thành”}

Câu trả lời phủ định
{“response”:”error”, “body”: “fail”}
Câu trả lời tích cực với giá trị trả về
{“response”:”success”, “body”: [{“line”: 1, “state”: “idle”, “acct”: “”,,”remotename”: “”, “remotenumber”:
“”, “active”: 0}, {“line”: 2,”state”:”idle”, “acct”: “”, “remotename”: “”, “remotenumber”: “”, “active”:
0},{“line”: 3, “state”: “idle”, “acct”: “”, “remotename”: “”, “remotenumber”: “”, “active”: 0}]}

LOẠI CHỨC NĂNG CTI

Vui lòng tham khảo bảng sau mô tả loại chức năng CTI được hỗ trợ:

Kiểu Chức năng Sự miêu tả Phương pháp
Tình trạng điện thoại api-get_phone_status Truy xuất trạng thái điện thoại LẤY
Thực hiện cuộc gọi api-make_call Thực hiện cuộc gọi chung LẤY
Hoạt động điện thoại api-phone_Operation Gửi các lệnh thao tác trên điện thoại (cúp máy, trả lời cuộc gọi, từ chối cuộc gọi…) LẤY
Hoạt động hệ thống api-sys_Operation Gửi các lệnh vận hành hệ thống (đặt lại, khởi động lại…) LẤY
Nhận danh sách nhạc địa phương api-get_music lấy danh sách nhạc cục bộ được lưu trong thiết bị LẤY
Điều khiển phát nhạc api-ctrl_music_play kiểm soát việc phát hoặc dừng nhạc cục bộ LẤY

Chức năng CTI được hỗ trợ

CTI LỆNH VÀ EXAMPLES

Các lệnh sau đã được chạy trong một web trình duyệt trên máy tính trong cùng một mạng điện thoại. Trong người cũamples bên dưới, thiết bị GSC3516 được sử dụng với địa chỉ IP 192.168.5.135 và mật khẩu cấp quản trị viên được đặt thành mặc định (passcode=admin).

Chức năng trạng thái điện thoại

Định dạng chung
Định dạng chung của lệnh CTI để truy xuất trạng thái điện thoại là:
http://Phone-IP-Address-cgi-bin-api-get_phone_status.passcode=PASSWORD

Giới thiệu về URL tham số
mật mã: MẬT KHẨU
Example

Lời yêu cầu http://192.168.5.135-cgi-bin-api-get_phone_status.passcode=admin
Phản ứng Điện thoại có sẵn
{“phản hồi”:”thành công”,
, “linh tinh”: “1”}
“cơ thể”: “có sẵn”
Điện thoại bận
{“phản hồi”:”thành công”,
“linh tinh”: “1”}
“cơ thể”: “bận rộn”,

Thực hiện cuộc gọi

Định dạng chung
Định dạng chung của lệnh CTI để bắt đầu cuộc gọi là:
http://Phone-IP-Address-cgi-bin-api-make_call.passcode=PASSWORD&phonenumber=NUMBER

Giới thiệu về URL tham số
mật mã: MẬT KHẨU
phone number: số điện thoại
Example

Lời yêu cầu http://192.168.5.135-cgi-bin-api-make_call.passcode=admin&phonenumber=35463
Phản ứng { “response”: “thành công”, “cơ thể”: đúng }

Chức năng vận hành điện thoại

Định dạng chung
Định dạng chung của lệnh CTI để gửi thao tác điện thoại là:
http://Phone-IP-Address-cgi-bin-api-phone_operation.passcode=PASSWORD&cmd=CMD

Giới thiệu về URL tham số
mật mã: MẬT KHẨU
cmd : chức năng thao tác của điện thoại
Examptập

Hoạt động Chức năng Examptập
  kết thúc cuộc gọi Kết thúc cuộc gọi đã thiết lập  http://192.168.5.135-cgi-bin-api-phone_operation.passcode=admin&cmd=endcall
 chấp nhận cuộc gọi Chấp nhận cuộc gọi đến http://192.168.5.135-cgi-bin-api-phone_operation.passcode=admin&cmd=acceptcall
Từ chối cuộc gọi Từ chối cuộc gọi đến http://192.168.5.135-cgi-bin-api-phone_operation.passcode=admin&cmd=rejectcall
tắt tiếng Tắt tiếng hoặc bật tiếng trong khi gọi http://192.168.5.135-cgi-bin-api-phone_operation.passcode=admin&cmd=mute
trình kích hoạt đầu tiên bị tắt tiếng, sau đó trình kích hoạt thứ hai được bật tiếng.

Chức năng vận hành hệ thống
Định dạng chung
Lệnh CTI chung để gửi các hoạt động hệ thống là:
http://Phone-IP-Address-cgi-bin-api-sys_operation.passcode=PASSWORD&request=CMD

Giới thiệu về URL tham số
mật mã: MẬT KHẨU
yêu cầu: chức năng vận hành hệ thống
Examptập

Hoạt động   Chức năng Example
KHỞI ĐỘNG LẠI Khởi động lại thiết bị http://192.168.5.135/cgi-bin/api-sys_operation?passcode=admin&request=REBOOT
CÀI LẠI Đặt lại thiết bị về Cài đặt mặc định http://192.168.5.135-cgi-bin-api-sys_operation.passcode=admin&request=RESET

Nhận danh sách nhạc địa phương

Định dạng chung
Lệnh CTI chung để lấy danh sách nhạc cục bộ là:
http://Phone-IP-Address-cgi-bin-api-get_music.passcode=PASSWORD

Giới thiệu về URL tham số
mật mã: MẬT KHẨU
Example

Lời yêu cầu http://192.168.5.135-cgi-bin-api-get_music.passcode=admin
Phản ứng {“phản hồi”:”thành công”,
"thân hình":[{"fileTên”: “music1.ogg”, “đường dẫn”:
“/var/user/music/music1.ogg”},
{“fileTên”: “music2.ogg”, “path”:“/var/user/music/music2.ogg”}
]}

Điều khiển phát nhạc

Định dạng chung
Lệnh CTI chung để phát hoặc dừng phát nhạc là:
http://Phone-IP-Address-cgi-bin-api-ctrl_music_play.passcode=PASSWORD&state=STATE&type=TYPE&url=URL&loop=LOOP

Giới thiệu về URL tham số

mật mã: MẬT KHẨU
trạng thái: dừng hoặc phát nhạc. (0 – dừng; 1 – phát)
loại : 1, Giá trị mặc định
url : Đường dẫn phát nhạc,Bạn có thể lấy đường dẫn nhạc thông qua giao diện “api-get_music”
loop: Phát lại một lần hoặc lặp lại. (0 – đơn; 1 – vòng lặp)

Example

Chức năng Example
Phát lại vòng lặp http://192.168.5.135-cgi-bin-api-ctrl_music_play.passcode=admin&state=1&type=1&url=/var/user/music/music1.ogg&loop=1
Phát lại đơn http://192.168.5.135/cgi-bin/api-ctrl_music_play.passcode=admin&state=1&type=1&url=/var/user/music/music1.ogg&loop=0
Dừng phát lại http://192.168.5.135/cgi-bin/api-ctrl_music_play.passcode=admin&state=0&type=1&url=/var/user/music/music1.ogg&loop=0

Các mô hình được hỗ trợ

Tên mẫu Hỗ trợ CTI Yêu cầu phần mềm
GSC3505 ĐÚNG 1.0.3.8 hoặc cao hơn
GSC3510 ĐÚNG 1.0.3.8 hoặc cao hơn
GSC3506 ĐÚNG 1.0.3.8 hoặc cao hơn
GSC3516 ĐÚNG 1.0.3.8 hoặc cao hơn

Các mẫu GSC được hỗ trợ

Cần hỗ trợ?
Không thể tìm thấy câu trả lời bạn đang tìm kiếm? Đừng lo lắng, chúng tôi ở đây để giúp đỡ!
LIÊN HỆ HỖ TRỢ

Logo GRANDSTREAM

Tài liệu / Tài nguyên

GRANDSTREAM GSC3505 Loa công cộng 1 chiều SIP Intercom [tập tin pdf] Hướng dẫn sử dụng
GSC3505 Loa địa chỉ công cộng 1 chiều SIP Intercom, GSC3505, Loa địa chỉ công cộng 1 chiều SIP Intercom, Loa địa chỉ công cộng SIP Intercom, Loa địa chỉ SIP Intercom, Loa liên lạc SIP, Loa liên lạc nội bộ

Tài liệu tham khảo

Để lại bình luận

Địa chỉ email của bạn sẽ không được công bố. Các trường bắt buộc được đánh dấu *