Tin nhắn âm thanh hay cuộc gọi WhatsApp: chọn cách hỗ trợ phù hợp

Chọn tin nhắn âm thanh WhatsApp khi khách hàng có thể nghe và trả lời sau. Chọn cuộc gọi thoại trực tiếp khi cả hai bên đều rảnh và vấn đề cần làm rõ ngay. Bản ghi âm gửi dưới dạng tin nhắn và cuộc trò chuyện trực tiếp đều truyền đạt lời nói, nhưng ứng dụng hỗ trợ cần yêu cầu, mã định danh và tiêu chí hoàn tất riêng.

Bài viết so sánh tin nhắn âm thanh UnifyPort với cuộc gọi đi một đối một do con người khởi tạo qua giao diện không chính thức, trong bản thử nghiệm riêng. Đây không phải hướng dẫn Meta WhatsApp Business Calling API. Để xem toàn bộ bước thiết lập, hãy đọc hướng dẫn tích hợp cuộc gọi thoại.

1. Chọn theo thời gian thuận tiện của khách hàng

Tình huống hỗ trợ	Cách đề xuất	Lý do
Khách hàng và nhân viên ở múi giờ khác nhau	Tin nhắn âm thanh	Mỗi bên trả lời khi thuận tiện
Giải thích ngắn, không cần hỏi lại ngay	Tin nhắn âm thanh kèm tóm tắt bằng chữ	Khách có thể nghe lại và xem chi tiết chính
Cần trao đổi nhanh để xác nhận nhiều chi tiết	Gọi trực tiếp sau khi xác nhận thời gian	Hai bên cùng làm rõ điểm chưa thống nhất
Khách không tiện nghe riêng hoặc thích chữ	Tin nhắn văn bản	Âm thanh không phù hợp trong mọi hoàn cảnh

Ví dụ, có thể gửi hướng dẫn nhận hàng bằng âm thanh, kèm địa chỉ và giờ bằng chữ. Một chi tiết còn tranh luận có thể cần cuộc gọi nếu khách đồng ý và có thời gian. Đây là gợi ý quy trình, không phải tính năng định tuyến tự động hay cam kết tăng tỷ lệ phản hồi.

2. Dùng hai cấu trúc yêu cầu riêng

Với cả hai cách, giữ API key trên máy chủ, chọn đúng tài khoản nhắn tin WhatsApp đã được cấp quyền có runtime_status là running, và dùng conversation_id được trả về từ tài khoản đó cho hội thoại riêng. Không thay mã hội thoại bằng chuỗi số điện thoại.

Để gửi tin nhắn âm thanh, gửi phần thân sau đến POST /v1/messages:

{
  "account_id": "acc_example",
  "to": { "id": "<conversation_id>", "type": "user" },
  "message": {
    "type": "audio",
    "url": "https://cdn.example.com/support/explanation.ogg"
  }
}

Thay URL ví dụ bằng tài nguyên âm thanh có thể truy cập. Hợp đồng tin nhắn đa phương tiện yêu cầu ít nhất một nguồn không rỗng trong message.url, message.file_url hoặc message.file_key; nguồn URL phải là địa chỉ HTTP(S) tuyệt đối. Ví dụ gửi tệp có sẵn, không yêu cầu API thu âm micrô. Phần mở rộng không chứng minh mã hóa phù hợp; yêu cầu cũng không cam kết một kiểu bong bóng tin nhắn thoại gốc cụ thể hay bản chuyển lời nói thành văn bản.

Để gọi thoại trực tiếp, gửi phần thân khác đến POST /v1/calls:

{
  "account_id": "acc_example",
  "to": { "id": "<conversation_id>", "type": "user" },
  "media_type": "voice"
}

Hợp đồng tạo cuộc gọi yêu cầu không gian làm việc được bộ phận hỗ trợ bật quyền thử nghiệm. is_beta là cờ chỉ đọc. Phản hồi thành công 201 với state: preparing cho biết liên kết riêng tư dùng một lần join_url đã sẵn sàng. Nhân viên phải mở và nhấn Start call trước expires_at; chỉ mở trang không bắt đầu quay số. Thời gian chuẩn bị mặc định hai phút từ lúc tạo, máy chủ có thể điều chỉnh, và không giới hạn thời lượng cuộc gọi đã kết nối. Quyền micrô là bắt buộc; camera là tùy chọn.

3. Lưu bằng chứng kết quả riêng cho từng cách

Quan sát được	Nên lưu	Chưa chứng minh được
Phản hồi tin nhắn có status: accepted	message_id trả về và tài khoản	Đã giao, đã phát âm thanh hay đã giải quyết vấn đề
Có sự kiện giao hoặc đọc tin nhắn khớp	Phạm vi biên nhận và mã tin nhắn tương ứng	Khách đã nghe âm thanh
Tạo cuộc gọi trả về liên kết đã chuẩn bị	call_id trả về và tác vụ hỗ trợ được giao	Đã quay số hoặc kết nối
Nhận call.answered	Bằng chứng kết nối cho data.call.id	Vấn đề đã được giải quyết
Nhận call.ended	Lý do kết thúc và duration_seconds	Không giây chứng minh chưa kết nối

Áp dụng phạm vi biên nhận theo tài liệu đã giao và đã đọc, không đánh dấu hoàn tất mọi tin trong hội thoại. Đã đọc không phải biên nhận phát âm thanh. Thời gian kết nối được làm tròn xuống giây nguyên, nên vẫn giữ bằng chứng sự kiện kết nối khi thời lượng bằng không.

Cấu hình đăng ký cần thiết và làm theo hướng dẫn chuyển phát, xác minh chữ ký Webhook: xác minh phần thân nguyên gốc, loại trùng và xử lý sự kiện chậm hoặc sai thứ tự. Quyền thử nghiệm và đăng ký sự kiện cuộc gọi là hai điều kiện riêng. Tệp âm thanh đính kèm tin nhắn không phải sự kiện cuộc gọi hay bản ghi âm tự động từ API cuộc gọi.

4. Làm rõ thao tác của nhân viên

Trong ứng dụng, tách Gửi âm thanh và Bắt đầu cuộc gọi thoại. Trước khi gửi, hiển thị tệp đã chọn và khách hàng. Nếu xây dựng thu âm micrô, lưu trữ tệp hay chuyển lời nói thành văn bản, hãy xem đó là chức năng riêng của ứng dụng và kiểm tra đầu ra trước khi đưa tài nguyên cho API.

Ở thao tác gọi, hiển thị khách hàng mục tiêu, nhân viên phụ trách và tính khả dụng. Chỉ cung cấp liên kết cho người thao tác lần này, không ghi đầy đủ vào nhật ký. Lưu tin nhắn và cuộc gọi riêng rồi liên kết với cùng tác vụ hỗ trợ. Kết thúc cuộc gọi không nên tự động đóng phiếu.

5. Chuyển cách liên lạc cần một quyết định mới

Không có trả lời cho tin nhắn âm thanh không có nghĩa khách chưa nghe, và không nên tự động gọi. Hãy hỏi khách có tiện nghe máy không. Nếu cuộc gọi chưa giải quyết được vấn đề, nhân viên có thể chủ động gửi tóm tắt bằng chữ hoặc âm thanh để theo dõi. Đó là tin nhắn mới, không phải phần tiếp của kết quả cuộc gọi.

Khi yêu cầu hết thời gian chờ, giữ trạng thái chưa rõ kết quả thay vì lập tức lặp lại thao tác ghi. Nếu kết quả gọi chưa rõ, xem hướng dẫn chẩn đoán cuộc gọi và kiểm tra cuộc gọi hiện tại do hệ thống quản lý. Kết quả rỗng không tái tạo lịch sử trước đó. Không ngắt cuộc gọi chưa rõ chủ thể chỉ để giải phóng tài khoản.

6. Bắt đầu với một tác vụ hỗ trợ cụ thể

Chọn hội thoại thử nghiệm phù hợp, thống nhất cách liên lạc với khách rồi kiểm tra tài khoản, mục tiêu, yêu cầu, mã đã lưu và sự kiện sau đó. Kiểm tra sự kiện trùng và lần cập nhật phiếu cuối của nhân viên. Đây là bước nghiệm thu đề xuất, không phải báo cáo thử cuộc gọi thật cho bài viết này.

Phạm vi gọi hiện tại không gồm cuộc gọi đến, gọi nhóm, ghi âm, chuyển lời nói thành văn bản, SIP/PBX hay AI tự động gọi đi. Để trao đổi quyền sử dụng và tình huống hỗ trợ cụ thể, hãy liên hệ hỗ trợ kỹ thuật, không chia sẻ API key hoặc liên kết gọi riêng tư.