Перейти к содержимому
Документация ConnectMachine

Руководство по интеграции с Zapier

Подключите ConnectMachine к Zapier

Отправляйте каждый новый и изменённый контакт из ConnectMachine прямо в приложения, которыми вы уже пользуетесь, и записывайте контакты обратно. В руководстве — как подключить аккаунт, какие есть триггеры и действия, какие поля можно передавать и как справиться с проблемами, на которые натыкаются чаще всего.

Триггеры
New, Updated и Deleted Contact
Действия
Create Contact и Update Contact
Скорость триггера
Мгновенно. Без задержки опроса
Вход
Без пароля и API-ключа

Обновлено в августе 2026

01

Перед началом

Приложение ConnectMachine в Zapier даёт три триггера и два действия для ваших контактов. Триггеры срабатывают мгновенно: Zap запускается через считаные секунды после изменения контакта, а не ждёт очередного опроса.

Что понадобится

  • Аккаунт ConnectMachine с завершённым онбордингом.
  • Доступ к Zapier на вашем тарифе ConnectMachine: платная подписка, место в лицензии организации или активный пробный период Premium.
  • Аккаунт Zapier. На бесплатном тарифе Zapier доступно 100 задач в месяц — этого хватает для большинства одношаговых Zap.

02

Подключите аккаунт

ConnectMachine подключается к Zapier один раз. Дальше любой ваш Zap использует то же подключение.

  1. 1В Zapier создайте Zap и найдите ConnectMachine.
  2. 2Выберите триггер или действие ConnectMachine и нажмите Sign in.
  3. 3ConnectMachine откроет страницу согласия. Войдите через Google или по коду, отправленному на почту. Пароль спрашивать не будут.
  4. 4Проверьте, какие разрешения вы выдаёте, и нажмите Approve and continue.
  5. 5Zapier вернёт вас в редактор Zap с подключённым и готовым к работе аккаунтом ConnectMachine.
Страница входа ConnectMachine для Zapier: одноразовый код на почту или телефон и вход через Google.
Войдите в аккаунт ConnectMachine, чтобы начать подключение. Разрешения, которые запрашивает Zapier, перечислены ниже.

Что вы разрешаете

РазрешениеЗачем это нужно
Чтение данных аккаунтаПодписывает подключение в Zapier, чтобы вы различали несколько аккаунтов.
Чтение контактов и сетейЗагружает примеры записей для тестов и заполняет выпадающие списки контактов и сетей.
Создание и изменение контактовИспользуется, только когда Zap выполняет действие Create Contact или Update Contact.
Управление собственными подписками на триггерыПозволяет Zapier включать и выключать ваши триггеры. Zapier трогает только созданные им подписки.
i

Как отключить

Чтобы отозвать доступ, откройте My Apps в Zapier, найдите ConnectMachine и удалите подключение. Zap, которые его используют, перестанут работать, пока вы не подключитесь снова. Подключайтесь тем же способом, если сменился тариф или подключение закрыла проверка безопасности.

03

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

Триггеры запускают Zap, когда что-то происходит в ConnectMachine. Действия позволяют другому приложению записывать данные в ConnectMachine.

Триггеры

Триггер

New Contact

В ваш аккаунт ConnectMachine добавлен контакт — неважно, отсканировали вы визитку, ввели данные вручную или импортировали их.

Триггер

Updated Contact

Изменилась любая деталь существующего контакта. Zapier получает текущие значения контакта целиком, а не только изменённое поле.

Триггер

Deleted Contact

Контакт удалён. Сработать могут одиночное удаление, массовое, удаление всех контактов и слияние. Zapier получает по одному элементу на каждый удалённый контакт, включая данные, сохранённые прямо перед удалением, — чтобы вы нашли нужную запись в другом приложении.

Действия

Действие

Create Contact

Добавляет в ConnectMachine контакт-человека или контакт-компанию из другого приложения. Поле First Name обязательно для каждого нового контакта. Company заполнять необязательно, его удобно использовать вместе с Contact Type в значении Business. Если оставить Network пустым, контакт попадёт в сеть по умолчанию.

Действие

Update Contact

Меняет поля уже существующего контакта. Contact ID обязателен: выберите недавний контакт из списка или укажите Custom, чтобы передать ID из предыдущего шага Zap.

i

Полезно знать

Deleted Contact — только триггер. Действия Delete Contact нет, поэтому Zap никогда не удалит контакт в ConnectMachine за вас.

04

Соберите первый Zap

Разберём, как держать Google Sheets и ConnectMachine в согласии друг с другом. Та же схема работает с любым приложением, которое подключает Zapier.

1

Выберите триггер

Добавьте ConnectMachine первым шагом и выберите событие-триггер. В примере это Updated Contact, поэтому Zap запускается каждый раз, когда меняются данные контакта.

Редактор Zapier с настройкой триггера ConnectMachine Updated Contact; подключённый аккаунт скрыт.
2

Загрузите пример записи

Нажмите Test, чтобы загрузить пример контакта. Примеры позволяют сопоставить поля до того, как придёт настоящее событие. Если ничего не загрузилось, добавьте или измените контакт в ConnectMachine и повторите тест.

Редактор Zapier: тест триггера ConnectMachine с доступным примером записи контакта.
3

Посмотрите, что отдаёт триггер

Разверните пример, чтобы увидеть все поля, доступные для следующих шагов: имена, компанию, должность, основные почту и телефон, значения с метками, адреса, теги и отметки времени.

Редактор Zapier: выходные поля триггера ConnectMachine для примера контакта.
4

Передайте поля в следующее приложение

Добавьте второе приложение и перетащите в него поля ConnectMachine. Здесь строка Google Sheets передаётся в действие Update Contact, поэтому правки в таблице возвращаются в ConnectMachine.

Редактор Zapier: шаг Google Sheets, сопоставленный с действием ConnectMachine Update Contact и данными примера контакта.
5

Обработайте удаления

Используйте триггер Deleted Contact, чтобы поддерживать порядок в других системах. Найдите контакт по ID или почте в приложении-приёмнике, затем очистите или заархивируйте нужную запись.

Редактор Zapier: триггер ConnectMachine Deleted Contact, связанный с шагами поиска и очистки строки в Google Sheets.

Нужны идеи? На странице ConnectMachine в Zapier собраны популярные Zap для Salesforce, HubSpot, Slack, Gmail и Airtable. Оба маршрута в CRM целиком — с сопоставлением полей и правилами для дублей — разобраны в статьях сканы визиток в HubSpot и сканы визиток в Salesforce.

05

Какие поля можно передавать

Что отдаёт триггер

Каждый триггер передаёт Zapier запись контакта целиком, поэтому в следующий шаг можно подставить любое из этих полей.

ПолеЧто внутри
Item IDУстойчивый ID события, чтобы Zap не сработал дважды на одно изменение.
Contact IDID контакта в ConnectMachine. Передайте его в Update Contact или сохраните в другом приложении.
Event TypeКонтакт был создан, изменён или удалён.
SourceОткуда пришло изменение. Значение zapier означает, что его сделал один из ваших Zap.
Contact TypeЧеловек или компания.
First Name, Last Name, Company, Job TitleОсновные поля идентификации.
Label, Notes, BioВаша метка ConnectMachine, приватные заметки и описание контакта.
Primary Email, Primary Phone, WebsiteОсновные контактные значения, готовые для подстановки почти в любое приложение.
Emails, Phones, Websites, Socials, CustomСписки с метками. У каждой записи есть метка и значение.
Address, Where We MetУлица, город, регион, индекс, страна и координаты.
TagsТеги контакта, включая теги мероприятий.
Created At, Updated At, Deleted AtОтметки времени в UTC.

Что принимают действия

Create Contact и Update Contact принимают один и тот же набор полей. Заполняйте только те, которые нужно задать.

ПолеОбязательноПримечания
Contact IDТолько для UpdateВыберите недавний контакт из списка или укажите Custom, чтобы передать ID из предыдущего шага.
Contact TypeНеобязательноЧеловек или компания. По умолчанию — человек.
First NameТолько для CreateОбязательно при создании любого контакта.
CompanyНеобязательноУкажите название компании; для контактов-компаний выберите Contact Type Business.
Last Name, Job Title, LabelНеобязательноОбычные текстовые поля.
Notes, BioНеобязательноЗаметки остаются видны только вам.
NetworkНеобязательноОставьте пустым, чтобы использовать сеть по умолчанию.
Primary Email, Primary Phone, WebsiteНеобязательноОбновляет текущее основное значение или создаёт его, если такого не было.
Emails, Phones, Websites, Socials, CustomНеобязательноДо пяти записей в каждом. У каждой записи должны быть метка и значение.
Address, Where We MetНеобязательноУлица, город, регион, индекс, страна и координаты. Where We Met также принимает название места.

Правила проверки

  • Значения email должны быть корректными адресами почты.
  • Ссылки на сайты, соцсети и карты должны начинаться с http:// или https://.
  • Широта — от -90 до 90. Долгота — от -180 до 180.
  • Пустые поля игнорируются. Update Contact никогда не стирает значение пустым полем.
  • Выбранные контакт и сеть должны принадлежать подключённому аккаунту ConnectMachine.

06

Как избежать зацикливания Zap

Когда Zap создаёт или меняет контакт в ConnectMachine, это изменение запускает триггер New Contact или Updated Contact, как и любое другое. Если тот же Zap слушает эти триггеры, он может запустить сам себя по кругу.

В каждой записи триггера есть поле Source. Изменения, сделанные вашими же Zap, приходят со значением zapier, поэтому их легко отфильтровать.

!

Добавьте этот фильтр сразу после триггера

Source  —  does not exactly match  —  zapier

Это нужно только тем Zap, которые пишут обратно в ConnectMachine. Zap, который просто отправляет контакты в другое приложение, зациклиться не может.

07

Решение проблем

Почти всё сводится к подключению, тарифу или значению, не прошедшему проверку. Найдите свой случай ниже.

Zapier пишет, что ваш тариф не включает доступ к Zapier

Ваш тариф ConnectMachine больше не покрывает Zapier. Продлите платную подписку, получите место в лицензии организации или начните пробный период Premium, а затем снова включите Zap.

Шаг падает с просьбой переподключиться или сообщает о нехватке разрешения

Подключению не хватает нужного разрешения. В Zapier откройте My Apps, переподключите ConnectMachine и подтвердите все разрешения на странице согласия.

Триггер перестал срабатывать, Zapier сообщает 410 Gone

Подписка на триггер удалена. Выключите и снова включите Zap, чтобы Zapier создал новую.

Действие сообщает, что контакт не найден

Такого Contact ID нет в подключённом аккаунте или контакт удалён. Проверьте переданный ID и убедитесь, что вы в нужном аккаунте ConnectMachine.

Действие отклоняет адрес почты или URL

Переданное значение не прошло проверку. Исправьте его в источнике или добавьте шаг Zapier Formatter, который уберёт лишние пробелы и подставит префикс https:// перед шагом ConnectMachine.

Достигнут лимит активных Zap с ConnectMachine

Отключите Zap с ConnectMachine, который больше не нужен, и попробуйте снова. Zapier также сам повторит попытку через 60 секунд.

Тест триггера не возвращает записей

Добавьте или измените контакт в ConnectMachine и снова нажмите Find new records.

Вход всё время не проходит

Удалите подключение ConnectMachine в разделе My Apps в Zapier и подключитесь заново.

08

Справочник API ConnectMachine для Zapier

Здесь описан каждый эндпоинт API ConnectMachine, который вызывает нативная интеграция. Это боевые HTTPS-эндпоинты: интеграция не обращается к песочнице, тестовому, стейджинговому или девелоперскому API.

Базовый URL продакшена
https://api.connectmachine.ai

Аутентификация и права

Интеграция использует OAuth 2.0 с authorization code flow и PKCE. Защищённые эндпоинты требуют Authorization: Bearer <access_token>. Zapier запрашивает права user:read, contacts:read, contacts:write и webhooks:write.

JSON · Успешный ответ с токеном
{
  "access_token": "<access-token>",
  "refresh_token": "<refresh-token>",
  "token_type": "Bearer",
  "expires_in": 3600,
  "scope": "user:read contacts:read contacts:write webhooks:write"
}

Эндпоинты

OAuth 2.0 с PKCE

GET/api/v1/oauth/authorize

Начинает авторизацию и перенаправляет браузер на страницу согласия ConnectMachine.

Authorization
Публичная точка входа авторизации
Request
Query: client_id, redirect_uri, response_type=code, scope, state, code_challenge и code_challenge_method=S256.
Success
302 Found на страницу согласия. После одобрения code и state возвращаются на зарегистрированный redirect_uri.
POST/api/v1/oauth/token

Обменивает код авторизации или refresh token на access token.

Authorization
Аутентификация OAuth-клиента
Request
Form-encoded. authorization_code: client_id, client_secret, code, code_verifier, redirect_uri, grant_type. refresh_token: client_id, client_secret, refresh_token, grant_type.
Success
200 OK с access_token, refresh_token, token_type=Bearer, expires_in и scope.
GET/api/v1/oauth/me

Проверяет подключение и возвращает подпись аккаунта, которая показывается в Zapier.

Authorization
user:read
Request
Authorization: Bearer <access_token>. Параметров в query и теле запроса нет.
Success
200 OK с id, email и name.

Подписки на мгновенные триггеры

POST/api/v1/zapier/subscriptions

Подписывает один Zap на события contact-created, contact-updated или contact-deleted.

Authorization
webhooks:write
Request
JSON: event_type и target_url. event_type — это contacts.created, contacts.updated или contacts.deleted. target_url должен быть HTTPS-адресом, который выдал Zapier.
Success
200 OK с id и event_type. Повторение того же запроса идемпотентно.
DELETE/api/v1/zapier/subscriptions/{id}

Удаляет подписку на триггер для текущего подключения.

Authorization
webhooks:write
Request
Path: id, полученный при создании подписки. Тела запроса нет.
Success
204 No Content.
GET/api/v1/zapier/trigger-samples

Возвращает показательную запись для настройки и тестирования мгновенного триггера.

Authorization
contacts:read
Request
Query: event_type=contacts.created, contacts.updated или contacts.deleted.
Success
200 OK с массивом из одного элемента по схеме доставки вебхука ниже.

Действия с контактами

POST/api/v1/zapier/contacts

Создаёт контакт-человека или контакт-компанию в подключённом аккаунте.

Authorization
contacts:write
Request
JSON contact mutation. first_name обязателен при создании любого контакта; company опционально. Все поддерживаемые поля перечислены ниже.
Success
201 Created с нормализованной записью контакта.
PATCH/api/v1/zapier/contacts/{id}

Обновляет только переданные поля существующего контакта, принадлежащего подключённому аккаунту.

Authorization
contacts:write
Request
Path: id контакта в ConnectMachine. JSON: любые поддерживаемые поля мутации контакта. Отсутствующие и пустые значения игнорируются.
Success
200 OK с нормализованной записью контакта.

Динамические варианты для полей

GET/api/v1/zapier/contact-options

Загружает недавние контакты для выпадающего списка Update Contact.

Authorization
contacts:read
Request
Query: page — целое число, начиная с 1. На каждой странице до 50 записей.
Success
200 OK с массивом объектов, содержащих id и name.
GET/api/v1/zapier/network-options

Загружает сети для Create Contact и Update Contact.

Authorization
contacts:read
Request
Query: page — целое число, начиная с 1. На каждой странице до 50 записей.
Success
200 OK с массивом объектов, содержащих id и name.

JSON мутации контакта

Create Contact и Update Contact принимают JSON со следующими полями. Неизвестные поля игнорируются. Пустые значения не стирают существующие данные.

Поле JSONТипПравила
typeстрокаperson или business. При создании по умолчанию person.
first_name, last_nameстрокаfirst_name обязателен при создании любого контакта.
company, job_titleстрокаНеобязательные данные о компании и роли.
notes, bio, network_idстрокаnetwork_id должен принадлежать подключённому аккаунту.
email, phone, websiteстрокаОсновные значения; метки задаются через email_label, phone_label и website_label.
emails, phones, websitesмассивДо пяти объектов { label, value } на каждый тип значения.
socials, customмассивДо пяти объектов { label, value } на каждую коллекцию.
address, where_we_metобъектПоля местоположения: name, googlemap_uri, street, street2, city, state, country, postcode, latitude, longitude.

Доставка мгновенных триггеров

ConnectMachine отправляет один HTTPS POST на target URL подписки. События создания и изменения содержат текущие снимки контактов. События удаления содержат contact_ids и, если они доступны, снимки состояния до удаления в contacts. Zapier превращает каждый контакт в один элемент триггера, у которого Item ID собран из ID события и контакта.

JSON · Тело вебхука
{
  "event_id": "event_01",
  "occurred_at": "2026-08-04T12:00:00Z",
  "source": "app",
  "source_id": "contact_01",
  "data": {
    "event_type": "contacts.updated",
    "contacts": [{
      "id": "contact_01",
      "type": "person",
      "first_name": "John",
      "last_name": "Doe",
      "primary_email": "john.doe@example.com",
      "updated_at": "2026-08-04T12:00:00Z"
    }]
  }
}

Ошибки

У ошибок единый формат тела JSON. Ответ 429 дополнительно содержит заголовок Retry-After.

JSON · Ответ с ошибкой
{
  "error": "invalid_request",
  "error_description": "Invalid contact payload"
}
СтатусКодыЧто означает
400invalid_request, invalid_event_type, invalid_contact_type, first_name_required, invalid_email, invalid_url, invalid_website, invalid_labeled_value, too_many_values, invalid_latitude, invalid_longitude, invalid_location_url, invalid_target_urlЗапрос сформирован неверно или поле не прошло проверку.
401invalid_client, invalid_grant, invalid_tokenOAuth-клиент, grant или bearer-токен отсутствует, истёк, отозван или недействителен.
403insufficient_scope, onboarding_required, premium_required, forbiddenПереподключитесь с нужными правами, завершите онбординг или включите доступ к Zapier для аккаунта.
404not_foundЗапрошенный контакт, аккаунт или принадлежащий вам ресурс не существует.
409conflictЗапрос конфликтует с текущим состоянием ресурса.
429subscription_limit, rate_limitedПовторите через число секунд, указанное в заголовке Retry-After.
503server_error, temporarily_unavailableСервис не смог выполнить запрос; повторите с задержкой.

Всё ещё не получается?

Пришлите нам название вашего Zap и ошибку, которую показал Zapier, — мы посмотрим.

hi@connectmachine.ai

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