Kết nối Make
Ứng dụng ReputeCast cho Make là một tích hợp Make dành cho newsletter, dùng trong các kịch bản (scenario): kịch bản khởi chạy 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 Make gọi đến hệ thống của bạn, và ReputeCast gọi đến địa chỉ webhook của Make cho các trình kích hoạt, 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 Make; 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ì”| Mô-đun | Loại | ReputeCast | Cần quyền |
|---|---|---|---|
| Watch Subscribed Contacts | Trình kích hoạt tức thì | contact.subscribed |
subscribers:view |
| Watch Unsubscribed Contacts | Trình kích hoạt tức thì | contact.unsubscribed |
subscribers:view |
| Watch Updated Contacts | Trình kích hoạt tức thì | contact.updated |
subscribers:view |
| Watch Form Submissions (mọi biểu mẫu, hoặc một biểu mẫu) | Trình kích hoạt tức thì | form.submitted |
subscribers:view |
| Watch Sent Campaigns | Trình kích hoạt tức thì | campaign.completed |
campaigns:view |
| Watch Transactional Bounces | Trình kích hoạt tức thì | message.bounced |
transactional:view |
| Create or Update a Contact | Hành động | Tên, trường tùy chỉnh, ngôn ngữ, thẻ, danh sách với xác nhận một bước hoặc hai bước | subscribers:create, subscribers:edit |
| Add a Contact to a List | Hành động | Xác nhận một bước hoặc hai bước | subscribers:edit |
| Add a Tag to a Contact | Hành động | Một hoặc nhiều thẻ | subscribers:edit |
| Record an Event | Hành động | Một sự kiện API kèm thuộc tính; khởi chạy tự động hóa | subscribers:edit |
| Send a Transactional Email | Hành động | Một mẫu đã xuất bản, một người nhận, các biến của mẫu và ngôn ngữ (không bắt buộc) | transactional:send (nhạy cảm) |
Danh sách thả xuống và trường động lấy dữ liệu từ không gian làm việc của bạn: danh sách, mẫu đã xuất bản, biểu mẫu đăng ký, trường tùy chỉnh và các biến của mẫu đã chọn. Payload của trình kích hoạt được liệt kê trong Sự kiện webhook.
Kết nối Make
Phần tiêu đề “Kết nối Make”-
Trong ReputeCast, mở Cài đặt, rồi Tích hợp, tìm Make trong nhóm Nền tảng tự động hóa và chọn Kết nối.
-
Chọn những gì Make đượ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 một kịch bản, thêm một mô-đun ReputeCast và chọn Create a connection với:
- Instance URL: địa chỉ ReputeCast của bạn, không có dấu gạch chéo ở cuối, ví dụ
https://reputecast.acme.io. - Key: khóa ở bước 2.
- Instance URL: địa chỉ ReputeCast của bạn, không có dấu gạch chéo ở cuối, ví dụ
-
Khi bạn lưu, Make kiểm tra kết nối (
GET /api/v1/integration). Hộp thoại kết nối của ReputeCast hiện “Make đã gọi lúc 14:31 · Kiểm tra kết nối · 200”, và kết nối ghi nhớ không gian làm việc của khóa.
Những điều nên biết
Phần tiêu đề “Những điều nên biết”- Trình kích hoạt. Tạo webhook của một trình kích hoạt trong Make sẽ đăng ký webhook đó trong ReputeCast, hiện ở chế độ chỉ xem với nhãn “Do Make quản lý” trong Cài đặt, rồi Webhook; xóa webhook trong Make sẽ gỡ nó khỏi ReputeCast. Nếu webhook bị xóa trong Make mà không tách (detach) trước, ReputeCast sẽ gỡ nó ở lần gửi tiếp theo, khi Make trả về 410 Gone.
- Chữ ký. ReputeCast ký mọi lần gửi (
X-ReputeCast-Signature), nhưng Make không cho ứng dụng tùy chỉnh đọc nội dung gốc (raw body) của webhook, nên ứng dụng không kiểm tra được chữ ký. Địa chỉ webhook của Make là một URL ngẫu nhiên dài: hãy giữ kín địa chỉ này. Xem Nhận webhook. - Tên kịch bản. Mọi lần gọi đều kèm header
X-ReputeCast-Workflowvới tên và ID của kịch bản, nên ReputeCast liệt kê được các kịch bản đang dùng nó. Lần gọi không có hai thông tin này được liệt kê là “Kịch bản không tên”. - 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ỉ đó. Những bundle như vậy kết thúc với DataError kèm lời giải thích của ReputeCast (“[email protected] left Beta Program on 2 Oct…”). Hãy thêm error handler Ignore hoặc Resume vào mô-đun để phần còn lại của kịch bản tiếp tục chạy, hoặc bật “Allow storing of incomplete executions”.
- Chống gửi trùng (idempotency). Send a Transactional Email nhận một 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ờ.
Khắc phục sự cố
Phần tiêu đề “Khắc phục sự cố”- InvalidAccessTokenError: khóa đã bị thu hồi hoặc hết hạn. Trong ReputeCast, chọn Kết nối lại và cập nhật kết nối trong Make.
- InvalidConfigurationError kèm “Change what Make can do in Settings › Integrations”: hành động này đang tắt với khóa. Hãy bật nó trong ReputeCast; khóa vẫn giữ nguyên.
- InvalidConfigurationError kèm “…take it over…”: người đã kết nối Make đã rời không gian làm việc. Chọn Tiếp quản.
- Sau khi xoay vòng khóa: khóa cũ vẫn dùng được trong 24 giờ. Hãy dán khóa mới vào kết nối trong khoảng thời gian đó.