ZaloReminder Node - Tạo và quản lý nhắc hẹn Zalo trong n8n

Tổng quan

ZaloReminder là node giúp bạn tạo và quản lý các lịch hẹn (appointment reminders) ngay trong cuộc hội thoại Zalo. Tính năng này cực kỳ hữu ích cho các doanh nghiệp dịch vụ, phòng khám, spa hoặc đội sales để nhắc nhở khách hàng về lịch hẹn sắp tới.

Use Cases chính

• 📅 Nhắc lịch khám bệnh, spa, làm đẹp
• 💼 Nhắc lịch họp, phỏng vấn
• 💰 Nhắc hạn thanh toán hóa đơn
• 🎉 Nhắc sự kiện, sinh nhật
• 🔄 Tự động nhắc lại (recurring reminder)

---

Operations

Node hỗ trợ 5 operations chính:

Operation	Mô tả
Tạo Nhắc Hẹn	Tạo lịch hẹn mới với thông tin chi tiết
Lấy Danh Sách	Xem các lịch hẹn sắp tới
Cập Nhật	Thay đổi thời gian hoặc nội dung
Xóa	Hủy lịch hẹn
Đánh Dấu Xong	Hoàn tất lịch hẹn

---

Resource: Tạo Nhắc Hẹn

Tạo một lịch hẹn mới trong đoạn chat với người dùng hoặc nhóm.

Parameters

Parameter	Type	Bắt buộc	Mô tả
To ID	String	✅	User ID hoặc Group ID nhận nhắc hẹn
Tiêu Đề	String	✅	Tên lịch hẹn (VD: Khám răng)
Thời Gian	DateTime	✅	Thời điểm diễn ra sự kiện
Lặp Lại	Dropdown	❌	Không lặp / Hàng ngày / Hàng tuần / Hàng tháng
Ghi Chú	String	❌	Thông tin chi tiết thêm

Example

Tạo lịch hẹn phỏng vấn:

{
  "toId": "123456789",
  "title": "Phỏng vấn Senior Dev",
  "time": "2024-02-20T14:00:00Z",
  "note": "Mang theo CV và Portfolio",
  "repeat": "none"
}

Output:

{
  "reminderId": "rem_12345",
  "createdTime": 1704067200000,
  "status": "active"
}

---

Resource: Quản Lý Nhắc Hẹn

1. Lấy Danh Sách

Lấy các nhắc hẹn của một người dùng hoặc trong một nhóm.

Parameters:

• To ID: ID người dùng hoặc nhóm
• Time Range: (Optional) From Date - To Date

2. Cập Nhật

Thay đổi thông tin lịch hẹn khi có sự thay đổi.

Parameters:

• Reminder ID: ID lịch hẹn cần sửa
• Thông tin mới: Tiêu đề, Thời gian, Ghi chú...

3. Xóa / Hủy

Hủy lịch hẹn nếu khách hàng cancel.

Parameters:

• Reminder ID: ID lịch hẹn cần xóa

---

Common Use Cases

1. Auto-booking Confirmation

Tự động tạo nhắc hẹn khi khách hàng đặt lịch qua form:

Workflow:

1. Trigger: Webhook (Booking Form Submit)
2. Format Date: Chuyển đổi định dạng ngày giờ
3. ZaloUser: Tìm Zalo ID từ số điện thoại
4. ZaloReminder: Tạo nhắc hẹn "Lịch khám nha khoa"
5. ZaloSendMessage: "Đã đặt lịch thành công! Zalo sẽ nhắc bạn trước giờ hẹn."

2. Payment Reminder (Recurring)

Nhắc thanh toán phí dịch vụ hàng tháng:

Workflow:

1. Trigger: Manual Setup
2. ZaloReminder: Tạo nhắc hẹn "Thanh toán Internet"
   • Time: Ngày 5 hàng tháng
   • Repeat: Monthly
   • Note: "Số tiền: 250.000đ"

3. Meeting Scheduler Integration

Đồng bộ Google Calendar sang Zalo Reminder:

Workflow:

1. Trigger: Google Calendar Event Created
2. IF: Event Title contains "Zalo Meeting"
3. ZaloReminder: Tạo nhắc hẹn tương ứng trong nhóm dự án

---

Troubleshooting

❌ Lỗi: "Invalid time format"

Nguyên nhân: Định dạng ngày giờ không đúng chuẩn ISO 8601 hoặc thời gian đã qua.

Giải pháp:

• Sử dụng node Date & Time của n8n để format.
• Định dạng chuẩn: YYYY-MM-DDTHH:mm:ssZ
• Đảm bảo thời gian đặt phải lớn hơn thời gian hiện tại ít nhất 5 phút.

❌ Lỗi: "Permission denied"

Nguyên nhân: Không thể tạo nhắc hẹn cho người lạ (chưa kết bạn hoặc chưa từng chat).

Giải pháp:

• Gửi tin nhắn chào trước.
• Đảm bảo user đã tương tác với OA/Tài khoản cá nhân.

---

Tips & Best Practices

---

Bước tiếp theo

Trong bài tiếp theo, chúng ta sẽ tìm hiểu về ZaloLoginByQr Node - node đặc biệt giúp tự động hóa quy trình đăng nhập và refresh cookie mà không cần thao tác thủ công phức tạp.