Cách sử dụng Play Audio trong Alohub Node trên n8n

Hướng dẫn chi tiết cách sử dụng tính năng Play Audio của Alohub trên n8n — thực hiện cuộc gọi ra và phát file ghi âm có sẵn (MP3, WAV, M4A) cho khách hàng.

Yêu cầu: Đã cài đặt node n8n-nodes-alohub và thiết lập API Key credential. Xem Hướng dẫn cài đặt nếu chưa thực hiện.

Tổng quan

Play Audio cho phép Alohub thực hiện cuộc gọi ra và phát file âm thanh có sẵn cho khách hàng. Khác với Text to Speech (giọng tổng hợp), Play Audio dùng file ghi âm thật do bạn cung cấp — phù hợp khi cần:

• Phát thông điệp quảng cáo đã được ghi âm chuyên nghiệp

• Phát jingle, nhạc chờ thương hiệu

• Phát thông báo bằng giọng người thật, có cảm xúc tự nhiên hơn TTS

• Phát nội dung đa ngôn ngữ (tiếng Anh, Trung, Hàn...) khi TTS chưa hỗ trợ

Định dạng file hỗ trợ

Cấu hình node

1. Kéo node Alohub vào canvas workflow

2. Chọn Credential: Alohub account đã tạo

3. Chọn Resource: Voice

4. Chọn Operation: Play Audio

5. Chọn Audio Source: cách lấy file âm thanh (URL hoặc Binary Data)

Tham số đầu vào

Hai cách cung cấp file âm thanh

Cách 1 — Audio Source: URL (khuyên dùng)

Phù hợp khi bạn đã upload file lên một nơi có link công khai (CDN, S3, Google Drive public...). Node sẽ tự động tải file và gửi tới Alohub.

Mẹo: Đây là cách ổn định nhất — file được gửi nguyên vẹn, tránh hiện tượng vỡ tiếng do encode/decode khi đi qua nhiều node.

Với Google Drive: lấy link share file, sau đó chuyển sang dạng download trực tiếp:

# Link share gốc:
https://drive.google.com/file/d/FILE_ID/view?usp=sharing

# Đổi thành link download trực tiếp:
https://drive.google.com/uc?export=download&id=FILE_ID

Cách 2 — Audio Source: Binary Data

Phù hợp khi file đến từ node khác trong workflow (Google Drive node, HTTP Request, Read Binary File, Email Attachment...).

Cấu hình:

• Trường Binary Property: nhập tên property chứa file binary (thường là data — tên mặc định của n8n)

• Node trước phải xuất ra binary data ở property cùng tên

Lưu ý: Một số file WAV có thể bị thay đổi khi đi qua binary pipeline của n8n. Nếu gặp hiện tượng vỡ tiếng, hãy chuyển sang Audio Source: URL hoặc đổi sang file MP3.

API endpoint sử dụng

POST https://xapi.alohub.vn/v1/voice/tts/audio

Node gửi request dạng multipart/form-data với 2 trường:

Response mẫu

Khi thành công:

{
  "success": true,
  "httpStatus": 200,
  "transactionId": "ah_n8n_a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "resource": "voice",
  "operation": "playAudio",
  "timestamp": "2026-04-15T09:00:00.000Z",
  "error_code": "SUCCESS",
  "error_message": "SUCCESS"
}

Khi lỗi:

{
  "success": false,
  "httpStatus": 400,
  "transactionId": "ah_n8n_...",
  "error_code": "0",
  "error_message": "File audio không hợp lệ",
  "errorCode": "0",
  "errorMessage": "File audio không hợp lệ"
}

Ví dụ workflow thực tế

Workflow 1 — Phát quảng cáo từ link URL

[Manual Trigger] → [Alohub: Voice > Play Audio]
                     Phone Number: 0912345678
                     Audio Source: URL
                     Audio URL: https://cdn.alohub.vn/audio/promo.mp3

Workflow 2 — Phát file từ Google Drive

[Schedule Trigger] → [Google Drive: Download File] → [Alohub: Voice > Play Audio]
                                                       Phone Number: 0912345678
                                                       Audio Source: Binary Data
                                                       Binary Property: data

Workflow 3 — Gửi nhắc nợ hàng loạt

[Schedule Trigger 9AM] → [Database: Get Overdue Customers] → [Loop: For Each] → [Alohub: Voice > Play Audio]
                                                                                  Phone Number: {{ $json.phone }}
                                                                                  Audio Source: URL
                                                                                  Audio URL: https://cdn.alohub.vn/audio/payment-reminder.mp3

Workflow 4 — Gửi voice message từ email attachment

[Email Trigger] → [Extract Attachment (MP3)] → [Alohub: Voice > Play Audio]
                                                  Phone Number: {{ $json.recipient_phone }}
                                                  Audio Source: Binary Data
                                                  Binary Property: attachment_0

Sử dụng với AI Agent

Play Audio có thể được dùng như công cụ cho AI Agent — phù hợp với kịch bản AI lựa chọn file âm thanh phù hợp dựa trên nội dung hội thoại với khách hàng.

Thiết lập

1. Kéo node When chat message received → nối tới AI Agent

2. Thêm Chat Model (OpenAI / Claude / Gemini)

3. Thêm Tool: chọn Alohub Tool

4. Cấu hình Alohub Tool:

Ví dụ chat

# Người dùng gõ:
"Gọi cho khách 0912345678 phát thông báo khuyến mãi"

# AI Agent tự động:
# 1. Nhận diện cần gọi Voice > Play Audio
# 2. Trích xuất phoneNumber = "0912345678"
# 3. Chọn URL file: https://cdn.alohub.vn/audio/promo.mp3
# 4. Gọi Alohub Tool → thực hiện cuộc gọi + phát file
# 5. Trả kết quả cho người dùng

Xử lý lỗi thường gặp

Khuyến nghị: Host file audio trên CDN của bạn hoặc dịch vụ object storage (AWS S3, Cloudflare R2, Bunny CDN) để đảm bảo tốc độ và độ ổn định cao nhất.

So sánh Play Audio vs Text to Speech

Tài nguyên liên quan

• Package n8n-nodes-alohub trên npm

• Cách sử dụng Click to Call trên n8n

• Cách sử dụng Text to Speech trên n8n

• Liên hệ Alohub để được hỗ trợ kỹ thuật