Kết nối Zapier bằng khóa API cá nhân
Với ứng dụng Marcomm AI cho Zapier, bạn khởi chạy Zap từ thông cáo báo chí, bài blog và sự kiện báo chí, đồng thời tạo, đăng và gửi chúng. Ứng dụng chỉ dùng được khi có lời mời.
- 1Trong Marcomm, vào Cài đặt → Tích hợp → Zapier để xem trạng thái và các giá trị cần dùng.

Trang Zapier cho thấy trạng thái hiện tại, các bước, giá trị cần sao chép và việc quyền truy cập API đã được duyệt cho không gian làm việc này hay chưa. - 2Mở Cài đặt → API. Nếu không gian làm việc chưa có quyền truy cập API, chủ sở hữu hoặc quản trị viên điền Đăng ký quyền truy cập API rồi chọn Gửi đơn đăng ký.
- 3Sau khi được duyệt, mở Tạo khóa, chọn Khóa cá nhân, đánh dấu các Phạm vi cần thiết rồi chọn Tạo khóa. Sao chép khóa ngay vì khóa chỉ hiện một lần.
- 4Mở liên kết mời từ Marcomm AI và thêm ứng dụng Marcomm AI vào tài khoản Zapier của bạn.
- 5Tạo một Zap, chọn Marcomm AI làm trigger hoặc hành động, rồi dán khóa vào API Key (khóa API) khi Zapier yêu cầu kết nối.
Hãy thử các bước đăng và gửi với bản nháp trước, vì chúng không thể hoàn tác.
Ứng dụng chưa có trong thư mục công khai của Zapier, nên bạn cần liên kết mời từ Marcomm AI. Ứng dụng có bảy trigger: New Press Release, Press Release Approval Requested, Press Release Published, New Blog Post, Blog Post Published, New Press Event và RSVP Invite Updated. Các hành động tạo, cập nhật, gửi phê duyệt, đăng và gửi thông cáo báo chí, tạo và đăng bài blog, tạo sự kiện báo chí, cũng như tạo, bổ sung người nhận và gửi thư mời RSVP. Hai thao tác tìm kiếm tìm thông cáo báo chí hoặc bài blog.
Phạm vi quyết định khóa được làm gì. Nội dung (content) đọc thông cáo báo chí, bài blog và sự kiện báo chí, Viết nội dung (content:write) tạo và sửa bản nháp, Xuất bản và gửi (distribution) đăng và gửi qua email, còn Phê duyệt (approvals) lo các bước phê duyệt. Ba phạm vi cuối chỉ dùng được với Khóa cá nhân, vì thao tác được ghi dưới tên người tạo khóa. Khóa không gian làm việc chỉ đọc được, và mọi khóa đều hoạt động theo vai trò và quyền của người tạo.
Đăng và gửi không thể hoàn tác. API chỉ thực hiện khi yêu cầu có confirm: true hoặc header Idempotency-Key, và không đăng gì mà trả về 409 khi vẫn cần phê duyệt hoặc nội dung đã được lên lịch hay đang trong thời gian cấm đăng. Gửi lại với cùng Idempotency-Key và cùng yêu cầu sẽ trả về kết quả đầu tiên trong 24 giờ thay vì chạy lại. Mỗi bước ghi gửi một khóa idempotency tạo từ Zap và dữ liệu đầu vào. Nếu Zap cần cố ý lặp lại đúng bước đó trong vòng 24 giờ, hãy nhập vào Repeat Key một giá trị thay đổi ở mỗi lần chạy.
API có trên gói Team trở lên. Đội ngũ Marcomm AI xem xét từng đơn đăng ký, và khóa chỉ hoạt động sau khi được duyệt. Khóa chỉ dùng được các phạm vi đã duyệt cho không gian làm việc, và mỗi người có thể có tối đa 10 khóa. Mặc định, một không gian làm việc được gửi 60 yêu cầu mỗi phút và 10.000 yêu cầu mỗi ngày; vượt quá, API trả về 429 kèm header Retry-After. Để nâng giới hạn, dùng Cần giới hạn cao hơn? trong Cài đặt → API. Để ngắt Zapier, chọn Thu hồi cạnh khóa; các hệ thống đang dùng khóa sẽ mất quyền truy cập ngay.
Câu hỏi thường gặp
Gọi
GET https://marcomm.works/api/v1/mevới headerAuthorization: Bearerkèm khóa của bạn. Lệnh này dùng được với mọi khóa đã duyệt, bất kể phạm vi, và trả về không gian làm việc, tên khóa và các phạm vi của khóa.Khóa không ghi lại dịch vụ nào đang dùng nó, nên Marcomm không đánh dấu thẻ Zapier là đã kết nối. Cài đặt → API cho biết lần cuối mỗi khóa được dùng.
Không. Ứng dụng Zapier có thể gửi yêu cầu phê duyệt, còn người phê duyệt quyết định trong Marcomm. Qua API, khóa cá nhân có phạm vi Phê duyệt có thể phê duyệt hoặc từ chối.