Skip to main content
Phong Nguyen
💬
0 discussions

Hướng dẫn tích hợp Nexmo

I. Điều kiện tiên quyết​

II. Đối tượng đọc​

  • Stage Owner
  • Customer Success Engineer
  • Customer Success Specialist

III. Tích hợp SMS Nexmo với đầu số Mỹ​

1. Đăng ký Subaccount API key cho một Callcenter mới.​

  • Đăng nhập vào Tài khoản Nexmo (https://dashboard.nexmo.com)

  • Trên menu truy cập vào API Settings -> Request more API keys.

  • Điền thông tin trên mẫu -> nhấn nút Submit.

    • Description: Mô tả yêu cầu cần tạo API keys. Ví dụ: Creation of a new secondary API Key.
    • API Key: Nhập master API key của tài khoản. Trường nãy sẽ được điền tự động. Bạn không cần thay đổi.

  • Vui lòng đợi Nexmo Support phản hồi thông tin qua email (devops+nexmo@gcalls.co) sau khi đã tạo mới Api key cho bạn.

  • Sau khi đăng ký API Key thành công. Bạn chọn Account mới tạo -> vào API Settings bạn sẽ thấy thông tin để tích hợp Nexmo. Bao gồm API key và API secret.

2. Đăng ký đầu số mới​

  • Đăng nhập vào Tài khoản Nexmo (https://dashboard.nexmo.com)
  • Trên menu truy cập vào Numbers -> By Numbers.
  • Trên giao diện tạo numbers. Lựa chọn loại số cần mua và nhấn nút Search.
    • Country=United States
    • Feature=SMS & MMS & VOICE
    • Type=Mobile

  • Chọn số cần mua -> nhấn nút Buy để hoàn tất.
  • Sau khi đã mua số thành công. Nhắn vào icon "Edit" để chỉnh sửa thông tin.
  • Tại mục "Inbound Webhook URL" nhập vào giá trị: https://integration.gcalls.co/api/nexmo/inbound-sms
  • Nhấn "Save" để hoàn thành cài đặt webhook cho việc nhận SMS.

3. Đăng ký Brand​

4. Đăng ký Campaign​

  • Sau khi đăng ký Brand thành công. Tiến hành đăng ký Campaign. Xem chi tiết hướng dẫn tại Register a campaign.

5. Liên kết đầu số với Campaign​

  • Sau khi đăng ký Campaign thành công. Tiến hành liên kết đầu số điện thoại với Campaign. Xem chi tiết hướng dẫn tại Link a number to a campaign.

6. Cài đặt tích hợp callcenter với SMS Nexmo trên portal.gcalls.co​

  • Đăng nhập vào porttal (https://portal.gcalls.co)

  • Trên menu vào "Integration" và tìm kiếm với từ khóa "nexmo"

  • Nhắn vào biểu tượng "xem" -> nhắn vào Add Integrator để thêm mới tích hợp cho callcenter

  • Nhập thông tin theo mẫu.

    • Với "api_key" và "api_secret" và thông tin tạo ở Bước 1.
    • Với "from" là số điện thoại đăng ký ở Bước 2.

  • Kiểm tra gửi SMS tại giao diện Webphone. Chọn một đầu số Mỹ cần gửi SMS. Nhắn vào biểu tượng SMS -> Soạn tin nhắn -> nhấn nút Gửi.

IV. Tích hợp Nexmo với PBX để nghe gọi.​

1. Cấu hình SIP trên Nexmo để gọi vào​

  • Truy cập https://dashboard.nexmo.com/
  • Numbers => Your Number => Chọn edit số muốn cấu hình.
  • Voice: chọn SIP
  • SIP URI: sip:12014739588@gc03-pbx.tel4vn.com:50062 (có thể chọn các số trước đã cấu hình để tham khảo). Trong đó: 12014739588 là số điện thoại bạn đang chỉnh sửa.

2. Cấu hình gateway và outbound route trên PBX để gọi ra​

  • Tạo gateway đến Nexmo

    • Username: API key (Tạo ở Bước 1).
    • Password: API secret (Tạo ở Bước 1).
    • Proxy: sip-us-2-1.nexmo.com
    • Register: True
    • Caller ID From: bỏ trống

  • Cấu hình outbound route

V. Kết luận​

  • Sau khi tích hợp Nexmo thành công. Bạn đã có thể dùng Nexmo để gửi và nhận tin nhắn, nghe và gọi trên Webphone.