← Документация ConnectMachine

Нативная интеграция Zapier

Нативная интеграция ConnectMachine с Zapier

Создавайте мгновенные двусторонние сценарии без копирования URL вебхуков: подключитесь, выберите триггер или действие и опубликуйте Zap.

Доступно платным подписчикам, участникам организаций с лицензией и пользователям активной Premium-пробной версии.

01

Триггеры и действия

Доступно пять операций.

  • Новый контакт — contacts.created.
  • Обновленный контакт — contacts.updated.
  • Удаленный контакт — contacts.deleted с данными до удаления.
  • Создать контакт — человек или компания.
  • Обновить контакт — выбор из списка или собственный ID.
Важно

Удаленный контакт — только триггер. Действия удаления нет.

02

Подключение

Выберите ConnectMachine в Zapier и войдите через Google или код из email. Нужна существующая учетная запись с завершенным онбордингом. При отзыве доступа подключитесь заново.

03

Поля создания

Укажите тип, имя, фамилию, компанию, должность, заметки, сеть, основной email, телефон и сайт.

  • Для человека обязательно имя.
  • Для компании обязательно название.
  • Email и URL проверяются.
  • Без сети используется сеть по умолчанию.
04

Поля обновления

ID контакта обязателен. Выберите контакт или передайте ID из предыдущего шага.

  • Пустые значения не очищают поля в v1.
  • Email, телефон и сайт обновляют или создают основное значение.
  • Контакт и сеть должны принадлежать учетной записи.
05

Защита от циклов

Действия создают обычные триггеры с source=zapier и source_id.

Важно

Добавьте фильтр «source не равно zapier», если Zap записывает данные обратно.

06

Удаленные контакты

Одиночное, массовое, полное удаление и слияние запускают триггер. Zapier получает по одному элементу с deleted_at и снимком до удаления. Ручные вебхуки по-прежнему получают только ID.

07

Конфиденциальность и права

Zapier хранит OAuth-данные подключения. ConnectMachine хранит JTI и хэши refresh-токенов; браузер токены не хранит.

  • user:read — подпись подключения.
  • contacts:read — триггеры и списки.
  • contacts:write — создание и обновление.
  • webhooks:write — только подписки Zapier.
08

Для разработчиков

OAuth использует authorization code и S256 PKCE. Подписки: /api/v1/zapier/subscriptions, примеры: /trigger-samples, действия: POST и PATCH /api/v1/zapier/contacts.

09

Устранение неполадок

Premium-ошибка означает отсутствие подходящего плана. Ошибка прав требует повторного подключения. После ответа 410 включите Zap снова для новой подписки.