Подключение Marcomm к n8n, Zapier, Make и Power Automate
Инструменты автоматизации вызывают API Marcomm с личным ключом API, чтобы создавать пресс-релизы, записи блога, пресс-мероприятия и приглашения RSVP, а затем отправлять на согласование, публиковать и рассылать.
- 1В Marcomm подайте заявку на доступ к API в разделе Настройки → API. Ключи начинают работать после того, как команда Marcomm AI проверит и одобрит заявку.
- 2После одобрения создайте личный ключ на том же экране и отметьте нужные области (
content,content:write,distribution,approvals). Ключ показывается только один раз, при создании. - 3n8n: установите узел сообщества
n8n-nodes-marcommчерез Settings → Community Nodes → Install, создайте учётные данные Marcomm AI API и вставьте ключ. - 4Zapier: приложения Marcomm AI пока нет в публичном каталоге, поэтому добавьте его по ссылке-приглашению. Выберите Marcomm AI в Zap и вставьте ключ, когда Zapier попросит подключиться.
- 5Make: наше собственное приложение на проверке, поэтому используйте Make a request в HTTP-модуле. Добавьте конечную точку после
https://marcomm.works/api/v1и заголовокAuthorization: Bearer YOUR_API_KEY. - 6Power Automate: в
Custom connectors → New custom connector → Import an OpenAPI from URLвведитеhttps://marcomm.works/api/v1/openapi.json. Выберите безопасность через ключ API, имя параметра Authorization и расположениеHeader, а при подключении введитеBearerи затем ключ. - 7Сначала проверьте шаги чтения, а публикацию и рассылку опробуйте на черновике, прежде чем на них полагаться.
Публикацию и рассылку нельзя отменить. Записывать, отправлять и согласовывать могут только личные ключи, и эти действия записываются на имя человека, создавшего ключ.
Инструменты автоматизации действуют от имени и с правами человека, создавшего ключ. Они могут делать только то, что разрешает роль этого человека в рабочем пространстве, а правила согласования и отправки и месячный лимит рассылки действуют так же, как в приложении.
У каждого рабочего пространства есть лимиты вызовов в минуту и в день. При превышении лимита ответ просит повторить попытку чуть позже. Лимиты и использование смотрите в разделе Настройки → API.
Приложения n8n и Zapier добавляют к каждому запросу уникальный ключ, поэтому повторный запрос выполняется только один раз. Если Вы вызываете API сами из Make или Power Automate, добавьте заголовок Idempotency-Key, чтобы получить ту же защиту.
Подключение инструментов автоматизации не расходует кредиты Marcomm AI. Создание и рассылка не используют ИИ.
Частые вопросы
Проверьте, что заявка на доступ к API одобрена, что области ключа включают нужное действие и что срок действия ключа не истёк. Ключи не работают, пока рабочее пространство приостановлено из-за проблемы с оплатой.
Нет. Записывать, отправлять и согласовывать могут только личные ключи, чтобы в журнале было видно, кто это сделал.