Báo giao dịch vào Lark, Telegram, Slack, Discord

Bốn kênh chat này nhận tin một chiều từ Dòng Tiền Pro mỗi khi có giao dịch đã xác thực khớp quy tắc của bạn. Mỗi kênh kết nối bằng một hoặc hai bước: dán địa chỉ hoặc token, hoặc cấp quyền qua OAuth. Nhãn Đã xác thực là xác thực nguồn, không phải ngân hàng xác nhận quyết toán.

Kết nối chung

1. Vào Tích hợp, bấm thêm tích hợp và chọn Lark, Telegram, Slack hoặc Discord.

2. Làm theo mục riêng của từng kênh bên dưới để lấy địa chỉ hoặc token và dán vào.

3. Tạo quy tắc: chọn sự kiện, bộ lọc, mẫu tin và nơi nhận.

4. Bấm Gửi thử. Tin thử mang nhãn [TEST], không phát sự kiện nghiệp vụ và hiện kết quả ngay.

5. Bật tích hợp. Trạng thái chuyển sang hoạt động.

Lark

Dòng Tiền Pro dùng Custom Bot của Lark. Trong nhóm Lark, thêm bot tuỳ chỉnh và sao chép địa chỉ webhook của bot rồi dán vào Dòng Tiền Pro.

• Nếu bot bật từ khoá bảo mật, nhập đúng từ khoá đó vào trường Từ khoá bảo mật để tin không bị từ chối.
• Nếu bot dùng chữ ký, nhập khoá ký tuỳ chọn; Dòng Tiền Pro ký mỗi tin bằng dấu thời gian.
• Nếu bot giới hạn địa chỉ IP, chọn đường gửi qua IP tĩnh và thêm các địa chỉ IP hiển thị vào danh sách cho phép của bot (Lark cho tối đa 10 địa chỉ).

Telegram

Có hai cách; mặc định là bot dùng chung.

• Bot dùng chung @DongTienProBot: bấm liên kết kết nối, Telegram mở bot, bạn bấm Start trong nhóm hoặc cuộc trò chuyện muốn nhận tin. Dòng Tiền Pro lưu mã nhóm đó. Bạn không phải tạo bot.
• Bot riêng: tạo bot bằng @BotFather, dán token, thêm bot vào nhóm rồi gửi một tin để Dòng Tiền Pro nhận mã nhóm.

Slack và Discord

Với Slack, tạo một Incoming Webhook cho kênh cần nhận tin, hoặc cấp quyền qua OAuth nếu giao diện hiển thị. Với Discord, vào cài đặt kênh, mục tích hợp, tạo Webhook và sao chép địa chỉ. Dán địa chỉ vào Dòng Tiền Pro. Tên mục thay đổi theo phiên bản ứng dụng.

Quy tắc và bộ lọc

Một tích hợp có thể có nhiều quy tắc, mỗi quy tắc gồm:

Thành phần	Giá trị
Sự kiện	Mặc định là giao dịch được xác thực
Bộ lọc	Tài khoản, chiều tiền, khoảng số tiền, mã số thuế, chỉ giao dịch có mã DTP, mẫu mã đơn
Giờ yên lặng	Khoảng giờ không gửi tin
Nơi nhận	Kênh hoặc luồng chat

Giao dịch Tạm tính chỉ được gửi khi bạn bật tuỳ chọn gồm cả giao dịch tạm tính, và tin hiện nhãn Tạm tính. Giao dịch cách ly không bao giờ được gửi. Mẫu mã đơn riêng dùng ở bộ lọc được tạo ở Cài đặt › Thu tiền › Mẫu mã đơn, xem thu tiền VietQR.

Mỗi tích hợp được giới hạn tốc độ theo quy định của nền tảng chat. Khi một quy tắc có hơn 5 giao dịch trong 10 giây, 5 giao dịch đầu gửi như thường, các giao dịch sau được gộp thành một tin tổng hợp (số giao dịch, tổng tiền vào trừ tiền ra, tài khoản) gửi khi hết 10 giây; nhật ký ghi các giao dịch đã gộp ở trạng thái throttled.

Mẫu tin

Mẫu dùng các biến sau, viết trong cặp ngoặc nhọn kép:

{{amount}} {{direction_label}} {{account_label}} {{counterparty_masked}}
{{memo}} {{status_label}} {{occurred_at_vn}} {{link}}

Biến {{balance_after}} chỉ hiện khi quy tắc bật tuỳ chọn số dư và giao dịch có số dư; nếu không, biến để trống. Mẫu mặc định:

Tiền vào +4.500.000 ₫ · ACB •••4521 · NGUYEN T*** NHUNG · DTP7K2M9N · Đã xác thực

Bạn có thể tạo mẫu riêng cho từng quy tắc, xem trước bằng giao dịch mẫu hoặc giao dịch thật gần nhất đã che. Số tài khoản đầy đủ và OTP không bao giờ có trong tin.

Lỗi, gửi lại và nhật ký

Khi nền tảng chat báo lỗi tạm thời, Dòng Tiền Pro thử lại tối đa 6 lần trong 24 giờ, với khoảng chờ 10 giây, 1 phút, 5 phút, 30 phút, 2 giờ và 6 giờ; nếu nền tảng yêu cầu chờ lâu hơn thì theo yêu cầu đó. Lỗi cố định như 401, 403 hoặc địa chỉ bị xoá làm tích hợp chuyển sang trạng thái lỗi ngay và không thử lại. Khi hết lượt, bạn nhận thông báo.

Nhật ký giao hàng giữ 30 ngày. Bạn lọc theo trạng thái, mở chi tiết và Gửi lại một hoặc nhiều tin lỗi, tạm dừng, tiếp tục hoặc thu hồi tích hợp. Xoay token hoặc địa chỉ cần xác thực lại.

Địa chỉ webhook là bí mật

Ai có địa chỉ webhook của nhóm chat đều gửi được tin vào nhóm. Không dán địa chỉ này vào nơi công khai; nếu lộ, xoay hoặc xoá webhook ở nền tảng chat rồi cập nhật lại.