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

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

Приложение Marcomm AI для Zapier запускает Zap по пресс-релизам, записям блога и пресс-мероприятиям, а также создаёт, публикует и рассылает их. Доступно по приглашению.

  1. 1
    В Marcomm откройте Настройки → Интеграции → Zapier, чтобы увидеть состояние и нужные значения.
    Настройки, Интеграции, Zapier: состояние, шаги подключения, области для выбора и состояние доступа к API
    На странице Zapier видно текущее состояние, шаги, значения для копирования и то, одобрен ли доступ к API для этого рабочего пространства.
  2. 2
    Откройте Настройки → API. Если у рабочего пространства ещё нет доступа к API, владелец или администратор заполняет Заявка на доступ к API и выбирает Отправить заявку.
  3. 3
    После одобрения откройте Создать ключ, выберите Личный ключ, отметьте нужные Области доступа и выберите Создать ключ. Сразу скопируйте ключ: он показывается только один раз.
  4. 4
    Откройте ссылку-приглашение от Marcomm AI и добавьте приложение Marcomm AI в свою учётную запись Zapier.
  5. 5
    Создайте Zap, выберите Marcomm AI как триггер или действие и вставьте ключ в поле API Key (ключ API), когда Zapier попросит подключиться.

Сначала проверьте шаги публикации и рассылки на черновике: их нельзя отменить.

Приложения пока нет в публичном каталоге Zapier, поэтому нужна ссылка-приглашение от Marcomm AI. В нём семь триггеров: New Press Release, Press Release Approval Requested, Press Release Published, New Blog Post, Blog Post Published, New Press Event и RSVP Invite Updated. Действия создают, обновляют, отправляют на согласование, публикуют и рассылают пресс-релизы, создают и публикуют записи блога, создают пресс-мероприятия, а также создают, заполняют и отправляют приглашения RSVP. Два поиска находят пресс-релиз или запись блога.

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

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

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

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

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

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

Нет. Приложение Zapier может запросить согласование, а решение принимает согласующий в Marcomm. Через API согласовать или отклонить может личный ключ с областью Согласования.

Интеграции