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 снова для новой подписки.