Zapier — подключение и автоматизация

Zapier позволяет вам автоматически загружать данные из любых популярных приложений (Google Sheets, Shopify, Stripe, Mailchimp и других) в AACsearch, без написания кода.

Что такое Zapier? Zapier — это сервис, который соединяет разные приложения и автоматизирует рабочие процессы. Например, когда в Google Sheets добавляется новая строка, Zapier может автоматически загрузить этот товар в AACsearch.

Требования

• Аккаунт на Zapier (бесплатный или платный)
• Аккаунт на AACsearch с созданным индексом
• API-ключ для загрузки документов (скоп ingest)

Шаг 1: Создайте API-ключ для загрузки

В AACsearch создайте специальный ключ для Zapier:

1. Откройте Поиск → API-ключи
2. Нажмите Создать ключ
3. Дайте имя: Zapier Integration
4. Выберите скоп: Ingest (для загрузки документов)
5. Выберите индекс: products (или другой)
6. Нажмите Создать
7. Скопируйте ключ и сохраните его (он больше не будет показан)

Ключ будет выглядеть так: ss_ingest_abc123def456

Шаг 2: Создайте Zap в Zapier

Откройте Zapier и создайте новый Zap

1. Перейдите на zapier.com
2. Нажмите Create (Создать)
3. Выберите Zap → Create a new Zap

Выберите триггер (что вызывает действие)

Триггер — это событие, которое запускает автоматизацию. Выберите один из вариантов:

Вариант 1: Google Sheets (рекомендуется)

• App: Google Sheets
• Trigger: New Spreadsheet Row
• Выберите Google-аккаунт
• Выберите таблицу с товарами

Вариант 2: Shopify

• App: Shopify
• Trigger: New Product
• Выберите ваш Shopify-магазин

Вариант 3: Stripe

• App: Stripe
• Trigger: New Product
• Выберите Stripe-аккаунт

Вариант 4: WooCommerce

• App: WooCommerce
• Trigger: New Product
• Укажите URL вашего магазина и API-ключи

После выбора триггера нажмите Continue.

Протестируйте триггер

Zapier попросит протестировать триггер:

1. Нажмите Test Trigger
2. Zapier получит данные из вашего источника (строку из Google Sheets, товар из Shopify и т.д.)
3. Вы увидите пример данных
4. Нажмите Continue если данные выглядят правильно

Шаг 3: Выберите действие (что Zapier делает)

Действие — это то, что Zapier должен сделать когда триггер сработает.

1. Нажмите + → Action
2. Найдите и выберите Webhooks by Zapier (если AACsearch нет в списке)
3. Action: POST
4. Нажмите Continue

Шаг 4: Настройте webhook для загрузки в AACsearch

Заполните данные для запроса

Где найти INDEX_ID

1. В AACsearch откройте Поиск → Индексы
2. Нажмите на нужный индекс
3. В URL в строке браузера вы видите: https://app.aacsearch.com/[ORG]/search/[INDEX_ID]
4. Скопируйте INDEX_ID

Пример URL:

https://app.aacsearch.com/api/v1/indexes/65f8d2e1c9a2b3f4e5g6h7i8/documents

Добавьте заголовки (Headers)

Нажмите + Add Header и добавьте два заголовка:

Добавьте тело запроса (Body)

Нажмите на вкладку Body и выберите формат JSON.

В зависимости от источника данных, формируйте массив документов:

Для Google Sheets:

[
  {
    "id": "row_123",
    "title": {{ 65f8d2e1c9a2b3f|Column_1 }},
    "description": {{ 65f8d2e1c9a2b3f|Column_2 }},
    "price": {{ 65f8d2e1c9a2b3f|Column_3 }},
    "category": {{ 65f8d2e1c9a2b3f|Column_4 }}
  }
]

Для Shopify:

[
  {
    "id": {{ 65f8d2e1c9a2b3f|Product_ID }},
    "title": {{ 65f8d2e1c9a2b3f|Product_Title }},
    "description": {{ 65f8d2e1c9a2b3f|Product_Body_HTML }},
    "price": {{ 65f8d2e1c9a2b3f|Product_Price }},
    "category": {{ 65f8d2e1c9a2b3f|Product_Type }},
    "image": {{ 65f8d2e1c9a2b3f|Product_Image_URL }}
  }
]

Для WooCommerce:

[
  {
    "id": "{{ 65f8d2e1c9a2b3f|Product_ID }}",
    "title": "{{ 65f8d2e1c9a2b3f|Product_Title }}",
    "description": "{{ 65f8d2e1c9a2b3f|Product_Description }}",
    "price": {{ 65f8d2e1c9a2b3f|Product_Price }},
    "category": "{{ 65f8d2e1c9a2b3f|Product_Category }}"
  }
]

Числа (price) вводятся БЕЗ кавычек {{ }}, а текст (title) — с кавычками.

Шаг 5: Протестируйте webhook

1. Нажмите Test Action
2. Zapier отправит тестовый запрос в AACsearch
3. Если ошибка, проверьте:
   • ✓ API-ключ скопирован правильно (без пробелов)
   • ✓ URL содержит правильный INDEX_ID
   • ✓ Headers заполнены (Authorization, Content-Type)
   • ✓ JSON правильный (используйте jsonlint.com для проверки)

Успешный ответ будет выглядеть так:

{
  "documentCount": 1,
  "status": "queued"
}

Шаг 6: Включите Zap

1. Дайте Zap название (например, Google Sheets → AACsearch)
2. Нажмите Publish
3. Zapier начнёт запускать этот Zap при каждом новом триггере

Примеры интеграций

Google Sheets → AACsearch

Когда новая строка добавляется в Google Sheets
Тогда товар загружается в AACsearch

Таблица структура:
| Title | Description | Price | Category |
|-------|-------------|-------|----------|
| Кроссовки | Спортивная обувь | 5000 | Обувь |
| Рубашка | Хлопковая рубашка | 3000 | Одежда |

Zap структура:

1. Триггер: Google Sheets → Новая строка
2. Действие: Webhooks → POST в AACsearch

Shopify → AACsearch (синхронизация каждые 5 минут)

Когда новый товар создаётся в Shopify
Тогда товар загружается в AACsearch

Настройки:

• Расписание: Каждые 5 минут
• Триггер: Shopify → Новый товар
• Фильтр: Только товары с ценой > 0
• Действие: Webhooks → POST

Клиенты Stripe → AACsearch

Когда новый клиент добавляется в Stripe
Тогда клиент загружается в индекс "customers"

Body:
[
  {
    "id": "{{ 65f8d2e1c9a2b3f|Customer_ID }}",
    "name": "{{ 65f8d2e1c9a2b3f|Customer_Name }}",
    "email": "{{ 65f8d2e1c9a2b3f|Customer_Email }}",
    "created_at": "{{ 65f8d2e1c9a2b3f|Created_At }}"
  }
]

Подписчики Mailchimp → AACsearch

Когда новый подписчик добавляется в Mailchimp
Тогда подписчик загружается в индекс "subscribers"

Body:
[
  {
    "id": "{{ 65f8d2e1c9a2b3f|Subscriber_ID }}",
    "email": "{{ 65f8d2e1c9a2b3f|Email }}",
    "name": "{{ 65f8d2e1c9a2b3f|First_Name }} {{ 65f8d2e1c9a2b3f|Last_Name }}",
    "status": "{{ 65f8d2e1c9a2b3f|Status }}"
  }
]

Расширенные возможности

Обновление существующих документов

Если документ с таким же id уже существует, он будет обновлен:

[
  {
    "id": "product_123",
    "title": "Новое название товара",
    "price": 6000
  }
]

AACsearch обновит товар, а не создаст дубликат.

Фильтрация данных перед загрузкой

Вы можете добавить фильтр в Zapier, чтобы загружать только определённые товары:

1. Между Trigger и Action добавьте Filter
2. Условие: Price > 100 или Category = "Обувь"
3. Только товары, подходящие под условие, будут загружены

Расписание вместо real-time

Если вам не нужна real-time синхронизация, используйте расписание:

1. В Trigger выберите Schedule вместо триггера приложения
2. Frequency: Every day at 9am (каждый день в 9 утра)
3. Action будет запускаться по расписанию

Мониторинг и отладка

Проверьте логи Zap

1. В Zapier откройте ваш Zap
2. Перейдите на вкладку История запусков
3. Нажмите на нужный запуск
4. Вы увидите входные данные, запрос и ответ

Типичные ошибки

Включите логирование

Для отладки сложных Zaps добавьте Formatter перед Action:

1. Между Trigger и Action добавьте Action → Formatter
2. Event: Text → JSON
3. Input: (ваш JSON)
4. Это поможет увидеть, как данные преобразуются

Ограничения Zapier

Если превысите лимит, Zapier отключит ваш Zap. Обновитесь на платный тариф для большего объёма.

Альтернативы Zapier

Если вам не нравится Zapier, используйте альтернативы:

• Make (Integromat) — более мощный и дешевле
• Integrately — проще для новичков
• Pabbly Connect — самый дешевый
• Собственный скрипт — Python, Node.js, Go для полного контроля

Часто задаваемые вопросы

Q: Нужна ли мне Zapier для синхронизации?
A: Нет. Если вы разработчик, вы можете написать свой скрипт на Python или Node.js. Zapier — для нетехнических пользователей.

Q: Можно ли обновлять существующие товары через Zapier?
A: Да. Если вы отправите документ с таким же id, он будет обновлен.

Q: Как часто Zapier проверяет обновления?
A: На бесплатном тарифе — каждые 15 минут. На платном — каждые 1-5 минут (в зависимости от плана).

Q: Что если источник данных имеет другую структуру?
A: Используйте Formatter в Zapier, чтобы преобразовать данные в нужный формат.

Q: Можно ли загружать изображения через Zapier?
A: Да, если передать URL изображения в поле image. AACsearch автоматически скачает и сохранит изображение.

Q: Как удалить товары из AACsearch через Zapier?
A: Используйте DELETE запрос вместо POST. URL: https://app.aacsearch.com/api/v1/indexes/{INDEX_ID}/documents/{DOC_ID}.

Помощь и поддержка

• Документация Zapier
• Документация AACsearch API
• Примеры интеграций
• Email: support@aacsearch.com