Kết nối n8n
n8n-nodes-reputecast là gói node n8n của ReputeCast, giúp bạn tự động hóa email với n8n: node ReputeCast Trigger
khởi chạy quy trình từ sự kiện của ReputeCast, còn node ReputeCast thêm liên hệ, gắn thẻ, ghi sự kiện và gửi email
giao dịch. Các node miễn phí, chạy được với n8n tự host (và n8n Cloud khi n8n đã xác minh chúng) và chỉ dùng API công
khai của ReputeCast.
Trước khi bắt đầu
Phần tiêu đề “Trước khi bắt đầu”- Bạn cần
integrations:manage(Chủ sở hữu hoặc Quản trị viên). Xem Kết nối các công cụ khác để biết khóa, trạng thái và nhật ký lần gọi hoạt động thế nào. - n8n chỉ cần truy cập được hệ thống của bạn để thực hiện hành động, nên n8n và ReputeCast có thể dùng chung một mạng nội bộ. Trình kích hoạt đi theo chiều ngược lại (ReputeCast gửi sự kiện đến n8n): xem n8n trong mạng nội bộ.
Node làm được gì
Phần tiêu đề “Node làm được gì”ReputeCast Trigger khởi chạy một quy trình khi:
| Sự kiện | Sự kiện ReputeCast | Cần quyền |
|---|---|---|
| Contact Subscribed | contact.subscribed |
subscribers:view |
| Contact Unsubscribed | contact.unsubscribed |
subscribers:view |
| Contact Updated | contact.updated |
subscribers:view |
| Form Submitted (mọi biểu mẫu, hoặc một biểu mẫu) | form.submitted |
subscribers:view |
| Campaign Sent | campaign.completed |
campaigns:view |
| Transactional Message Bounced | message.bounced |
transactional:view |
Kích hoạt (activate) quy trình sẽ tạo một webhook trong ReputeCast, hiện ở chế độ chỉ xem với nhãn “Do n8n quản lý” trong Cài đặt, rồi Webhook; hủy kích hoạt quy trình sẽ xóa webhook đó. Mọi lần gửi đều được đối chiếu với khóa bí mật để ký của webhook: lần gửi không khớp, hoặc cũ hơn 5 phút, bị từ chối và không khởi chạy gì.
ReputeCast làm được:
| Resource › Operation | Tác dụng | Cần quyền |
|---|---|---|
| Contact › Create or Update | Khớp theo email; đặt tên, trường tùy chỉnh, ngôn ngữ và thẻ; thêm vào danh sách với xác nhận một bước hoặc hai bước | subscribers:create, subscribers:edit |
| Contact › Add to List | Xác nhận một bước hoặc hai bước | subscribers:edit |
| Contact › Add Tag | Một hoặc nhiều thẻ | subscribers:edit |
| Event › Record | Một sự kiện API kèm thuộc tính; khởi chạy các tự động hóa đang chờ sự kiện đó | subscribers:edit |
| Transactional Email › Send | Một mẫu đã xuất bản, một người nhận, các biến của mẫu (ánh xạ từng trường) và ngôn ngữ (không bắt buộc) | transactional:send (nhạy cảm) |
AI Agent của n8n có thể dùng node ReputeCast làm công cụ (tool). Agent chỉ làm được những gì khóa cho phép, và việc gửi email giao dịch mặc định tắt khi bạn kết nối n8n.
Cài các node
Phần tiêu đề “Cài các node”Trong n8n, mở Settings › Community nodes › Install, nhập n8n-nodes-reputecast và xác nhận. n8n tự host cũng có
thể cài bằng npm install n8n-nodes-reputecast trong ~/.n8n/nodes. Trên n8n Cloud, các node xuất hiện trong bảng
node khi n8n đã xác minh chúng.
Kết nối n8n
Phần tiêu đề “Kết nối n8n”-
Trong ReputeCast, mở Cài đặt, rồi Tích hợp, tìm n8n trong nhóm Nền tảng tự động hóa và chọn Kết nối.
-
Chọn những gì n8n được làm. Hành động gửi email giao dịch mặc định tắt vì cần quyền nhạy cảm
transactional:send. Chọn Tạo khóa và sao chép khóa (rc_live_…); khóa chỉ hiện một lần. -
Trong n8n, thêm credential ReputeCast API với:
- Instance URL: địa chỉ ReputeCast của bạn, ví dụ
https://reputecast.acme.io. - Key: khóa ở bước 2.
- Instance URL: địa chỉ ReputeCast của bạn, ví dụ
-
Lưu lại. n8n kiểm tra kết nối (
GET /api/v1/integration), và hộp thoại kết nối của ReputeCast hiện lần gọi vừa đến. Credential ghi nhận khóa thuộc không gian làm việc nào và giữ thông tin đó.
n8n trong mạng nội bộ
Phần tiêu đề “n8n trong mạng nội bộ”Khi n8n chạy ở một địa chỉ nội bộ (ví dụ n8n.acme.internal), ReputeCast từ chối gửi sự kiện của trình kích hoạt đến
đó cho đến khi người vận hành cho phép webhook đến địa chỉ nội bộ bằng
webhooks.allow_private_networks (REPUTECAST_WEBHOOKS__ALLOW_PRIVATE_NETWORKS=true).
Hành động vẫn hoạt động trong cả hai trường hợp. Hãy đọc Bảo mật và gia cố hệ thống
trước khi bật tùy chọn này.
Những điều nên biết
Phần tiêu đề “Những điều nên biết”- Tên quy trình. Mọi lần gọi đều kèm
X-ReputeCast-Workflow: <workflow name>; id=<workflow ID>, nên ReputeCast liệt kê các quy trình đang dùng nó, cùng lần gọi và lỗi của từng quy trình, trên trang n8n. - Luôn giữ đúng sự đồng ý. ReputeCast không bao giờ thêm lại ai đó vào danh sách họ đã rời, không bao giờ thêm địa
chỉ bị chặn gửi và không gửi email giao dịch đến địa chỉ đó. Mục như vậy trả về
{ "skipped": true, "code": "unsubscribed", "reason": "[email protected] left Beta Program on 2 Oct…" }, và quy trình tiếp tục với các mục khác. - Lỗi bằng lời của ReputeCast. Các trường hợp bị từ chối khác làm node lỗi với câu báo lỗi của ReputeCast: thiếu một biến của mẫu, một hành động đang tắt (“Change what n8n can do in Settings › Integrations”), khóa đã bị thu hồi (“Reconnect n8n…”) hoặc khóa có chủ đã rời đi (“…take it over…”). Bật Continue On Fail để quy trình vẫn tiếp tục.
- Chống gửi trùng (idempotency). Transactional Email › Send nhận trường Idempotency Key không bắt buộc, chẳng hạn ID của sự kiện kích hoạt. ReputeCast không gửi thêm gì khi cùng giá trị đó đến lại trong vòng 24 giờ.
- Xoay vòng khóa trong ReputeCast giữ khóa cũ hoạt động thêm 24 giờ: hãy dán khóa mới vào credential trong khoảng thời gian đó.
Khắc phục sự cố
Phần tiêu đề “Khắc phục sự cố”- Trình kích hoạt không bao giờ chạy: kiểm tra quy trình đang active và webhook có trong danh sách ở Cài đặt, rồi Webhook. Với n8n ở địa chỉ nội bộ, xem n8n trong mạng nội bộ.
- “Reconnect n8n…”: khóa đã bị thu hồi hoặc hết hạn. Chọn Kết nối lại trong ReputeCast và dán khóa mới vào credential.
- “…take it over…”: người đã kết nối n8n đã rời đi. Chọn Tiếp quản.