Kết nối Zapier
Ứng dụng ReputeCast cho Zapier là một tích hợp Zapier dành cho newsletter: nó khởi chạy Zap từ sự kiện của ReputeCast, hoặc thêm liên hệ, gắn thẻ, ghi sự kiện và gửi email giao dịch từ các ứng dụng khác của bạn. Ứng dụng miễn phí và chỉ dùng API công khai của ReputeCast, với một khóa chỉ làm được những gì bạn cho phép.
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. - Máy chủ của Zapier gọi đến hệ thống của bạn, nên ReputeCast phải truy cập được từ internet qua HTTPS. Hệ thống nằm trong mạng nội bộ không dùng được Zapier; khi đó hãy dùng n8n trong cùng mạng.
Ứng dụng làm được gì
Phần tiêu đề “Ứng dụng làm được gì”| Trình kích hoạt | 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 (có thể chọn một biểu mẫu) | form.submitted |
subscribers:view |
| Campaign Sent | campaign.completed |
campaigns:view |
| Transactional Message Bounced | message.bounced |
transactional:view |
| Hành động | Tác dụng | Cần quyền |
|---|---|---|
| Create or Update Contact | 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 |
| Add Contact to List | Xác nhận một bước hoặc hai bước | subscribers:edit |
| Add Tag to Contact | Một hoặc nhiều thẻ | subscribers:edit |
| Record Event | 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 |
| Send Transactional Email | Một mẫu đã xuất bản, một người nhận, dữ liệu cho mẫu và ngôn ngữ (không bắt buộc) | transactional:send (nhạy cảm) |
Các trình kích hoạt chạy tức thì. Bật một Zap sẽ tạo một webhook trong ReputeCast, hiện ở chế độ chỉ xem với nhãn “Do Zapier quản lý” trong Cài đặt, rồi Webhook; tắt Zap sẽ xóa webhook đó. Mọi lần gửi đều được ký, và ứng dụng bỏ qua lần gửi có chữ ký không khớp với khóa bí mật webhook của Zap hoặc cũ hơn 5 phút. Payload của các sự kiện được liệt kê trong Sự kiện webhook.
Kết nối Zapier
Phần tiêu đề “Kết nối Zapier”-
Trong ReputeCast, mở Cài đặt, rồi Tích hợp, tìm Zapier trong nhóm Nền tảng tự động hóa và chọn Kết nối.
-
Chọn những gì Zapier đượ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ỉ bật khi các Zap của bạn gửi email giao dịch. Chọn Tạo khóa và sao chép khóa (rc_live_…). Khóa chỉ hiện một lần. -
Trong Zapier, thêm một bước ReputeCast và tạo kết nối với:
- Instance URL: địa chỉ ReputeCast của bạn, ví dụ
https://reputecast.acme.io. - Key: khóa ở bước 2.
Kết nối sẽ hỏi ReputeCast xem khóa thuộc không gian làm việc nào, nên bạn không cần nhập gì thêm.
- Instance URL: địa chỉ ReputeCast của bạn, ví dụ
-
Quay lại ReputeCast, hộp thoại kết nối hiện lần gọi vừa đến (“Zapier đã gọi lúc 14:31 · Kiểm tra kết nối · 200”). Chọn Xong.
Những điều nên biết
Phần tiêu đề “Những điều nên biết”- Đặt tên cho Zap. Zapier cho ứng dụng biết ID của Zap nhưng không cho biết tên, nên mỗi bước ReputeCast có trường
Zap Name không bắt buộc. Nhập tên Zap vào đó để phân biệt các Zap trên trang Zapier của ReputeCast; nếu bỏ trống,
Zap được liệt kê là “Zap không tên”. Ứng dụng gửi cả tên lẫn ID trong header
X-ReputeCast-Workflow. - 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 bao giờ gửi email giao dịch đến địa chỉ đó. Những lần chạy như vậy kết thúc ở trạng thái Halted kèm lý do của ReputeCast (“[email protected] left Beta Program on 2 Oct…”). Chúng không bị tính là lỗi, nên Zap vẫn chạy cho mọi người khác.
- Lỗi bằng lời của ReputeCast. Các trường hợp bị từ chối khác hiện câu báo lỗi của ReputeCast, ví dụ thiếu một biến của mẫu (“payment-failed v1 needs amount_due.”) hoặc một hành động đang tắt (“Change what Zapier can do in Settings › Integrations”).
- Chống gửi trùng (idempotency). Send Transactional Email 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. Khi cùng một Zap chạy lại với cùng giá trị đó trong vòng 24 giờ, ReputeCast không gửi thêm thư nào. Xem Gửi email giao dịch bằng API.
- Ngôn ngữ. Trường Language của Send Transactional Email chọn một phiên bản ngôn ngữ của mẫu (
es,de…). Nếu bỏ trống, ReputeCast dùng ngôn ngữ của liên hệ, rồi đến ngôn ngữ dự phòng của không gian làm việc. - Xoay vòng khóa trong ReputeCast giữ khóa cũ hoạt động thêm 24 giờ, để bạn dán khóa mới mà không có lần chạy nào bị lỗi.
Khắc phục sự cố
Phần tiêu đề “Khắc phục sự cố”- Zapier yêu cầu bạn kết nối lại: khóa đã bị thu hồi hoặc hết hạn. Trong ReputeCast, chọn Kết nối lại trên trang Zapier và dán khóa mới vào kết nối Zapier.
- “…take it over in Settings › Integrations › Zapier”: người đã kết nối Zapier đã rời không gian làm việc. Chọn Tiếp quản; khóa vẫn giữ nguyên.
- Hộp thoại kết nối báo hệ thống của bạn không truy cập được: Zapier không truy cập được URL công khai của ReputeCast. Xem Reverse proxy và TLS.
- Trình kích hoạt không bao giờ chạy: kiểm tra Zap đang bật và webhook có trong danh sách ở Cài đặt, rồi Webhook. Các lần gửi lỗi được thử lại, rồi được giữ lại để phát lại; xem Nhận webhook.