Перейти к содержимому
MarcommAI

Подключение n8n с личным ключом API

Узел сообщества n8n-nodes-marcomm пишет пресс-релизы, записи блога, пресс-мероприятия и приглашения RSVP, отправляет их на согласование и публикует. Пакет ещё не опубликован.

  1. 1
    В Marcomm откройте Настройки → Интеграции → n8n, чтобы увидеть состояние и нужные значения.
    Настройки, Интеграции, n8n: состояние, шаги подключения, области для выбора и состояние доступа к API
    На странице n8n видно текущее состояние, шаги, значения для копирования и то, одобрен ли доступ к API для этого рабочего пространства.
  2. 2
    Откройте Настройки → API. Если у рабочего пространства ещё нет доступа к API, владелец или администратор заполняет Заявка на доступ к API и выбирает Отправить заявку.
  3. 3
    После одобрения откройте Создать ключ, выберите Личный ключ, отметьте нужные Области доступа и выберите Создать ключ. Сразу скопируйте ключ: он показывается только один раз.
  4. 4
    В n8n Cloud найдите Marcomm AI на панели узлов (если его нет, включите Verified Community Nodes в панели администратора и перезапустите экземпляр). В n8n на собственном сервере откройте Settings (Настройки), затем Community Nodes, затем Install (Установить) и введите n8n-nodes-marcomm.
  5. 5
    Создайте учётные данные Marcomm AI API, вставьте ключ в поле API Key (ключ API) и добавьте в workflow узел Marcomm AI или Marcomm AI Trigger.

Узлу-триггеру нужна область Контент, а при первой проверке он ничего не отправляет, чтобы не запускаться по старым элементам.

Узел работает с пресс-релизами, записями блога, пресс-мероприятиями, приглашениями RSVP и согласованиями, включая согласование, отклонение и список ожидающих согласований. Узел-триггер запускает workflow, когда пресс-релиз создан, отправлен на согласование или опубликован, когда запись блога создана или опубликована или когда создано пресс-мероприятие.

Области доступа определяют, что может ключ. Контент (content) читает пресс-релизы, записи блога и пресс-мероприятия, Создание контента (content:write) создаёт и правит черновики, Публикация и рассылка (distribution) публикует и отправляет по почте, а Согласования (approvals) отвечает за шаги согласования. Последние три работают только с типом Личный ключ, потому что действие записывается на человека, создавшего ключ. Ключ рабочего пространства может только читать, а каждый ключ действует с ролью и правами своего создателя.

Публикацию и рассылку нельзя отменить. API выполняет их только если в запросе есть confirm: true или заголовок Idempotency-Key, и ничего не публикует, отвечая 409, пока нужно согласование или материал запланирован либо находится под эмбарго. Повтор с тем же Idempotency-Key и тем же запросом в течение 24 часов возвращает первый результат, а не выполняется снова. Узел отправляет ключ идемпотентности при каждой записи, собранный из запуска, узла и элемента, и сам подтверждает публикацию и рассылку.

API доступен на тарифе Team и выше. Команда Marcomm AI проверяет каждую заявку, и ключи работают только после одобрения. Ключ может использовать только области, одобренные для рабочего пространства, а у каждого человека может быть до 10 ключей. По умолчанию рабочее пространство может отправлять 60 запросов в минуту и 10 000 в день; сверх этого API отвечает 429 с заголовком Retry-After. Чтобы повысить лимиты, используйте Нужны более высокие лимиты? в Настройки → API. Чтобы отключить n8n, выберите Отозвать рядом с ключом; системы, которые им пользуются, сразу теряют доступ.

Частые вопросы

Вызовите GET https://marcomm.works/api/v1/me с заголовком Authorization: Bearer и вашим ключом. Это работает с любым одобренным ключом независимо от его областей и возвращает рабочее пространство, имя ключа и его области.

Ключ не хранит, какой сервис его использует, поэтому Marcomm не отмечает карточку n8n как подключённую. В Настройки → API видно, когда каждый ключ использовался в последний раз.

Да, со встроенным узлом HTTP Request. Вызывайте https://marcomm.works/api/v1 с заголовком Authorization: Bearer и вашим ключом и добавляйте заголовок Idempotency-Key к каждой записи.

Интеграции