Отправляйте каждый новый и изменённый контакт из ConnectMachine прямо в приложения, которыми вы уже пользуетесь, и записывайте контакты обратно. В руководстве — как подключить аккаунт, какие есть триггеры и действия, какие поля можно передавать и как справиться с проблемами, на которые натыкаются чаще всего.
Приложение ConnectMachine в Zapier даёт три триггера и два действия для ваших контактов. Триггеры срабатывают мгновенно: Zap запускается через считаные секунды после изменения контакта, а не ждёт очередного опроса.
Что понадобится
Аккаунт ConnectMachine с завершённым онбордингом.
Доступ к Zapier на вашем тарифе ConnectMachine: платная подписка, место в лицензии организации или активный пробный период Premium.
Аккаунт Zapier. На бесплатном тарифе Zapier доступно 100 задач в месяц — этого хватает для большинства одношаговых Zap.
02
Подключите аккаунт
ConnectMachine подключается к Zapier один раз. Дальше любой ваш Zap использует то же подключение.
1В Zapier создайте Zap и найдите ConnectMachine.
2Выберите триггер или действие ConnectMachine и нажмите Sign in.
3ConnectMachine откроет страницу согласия. Войдите через Google или по коду, отправленному на почту. Пароль спрашивать не будут.
4Проверьте, какие разрешения вы выдаёте, и нажмите Approve and continue.
5Zapier вернёт вас в редактор Zap с подключённым и готовым к работе аккаунтом ConnectMachine.
Войдите в аккаунт 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 запускается каждый раз, когда меняются данные контакта.
2
Загрузите пример записи
Нажмите Test, чтобы загрузить пример контакта. Примеры позволяют сопоставить поля до того, как придёт настоящее событие. Если ничего не загрузилось, добавьте или измените контакт в ConnectMachine и повторите тест.
3
Посмотрите, что отдаёт триггер
Разверните пример, чтобы увидеть все поля, доступные для следующих шагов: имена, компанию, должность, основные почту и телефон, значения с метками, адреса, теги и отметки времени.
4
Передайте поля в следующее приложение
Добавьте второе приложение и перетащите в него поля ConnectMachine. Здесь строка Google Sheets передаётся в действие Update Contact, поэтому правки в таблице возвращаются в ConnectMachine.
5
Обработайте удаления
Используйте триггер Deleted Contact, чтобы поддерживать порядок в других системах. Найдите контакт по ID или почте в приложении-приёмнике, затем очистите или заархивируйте нужную запись.
Каждый триггер передаёт Zapier запись контакта целиком, поэтому в следующий шаг можно подставить любое из этих полей.
Поле
Что внутри
Item ID
Устойчивый ID события, чтобы Zap не сработал дважды на одно изменение.
Contact ID
ID контакта в 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.
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 события и контакта.