Chuyển tới nội dung
MarcommAI

Kết nối n8n bằng khóa API cá nhân

Node cộng đồng n8n-nodes-marcomm viết thông cáo báo chí, bài blog, sự kiện báo chí và thư mời RSVP, gửi phê duyệt và đăng chúng. Gói này chưa được đăng.

  1. 1
    Trong Marcomm, vào Cài đặt → Tích hợp → n8n để xem trạng thái và các giá trị cần dùng.
    Cài đặt, Tích hợp, n8n, với trạng thái, các bước kết nối, phạm vi cần chọn và trạng thái quyền truy cập API
    Trang n8n 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.
  2. 2
    Mở 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ý.
  3. 3
    Sau 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.
  4. 4
    Trong n8n Cloud, tìm Marcomm AI ở bảng node (nếu chưa thấy, bật Verified Community Nodes trong bảng quản trị rồi khởi động lại phiên bản). Với n8n tự lưu trữ, mở Settings (Cài đặt), rồi Community Nodes, rồi Install (Cài đặt gói), và nhập n8n-nodes-marcomm.
  5. 5
    Tạo thông tin xác thực Marcomm AI API, dán khóa vào API Key (khóa API), rồi thêm node Marcomm AI hoặc Marcomm AI Trigger vào workflow.

Node trigger cần phạm vi Nội dung và không gửi gì ở lần kiểm tra đầu tiên, nên không phát lại các mục cũ.

Node bao gồm thông cáo báo chí, bài blog, sự kiện báo chí, thư mời RSVP và phê duyệt, gồm phê duyệt, từ chối và danh sách phê duyệt đang chờ. Node trigger khởi chạy workflow khi thông cáo báo chí được tạo, gửi phê duyệt hoặc đăng, khi bài blog được tạo hoặc đăng, hoặc khi sự kiện báo chí được tạo.

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. Node gửi khóa idempotency ở mỗi lần ghi, tạo từ lần chạy, node và mục, đồng thời tự xác nhận các thao tác đăng và gửi.

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 n8n, 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/me với header Authorization: Bearer kè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ẻ n8n là đã kết nối. Cài đặt → API cho biết lần cuối mỗi khóa được dùng.

Có, bằng node tích hợp sẵn HTTP Request. Gọi https://marcomm.works/api/v1 với header Authorization: Bearer kèm khóa của bạn, và thêm header Idempotency-Key vào mỗi lần ghi.

Tích hợp