Cách sử dụng Text to Speech trong Alohub Node trên n8n

Hướng dẫn chi tiết cách sử dụng tính năng Text to Speech (TTS) của Alohub trên n8n — thực hiện cuộc gọi ra và đọc nội dung văn bản cho khách hàng bằng giọng nói tự nhiên.

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

Text to Speech (TTS) là tính năng cho phép hệ thống Alohub thực hiện cuộc gọi ra số điện thoại khách hàng, sau đó tự động đọc nội dung văn bản bạn cung cấp bằng giọng nói tự nhiên. Phù hợp cho các kịch bản:

• Gửi OTP qua giọng nói (Voice OTP) — bảo mật hơn SMS

• Thông báo lịch hẹn, đơn hàng, giao dịch

• Nhắc nhở thanh toán, gia hạn dịch vụ

• Thông báo khẩn cấp cho khách hàng

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: Text to Speech

5. Điền các tham số bên dưới

Tham số đầu vào

Lưu ý: Hệ thống tự động tạo transactionId duy nhất cho mỗi cuộc gọi để theo dõi và đối soát. Bạn không cần nhập thủ công.

Mẹo viết nội dung TTS hiệu quả

• Ngắn gọn: 1-2 câu, dưới 200 ký tự để tránh khách hàng cúp máy giữa chừng

• Đọc số rõ ràng: tách số bằng khoảng trắng — ví dụ 4 8 2 6 1 5 thay vì 482615 để giọng đọc rõ từng chữ số

• Tránh ký tự đặc biệt: bỏ emoji, ký tự đặc biệt, viết tắt khó đọc

• Lặp thông tin quan trọng: với OTP nên đọc 2 lần để khách hàng kịp ghi nhận

API endpoint sử dụng

POST https://xapi.alohub.vn/v1/voice/text-to-speech

Node sẽ gọi tới endpoint này với body như sau:

{
  "phone": "0912345678",
  "otp": "Mã xác nhận của bạn là 482615",
  "transactionId": "ah_n8n_a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}

Response mẫu

Khi thành công:

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

Khi lỗi:

{
  "success": false,
  "httpStatus": 200,
  "transactionId": "ah_n8n_...",
  "error_code": "0",
  "error_message": "HỆ THỐNG OUTBOUND GẶP SỰ CỐ",
  "errorCode": "0",
  "errorMessage": "HỆ THỐNG OUTBOUND GẶP SỰ CỐ"
}

Ví dụ workflow thực tế

Workflow 1 — Voice OTP đơn giản

[Webhook Trigger] → [Code: Generate OTP] → [Alohub: Voice > Text to Speech]
                                              Phone Number: {{ $json.phone }}
                                              Text Content: Mã OTP của bạn là {{ $json.otp }}

Workflow 2 — Nhắc lịch hẹn từ Google Sheets

[Schedule Trigger 8AM] → [Google Sheets: Get Appointments] → [Alohub: Voice > Text to Speech]
                                                                Phone Number: {{ $json.customer_phone }}
                                                                Text Content: Xin chào {{ $json.name }},
                                                                lịch hẹn của bạn lúc {{ $json.time }}
                                                                ngày hôm nay.

Workflow 3 — Thông báo đơn hàng mới

[Webhook: New Order] → [Alohub: Voice > Text to Speech]
                          Phone Number: {{ $json.customer_phone }}
                          Text Content: Đơn hàng số {{ $json.order_id }}
                          đã được xác nhận. Cảm ơn quý khách.

Sử dụng với AI Agent

Text to Speech có thể được dùng như một công cụ cho AI Agent — AI sẽ tự sinh nội dung và gọi điện đọc cho khách hàng dựa trên ngữ cảnh hội thoại.

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 thông báo đơn hàng đã giao thành công"

# AI Agent tự động:
# 1. Nhận diện cần gọi Voice > Text to Speech
# 2. Trích xuất phoneNumber = "0912345678"
# 3. Sinh nội dung: "Xin chào, đơn hàng của quý khách đã được giao thành công."
# 4. Gọi Alohub Tool → thực hiện cuộc gọi + đọc nội dung
# 5. Trả kết quả cho người dùng

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

Mẹo: Bật Continue On Error trong Settings của node để workflow tiếp tục chạy kể cả khi cuộc gọi thất bại — output sẽ chứa đầy đủ thông tin lỗi để xử lý hoặc retry sau.

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

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