Урок 7. Схемы интеграций — как читать и понимать

Урок 7. Схемы интеграций — как читать и понимать#

Зачем это нужно#

Схема интеграции — это визуальное представление, как данные движутся между сервисами. Умение читать схемы помогает понять логику проекта и общаться с разработчиками.

Ключевая идея#

Схема интеграции = карта потока данных

Вы видите: откуда данные приходят, что с ними происходит, куда они уходят.

Элементы схемы#

1. Блоки (сервисы)

Прямоугольники или иконки сервисов

Примеры:

• 📱 Telegram Bot

• 📊 Google Sheets

• 💼 CRM (Bitrix24)

• 🤖 AI Agent (Coze)

2. Стрелки (поток данных)

Стрелки показывают направление движения данных

Примеры:

• Telegram → AI Agent (клиент пишет боту)

• AI Agent → Google Sheets (бот записывает данные)

3. Подписи (что передаётся)

Текст над стрелкой описывает данные

Примеры:

• "Имя, телефон, услуга"

• "Webhook: новый заказ"

• "API: создать лид"

Пример схемы 1: FAQ-бот#

Что происходит:

1. Клиент пишет вопрос боту в Telegram

2. Бот (AI-агент в Coze) получает вопрос

3. Агент ищет ответ в базе знаний

4. Агент находит ответ и отправляет клиенту

Пример схемы 2: Квалификация лидов#

Что происходит:

1. Клиент пишет боту

2. Агент задаёт вопросы (задача, бюджет, сроки)

3. Клиент отвечает

4. Агент оценивает лид

5. Агент записывает данные в Google Sheets

6. Менеджер видит новый лид и связывается с клиентом

Пример схемы 3: Интеграция с CRM#

Что происходит:

1. Клиент заполняет форму на сайте (имя, телефон, задача)

2. Форма отправляет webhook в автоматизацию (n8n или Zapier)

3. Автоматизация передаёт данные AI-агенту

4. AI-агент оценивает лид (горячий/тёплый/холодный)

5. Автоматизация создаёт лид в CRM (Bitrix24)

6. Автоматизация отправляет уведомление менеджеру в Telegram

Как читать схему (алгоритм)#

1. Найдите начало — откуда приходят данные (клиент, форма, сайт)

2. Проследите стрелки — куда данные движутся

3. Прочитайте подписи — что передаётся на каждом шаге

4. Найдите конец — где данные остаются или что происходит в итоге

Практика: разбор схемы#

Схема:

Вопросы для разбора:

1. Откуда начинается процесс? → Клиент пишет боту в Telegram

2. Что делает AI-агент? → Собирает данные (имя, телефон, услуга)

3. Куда записываются данные? → В Google Sheets

4. Кто получает уведомление? → Админ по email

Ответы:

Клиент пишет боту → бот собирает данные → бот записывает в Google Sheets → админ получает email-уведомление

Проверь свои знания#

Квиз: Схемы интеграций

Карточки для запоминания

Практика: Разбор интеграций#

Задание 1: Определить тип интеграции#

Сценарии:

1. Бот записывает заявку в Google Sheets → это API (POST-запрос)

2. Платёжная система уведомляет бота об оплате → это Webhook

3. Клиент входит в сервис через Google-аккаунт → это OAuth 2.0

4. Бот читает данные из Airtable → это API (GET-запрос)

Задание 2: Прочитать JSON#

Дан JSON:

{

  "client_id": 42,

  "name": "Ольга",

  "phone": "+7-999-555-66-77",

  "services": ["Маникюр", "Педикюр"],

  "total_price": 4500

}

Вопросы:

1. Как зовут клиента? → Ольга

2. Какой телефон? → +7-999-555-66-77

3. Какие услуги заказаны? → Маникюр и Педикюр

4. Итоговая цена? → 4500 руб.

Задание 3: Нарисовать схему интеграции#

Задача:

Клиент оставляет заявку на сайте (форма). Данные отправляются в CRM (Bitrix24) и одновременно менеджер получает уведомление в Telegram.

Ваша схема:

Проверка:

• Начало: форма на сайте

• Что передаётся: имя, телефон, задача

• Куда: CRM и Telegram

• Как: через webhook и автоматизацию

Задание 4: Практика в Coze — подключить Google Sheets#

Задача:

Возьмите одного из агентов, созданных в модуле 4 (FAQ-бот или агент квалификации), и настройте интеграцию с Google Sheets для записи данных.

Что сделать:

1. Создайте таблицу в Google Sheets:

   • Название: «Лиды [Ваша ниша]»

   • Колонки: Дата, Имя, Контакт, Вопрос/Задача, Статус

2. Откройте вашего агента в Coze (из модуля 4)

3. Подключите плагин Google Sheets:

   • Перейдите в Skills → Add Skill → Plugins

   • Найдите Google Sheets (или аналог)

   • Настройте credentials (дайте доступ к таблице)

   • Укажите таблицу и лист

4. Обновите промпт:

   • Добавьте инструкцию: «После общения с клиентом запиши данные в Google Sheets: Дата, Имя, Контакт, Вопрос/Задача, Статус»

5. Протестируйте:

   • Напишите боту в Telegram

   • Проверьте, что данные записались в таблицу

Чек-лист:

• Таблица создана (правильные колонки)

• Плагин Google Sheets подключён к боту в Coze

• Промпт обновлён (инструкция по записи данных)

• Тестирование пройдено (данные записались)

• Формат данных правильный (дата, имя, контакт корректны)

Что вы получите:

Рабочую интеграцию «Coze-агент → Google Sheets». Теперь все диалоги с ботом автоматически записываются в таблицу для аналитики.

Время: 20-30 минут

Шаблоны и артефакты#

Словарь терминов (шпаргалка)#

API — способ общения между сервисами (запрос → ответ)

Webhook — уведомление от сервиса, когда что-то произошло

JSON — формат данных в виде "ключ: значение"

Авторизация — способ доказать, что у вас есть доступ (ключ, токен)

Интеграция — связь между сервисами для обмена данными

База данных — структурированное хранилище данных

OAuth — авторизация через сторонний сервис (например, "Войти через Google")

GET — запрос для получения данных

POST — запрос для отправки данных

Токен (Bearer Token) — временный ключ для доступа к API

Чек-лист: Как понять схему интеграции#

• Найдите начало (откуда данные)

• Проследите стрелки (куда данные идут)

• Прочитайте подписи (что передаётся)

• Найдите конечную точку (где данные остаются или что происходит)

• Определите типы интеграций (API, webhook, OAuth)

Шаблон простой интеграции#

Пример заполнения:

Проверочные вопросы#

1. Что такое интеграция и зачем она нужна?

2. Чем отличается API от Webhook?

3. Что такое JSON и где он используется?

4. Какие типы API-запросов существуют? Приведите примеры.

5. Что такое авторизация и какие типы бывают?

6. Почему Google Sheets удобны как база данных для начинающих?

7. Как прочитать схему интеграции?

8. Что происходит, когда клиент оплачивает заказ и система отправляет webhook?

Правильные ответы:

1. Интеграция — это связь между сервисами для автоматического обмена данными. Она нужна, чтобы не копировать данные вручную.

2. API — это когда вы спрашиваете сервис ("покажи данные"), Webhook — когда сервис сам вам сообщает ("произошло событие").

3. JSON — это формат структурированных данных в виде "ключ: значение". Используется в API для передачи информации.

4. GET (получить данные), POST (отправить данные), PUT (обновить), DELETE (удалить). Пример: POST для записи клиента в базу.

5. Авторизация — это способ подтвердить доступ к API. Типы: API Key, Bearer Token, OAuth.

6. Google Sheets бесплатны, понятны (как Excel), легко интегрируются и доступны команде.

7. Найдите начало (источник данных) → проследите стрелки → прочитайте подписи (что передаётся) → найдите конец (куда данные попадают).

8. Платёжная система (например, Stripe) отправляет webhook на ваш сервер с данными о платеже. Сервер получает уведомление и выполняет действие (например, отправляет чек клиенту и уведомление менеджеру).

Итоги модуля#

Вы изучили:

• что такое интеграции и зачем они нужны

• как работает API и Webhook

• что такое JSON и как его читать

• типы авторизации (API Key, Bearer Token, OAuth)

• как использовать Google Sheets, Airtable, Notion как базы данных

• как читать схемы интеграций

Вы можете:

• объяснить, как данные движутся между сервисами

• прочитать простой JSON

• разобрать схему интеграции

• задать правильные вопросы разработчику

Следующий шаг: Модуль 7 — как писать промпты и техническое задание для AI-агентов.

Проверь свои знания#

Квиз: Базовые IT-термины#

Карточки для запоминания терминов#

Материалы для сайта#