Подключение, кастомные поля и матчинг контактов GetCourse

Где взять ключ API

Ключ API выдается в GetCourse на платном тарифе. Без платного тарифа раздел API недоступен.

1. Войдите в GetCourse под администратором.
2. Откройте Профиль (иконка в правом верхнем углу), затем Настройки аккаунта.
3. Перейдите на вкладку API (прямой адрес: /saas/account/api).
4. Нажмите Создать ключ, выберите уровень доступа Для чтения и записи.
5. Скопируйте ключ - он показывается один раз.

Подключение в Strelo

Откройте Настройки, Интеграции продаж, раздел GetCourse. Заполните три поля:

• Аккаунт - имя или URL школы, например myschool.getcourse.ru (без https://).
• API-ключ - ключ, скопированный из GetCourse.
• Поле GetCourse для Telegram ID - название кастомного поля пользователя в GetCourse, куда Strelo будет записывать telegram_id. По умолчанию telegram_id.

1. Нажмите Проверить соединение - Strelo сделает тестовый запрос к API.
2. После успешной проверки нажмите Включить.

Какие кастомные поля создать в GetCourse

Поле пользователя telegram_id

В GetCourse создайте кастомное поле пользователя с типом Текст и названием telegram_id (название должно совпадать с тем, что указано в Strelo - по умолчанию telegram_id). В это поле Strelo автоматически пишет telegram_id контакта при каждом вызове ноды GC: Пользователь или GC: Сделка. По этому полю идет матчинг при входящих событиях из GetCourse.

GetCourse может создать поле сам при первой записи, но надежнее создать его вручную заранее: Настройки, Дополнительные поля пользователей, добавить поле с типом Текст и именем telegram_id.

Оффер для ноды GC: Сделка

Оффер не является кастомным полем, но он обязан существовать в GetCourse до того, как нода GC: Сделка к нему обратится. Создайте оффер в разделе Продукты, Офферы. offer_code из оффера вводится в поле ноды GC: Сделка. API GetCourse не умеет создавать офферы - только использовать уже существующие.

Strelo передает в GetCourse

Ноды GC: Пользователь и GC: Сделка создают или обновляют пользователя в GetCourse по email или phone, и автоматически проставляют telegram_id контакта в кастомное поле telegram_id. Дополнительные поля ноды записываются в кастомные поля GetCourse по их названию.

GetCourse передает в Strelo (триггеры и матчинг)

Настройте Процесс в GetCourse с блоком Вызвать URL и вставьте URL из панели триггера Strelo. Чтобы Strelo мог надежно найти контакт, добавьте telegram_id в тело запроса.

Пример тела для Процесса на объект Заказы:

email={object.user.email}&telegram_id={object.user.telegram_id}&number={object.number}&cost_money={object.cost_money}&status={object.status}

Для Процесса на объект Пользователи (плоская структура):

email={object.email}&telegram_id={object.telegram_id}

Strelo матчит контакт последовательно: сначала по telegram_id, потом по email, потом по phone. Пустые поля контакта дозаполняются из пришедших данных. События приходят с задержкой 5-15 минут - GetCourse запускает Процесс периодической проверкой условий, не мгновенным webhook.

Кратко про матчинг

• Общий ключ - telegram_id: Strelo кладет его в GC на исходящих, GC возвращает его на входящих - контакт находится точно.
• Резервный ключ - email: если telegram_id не передан, матчинг идет по email.
• Дозаполнение: Strelo не перезаписывает уже заполненные поля контакта, только дополняет пустые.
• Лучшая практика: всегда передавайте telegram_id в макросах Вызвать URL, даже если кажется, что email достаточно.