Tự động gọi phát file ghi âm với Voice API – Hướng dẫn chi tiết

1. Khi nào dùng file ghi âm thay vì TTS?

Dùng file ghi âm khi:

• Nội dung cố định, không cần personalize nhiều
• Cần giọng tự nhiên, có cảm xúc
• Thông báo quan trọng cần tone chuyên nghiệp
• Giọng người nổi tiếng/đại diện thương hiệu

Dùng TTS khi:

• Nội dung động (tên khách, số tiền, ngày giờ…)
• Nhiều variations khác nhau
• Không có budget thu âm chuyên nghiệp

Kết hợp cả hai:

[File ghi âm: Lời chào cố định] 
+ [TTS: Tên khách hàng] 
+ [File ghi âm: Nội dung chính] 
+ [TTS: Số tiền, ngày hẹn]
+ [File ghi âm: Lời kết]

2. Chuẩn bị file ghi âm

Format yêu cầu:

• Định dạng: MP3, WAV, hoặc OGG
• Sample rate: 8kHz hoặc 16kHz (telephony standard)
• Bitrate: 64-128 kbps
• Mono channel (stereo không cần thiết)

Tips thu âm:

• Phòng yên tĩnh, không echo
• Mic chất lượng (không cần studio, USB mic đủ tốt)
• Nói rõ ràng, tốc độ vừa phải
• Để khoảng trống 0.5-1s đầu và cuối
• Độ dài: 15-45 giây là optimal

Công cụ thu âm miễn phí:

• Audacity (PC/Mac)
• Voice Memos (iPhone)
• Recorder (Android)

3. Upload và quản lý file

Upload qua API:

POST https://api.alohub.vn/v1/voice/media/upload
Content-Type: multipart/form-data

file: [your-audio-file.mp3]
name: "reminder_appointment_v1"
description: "Nhắc lịch hẹn - version 1"

Response:

{
  "media_id": "media_abc123",
  "name": "reminder_appointment_v1",
  "duration_seconds": 28,
  "format": "mp3",
  "url": "https://cdn.alohub.vn/media/media_abc123.mp3"
}

Alohub – giải pháp AI Contact Center & nền tảng CPaaS tại Việt Nam – lưu trữ file audio không giới hạn thời gian.

4. Gọi điện phát file ghi âm

Gọi một số:

POST https://api.alohub.vn/v1/voice/call
{
  "to": "0901234567",
  "flow": [
    {
      "action": "play_media",
      "media_id": "media_abc123"
    }
  ],
  "callback_url": "https://your-app.com/webhook/call-result"
}

Gọi hàng loạt (bulk):

POST https://api.alohub.vn/v1/voice/campaign
{
  "name": "Thông báo khuyến mãi tháng 1",
  "recipients": [
    {"phone": "0901234567", "name": "Nguyễn Văn A"},
    {"phone": "0912345678", "name": "Trần Thị B"},
    // ... hàng nghìn số
  ],
  "flow": [
    {
      "action": "play_media",
      "media_id": "media_abc123"
    }
  ],
  "settings": {
    "concurrent_calls": 50,
    "retry_if_no_answer": true,
    "max_retries": 2,
    "retry_interval_minutes": 60,
    "calling_hours": {
      "start": "09:00",
      "end": "20:00"
    }
  },
  "callback_url": "https://your-app.com/webhook/campaign-result"
}

5. Thêm tương tác DTMF

Phát ghi âm + Thu phím bấm:

POST https://api.alohub.vn/v1/voice/call
{
  "to": "0901234567",
  "flow": [
    {
      "action": "play_media",
      "media_id": "media_greeting"
    },
    {
      "action": "play_media", 
      "media_id": "media_options"  // "Nhấn 1 để xác nhận, nhấn 2 để từ chối"
    },
    {
      "action": "gather_dtmf",
      "num_digits": 1,
      "timeout": 10,
      "on_result": {
        "1": { 
          "action": "play_media", 
          "media_id": "media_confirmed" 
        },
        "2": { 
          "action": "play_media", 
          "media_id": "media_declined" 
        },
        "timeout": {
          "action": "play_media",
          "media_id": "media_no_response"
        }
      }
    }
  ]
}

6. Tracking và báo cáo

Webhook events:

• call.initiated – Bắt đầu gọi
• call.ringing – Đang đổ chuông
• call.answered – Khách bắt máy
• call.completed – Kết thúc cuộc gọi
• call.failed – Gọi thất bại
• dtmf.received – Nhận phím bấm

Metrics cần track:

7. Use cases phổ biến

Nhắc nợ/thanh toán:

• File 1: “Xin chào, đây là thông báo từ [Công ty]…”
• File 2: “Bạn có khoản thanh toán [số tiền] đến hạn…”
• File 3: “Nhấn 1 nếu đã thanh toán, nhấn 2 để được hỗ trợ”

Thông báo khuyến mãi:

• File duy nhất: Thông báo promotion, kết thúc bằng hotline
• Không cần DTMF nếu chỉ broadcast

Khảo sát ngắn:

• File 1: “Bạn hài lòng với dịch vụ không?”
• DTMF: 1-5 sao
• File 2: “Cảm ơn bạn đã phản hồi”

8. Tóm lại

• File ghi âm: Đơn giản nhất, giọng tự nhiên, kiểm soát chất lượng.
• Format: MP3/WAV, 8-16kHz, mono.
• API flow: Upload file → Tạo campaign → Track results.
• DTMF: Thêm tương tác với phím bấm.

Alohub – giải pháp AI Contact Center & nền tảng CPaaS tại Việt Nam – hỗ trợ bulk voice broadcast với concurrent calls cao.

FAQ

File ghi âm có giới hạn dung lượng không?

Max 10MB per file, tương đương ~10 phút audio MP3. Với use case thông báo, 30-60 giây là đủ. File lớn hơn cần chia nhỏ thành nhiều segments.

Có thể chèn tên khách hàng vào giữa file ghi âm không?

Có, bằng cách kết hợp file ghi âm + TTS. Ví dụ: [File: “Xin chào”] + [TTS: “Nguyễn Văn A”] + [File: “bạn có lịch hẹn…”]. API hỗ trợ ghép nhiều segments trong một cuộc gọi.

Gọi ngoài giờ hành chính có bị chặn không?

Theo quy định, không nên gọi trước 8h sáng và sau 21h tối. Alohub API có setting calling_hours để tự động queue calls trong giờ cho phép. Gọi quá giờ có thể bị khách report spam.