Bất kỳ ai phát triển trên Voximplant đều biết về khái niệm “ứng dụng” kết nối tập lệnh đám mây, số điện thoại, người dùng, quy tắc và hàng đợi cuộc gọi với nhau. Nói một cách đơn giản, các ứng dụng là nền tảng phát triển trên nền tảng của chúng tôi, là điểm khởi đầu cho bất kỳ giải pháp dựa trên Voximplant nào, vì việc tạo một ứng dụng là nơi tất cả bắt đầu.
Trước đây, các ứng dụng không “ghi nhớ” các hành động mà tập lệnh thực hiện hoặc kết quả tính toán, vì vậy các nhà phát triển buộc phải lưu trữ các giá trị trong các dịch vụ của bên thứ ba hoặc trên chương trình phụ trợ của họ. Nếu bạn đã từng làm việc với bộ nhớ cục bộ trong trình duyệt thì chức năng mới của chúng tôi khá giống với chức năng này, bởi vì... Cho phép ứng dụng ghi nhớ các cặp khóa-giá trị duy nhất cho mỗi ứng dụng trong tài khoản của bạn. Hoạt động lưu trữ trở nên khả thi nhờ mô-đun mới – bên dưới phần cắt bạn sẽ tìm thấy hướng dẫn ngắn về cách sử dụng, xin chào mừng bạn!
Bạn cần
- Tài khoản Voximplant. Nếu bạn không có nó thì ;
- Ứng dụng Voximplant, cũng như một tập lệnh, một quy tắc và một người dùng. Chúng ta sẽ tạo tất cả những thứ này trong hướng dẫn này;
- web client để thực hiện cuộc gọi - sử dụng webphone của chúng tôi .
Cài đặt Voximplant
Đầu tiên, đăng nhập vào tài khoản của bạn: . Trong menu bên trái, nhấp vào "Ứng dụng", sau đó nhấp vào "Ứng dụng mới" và tạo một ứng dụng có tên lưu trữ. Vào ứng dụng mới chuyển sang tab Scripts để tạo script countCalls với đoạn code sau:
require(Modules.ApplicationStorage);
VoxEngine.addEventListener(AppEvents.CallAlerting, async (e) => {
let r = {value: -1};
try {
r = await ApplicationStorage.get('totalCalls');
if (r === null) {
r = await ApplicationStorage.put('totalCalls', 0);
}
} catch(e) {
Logger.write('Failure while getting totalCalls value');
}
try {
await ApplicationStorage.put('totalCalls', (r.value | 0) + 1);
} catch(e) {
Logger.write('Failure while updating totalCalls value');
}
e.call.answer();
e.call.say(`Приветствую. Количество прошлых звонков: ${r.value}. `, Language.RU_RUSSIAN_MALE);
e.call.addEventListener(CallEvents.PlaybackFinished, VoxEngine.terminate);
});Dòng đầu tiên kết nối mô-đun ApplicationStorage, phần logic còn lại được đặt trong trình xử lý sự kiện .
Đầu tiên chúng ta khai báo một biến để có thể so sánh giá trị ban đầu với bộ đếm cuộc gọi. Sau đó, chúng tôi cố gắng lấy giá trị của khóa TotalCalls từ cửa hàng. Nếu khóa như vậy chưa tồn tại thì chúng tôi sẽ tạo nó:
try {
r = await ApplicationStorage.get('totalCalls');
if (r === null) {
r = await ApplicationStorage.put('totalCalls', 0);
}
}Tiếp theo, bạn cần tăng giá trị của khóa trong bộ lưu trữ:
try {
await ApplicationStorage.put('totalCalls', (r.value | 0) + 1);
}Chú ý
Đối với mỗi lời hứa, bạn phải chỉ định rõ ràng việc xử lý lỗi, như được hiển thị trong danh sách ở trên - nếu không tập lệnh sẽ ngừng chạy và bạn sẽ thấy lỗi trong nhật ký. Chi tiết .
Sau khi làm việc với kho lưu trữ, tập lệnh sẽ trả lời cuộc gọi đến bằng cách sử dụng tính năng tổng hợp giọng nói và cho bạn biết trước đó bạn đã gọi bao nhiêu lần. Sau thông báo này, tập lệnh kết thúc phiên.
Khi bạn đã lưu tập lệnh, hãy chuyển đến tab Định tuyến của ứng dụng và nhấp vào Quy tắc mới. Gọi nó là startCounting, chỉ định tập lệnh countCalls và để lại mặt nạ mặc định (.*).
Việc cuối cùng là tạo người dùng. Để thực hiện việc này, hãy đi tới “Người dùng”, nhấp vào “Tạo người dùng”, chỉ định tên (ví dụ: user1) và mật khẩu, sau đó nhấp vào “Tạo”. Chúng tôi sẽ cần cặp mật khẩu đăng nhập này để xác thực trên webphone.
Kiểm tra
Mở webphone bằng liên kết và đăng nhập bằng tên tài khoản, tên ứng dụng và cặp tên người dùng-mật khẩu từ ứng dụng. Sau khi đăng nhập thành công, nhập bộ ký tự bất kỳ vào trường nhập và nhấp vào Gọi. Nếu mọi thứ được thực hiện chính xác, bạn sẽ nghe thấy một lời chào tổng hợp!
Chúng tôi chúc bạn phát triển tốt hơn trên Voximplant và theo dõi để biết thêm tin tức - chúng tôi sẽ có nhiều tin tức hơn nữa 😉
Nguồn: www.habr.com