---
name: dograh-voice-agent
description: Self-host dograh — voice AI agent platform alternative Vapi/Retell. Visual workflow builder + telephony Twilio/Vonage. Cho phone reception 24/7.
---

# Skill: Dograh — Voice AI agent cho phone reception

## Skill này làm gì

Dograh là nền tảng **voice AI agent open-source** giúp bạn dựng nhân viên trực điện thoại AI tự gọi/nhận cuộc gọi 24/7 — thay thế Vapi/Retell. Có visual workflow builder kéo thả + tích hợp telephony Twilio/Vonage/Plivo. Bạn tự host trên VPS, làm chủ data cuộc gọi, không trả phí per-minute đắt.

## Khi nào dùng

- **Nhà hàng / quán café**: nhận đặt bàn 24/7, kể cả 11h đêm khi staff đã về
- **Spa / clinic / phòng khám**: lễ tân AI nhận lịch hẹn, nhắc lịch khách
- **Showroom / dịch vụ sửa chữa**: qualifier sàng lọc khách vãng lai, hỏi nhu cầu, chuyển sale
- **Trung tâm gia sư / dạy nghề**: tư vấn khóa học, gửi link đăng ký Zalo

## Lưu ý quan trọng cho Việt Nam

- **Twilio VN số +84 limit**: không bán DID +84 trực tiếp. Dùng số toll-free quốc tế (khách tốn cước) hoặc SIP trunk qua đối tác VN
- **Provider Việt nên dùng**: Stringee / FPT Foonet / VoIP24h / CMC Telecom
- **Vietnamese TTS chất lượng**: ElevenLabs / Google Cloud TTS hỗ trợ tiếng Việt nhưng tone máy. Muốn tự nhiên hơn → **FPT.AI Voice** hoặc **VBee Voice**
- **STT tiếng Việt**: OpenAI Whisper tốt nhưng chậm. **Google Cloud Speech** hoặc **FPT Speech** nhanh hơn realtime
- **Pháp lý**: ghi âm cuộc gọi VN phải báo khách "cuộc gọi được ghi âm" đầu cuộc

## Cách cài (Docker, 20 phút)

```bash
ssh root@your-vps-ip
curl -fsSL https://get.docker.com | sh
sudo apt install -y docker-compose-plugin

git clone https://github.com/dograh-hq/dograh.git
cd dograh

cp .env.example .env
nano .env
# Điền: OPENAI_API_KEY, TWILIO_ACCOUNT_SID, TWILIO_AUTH_TOKEN,
#       ELEVENLABS_API_KEY (TTS), DEEPGRAM_API_KEY (STT)
#       POSTGRES_PASSWORD, REDIS_PASSWORD, DOMAIN=voice.yourdomain.com

docker compose up -d
docker compose logs -f api
# Mở https://voice.yourdomain.com → đăng ký admin
```

Sau khi vào dashboard:
- **Workflows** → tạo workflow mới
- **Telephony** → connect Twilio (hoặc SIP trunk VN)
- **Voices** → chọn voice tiếng Việt ElevenLabs/Google

## Câu lệnh chủ đạo

```
Bạn là chuyên gia dựng voice AI agent. Tôi vừa cài Dograh self-hosted
cho spa "Hương Sen" ở Quận 7, TP.HCM. Hãy giúp tôi:

1. System prompt voice agent (tiếng Việt, xưng "Hương Sen xin nghe", 
   gọi khách "anh/chị") — tone thân thiện, chuyên nghiệp

2. Workflow 5 node Dograh:
   - Node 1: Greeting + thông báo ghi âm
   - Node 2: Hỏi nhu cầu (massage / facial / gội đầu dưỡng sinh)
   - Node 3: Hỏi giờ → check availability (Google Calendar)
   - Node 4: Xác nhận tên + SĐT → gửi SMS xác nhận
   - Node 5: Closing + cảm ơn

3. Edge cases handle:
   - Khách nói tiếng địa phương (miền Nam / miền Bắc)
   - Khách hỏi giá → trả lời theo bảng giá [paste bảng giá]
   - Khách muốn nói chuyện người thật → forward số 0909xxx
   - Khách gọi ngoài giờ (8h-22h) → đặt lịch hôm sau

4. Output JSON workflow để tôi import vào Dograh.
```

## Quyền hạn cần thiết

- **VPS root access** — Docker + mở port 443/5060 (SIP)
- **Twilio account** (hoặc SIP trunk VN) — số phone + Account SID/Auth Token
- **OpenAI API key** — GPT-4 conversation (~$0.5-2/cuộc gọi 5 phút)
- **ElevenLabs hoặc FPT.AI Voice key** — TTS tiếng Việt
- **Deepgram hoặc Google Speech API key** — STT realtime
- **Domain + SSL** — voice.yourdomain.com (Cloudflare free OK)
- **Google Calendar API** (tùy chọn) — sync lịch hẹn

## Mẹo dùng hiệu quả

1. **Test bằng số mobile cá nhân trước**, đừng gắn số hotline ngay — gọi 20-30 cuộc với tình huống khác nhau, chỉnh prompt + workflow đến 80% cuộc gọi xong gọn
2. **Cài transcript review hàng tuần** — đọc 10-20 cuộc gọi/tuần phát hiện chỗ AI nói cứng, edge case mới, update prompt
3. **Luôn có "escape hatch" về người thật** — câu "Em muốn nói chuyện với chị chủ" → forward số nhân viên ngay

---

**Tác giả:** Eroca Thanh · 2026-05-28
