Woove Woove Connect Связки API и GetCourse

Связка · API и GetCourse

Интеграция GetCourse по API

Заявки из вашего кода уходят в GetCourse без ручного переноса. Для GetCourse в заявке нужен телефон или почта.

999 ₽ в месяц · 14 дней бесплатно · черновой режим по умолчанию

Ученики смеются у ноутбука

Заявка · API14:02

APIМарина Кузнецова, +7 916 220-47-81
Woove Connect5 полей разобрано, повторов нет
GetCourseЗаявка с сайта заводит пользователя и заказ на курс

Поля

Что уходит в GetCourse

GetCourse требует почту или телефон. Если создаёте заказ — обязателен код предложения, он берётся из карточки продукта.

В GetCourse заводится пользователь: почта, телефон, имя и фамилия.

В API
В GetCourse
Пример
Name
user.first_name
Марина
Name
user.last_name
Кузнецова
Phone
user.phone
+7 916 220-47-81
Email
user.email
marina.k@example.ru
Comment
user.addfields.Комментарий с сайта
Хочу на ближайший поток

Из настройки интеграции: system.refresh_if_exists.

Запрос в GetCourse: POST https://myschool.getcourse.ru/pl/api/users.

Запрос к Woove
curl -X POST https://woove.ru/hook/api/<ваш ключ> \
  -H 'Content-Type: application/json' \
  -d '{
    "Name": "Марина Кузнецова",
    "Phone": "+7 916 220-47-81",
    "Email": "marina.k@example.ru",
    "Comment": "Хочу на ближайший поток",
    "tranid": "order-1001"
  }'

Обязательно

Что нужно в заявке

Заявка без этих полей остаётся в кабинете со статусом «Не разобрано» и причиной.

Телефон или почта

Без них заявка не уйдёт в GetCourse. Сделайте обязательным хотя бы одно из полей. Передавайте поле "Phone" в каждом запросе.

Подключение

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

Пока включён черновой режим, заявки разбираются, но в GetCourse не уходят.

  1. Доступ в GetCourse

    Доступ к API GetCourse — ключ в разделе «Настройки аккаунта → API».

    • Войдите в свой аккаунт GetCourse
    • Настройки аккаунта → раздел API
    • Скопируйте секретный ключ
    • Поддомен аккаунта — то, что стоит до .getcourse.ru в адресе вашей школы

    Где взять доступ к GetCourse

  2. Интеграция в кабинете

    В кабинете откройте «Connect» и подключите GetCourse. На вкладке «Настройка» в поле «Источник заявок» выберите «API» и нажмите «Скопировать». Там же заполните блок «Доступ».

  3. Отправка из вашего кода

    • Отправляйте POST на адрес вебхука из кабинета с JSON-телом: {"Name": "…", "Phone": "…", "Email": "…", "Comment": "…"} и любыми своими полями.
    • В ответ придёт {"ok": true}. Повторы с одинаковым tranid отбрасываются.
    • Заявка с ошибкой настройки появится на вкладке «Заявки» со статусом «Не разобрано» и причиной.

    Тело читается как JSON, если в заголовке Content-Type указан application/json. Иначе Woove разбирает его как форму. Вложенный JSON разворачивается в плоские поля. Массив пар с подписью и значением превращается в поля с этими подписями. Запрос можно отправлять из браузера: заголовки CORS разрешают POST с любого домена. Поля _redirect, _thanks, _source и _gotcha служебные, в заявку они не попадают. Запрос с одним полем test записывается как проверочный и в сервис не уходит.

    • 200 {"ok":true}: заявка принята
    • 404 unknown hook: ключа из адреса нет ни у одной интеграции
    • 413 too large: тело запроса больше 256 КБ
    • GET на адрес вебхука: отвечает ok, заявку не создаёт

    Повтор отбрасывается, если заявка с таким tranid уже принята или отправлена. Заявка с ошибкой настройки повтор не блокирует.

  4. Поля формы

    Ключи JSON — имена полей.

    Менять ничего не нужно: имя, телефон, почту и комментарий Woove находит сам.

  5. Проверка

    Отправьте запрос из примера. На вкладке «Заявки» у неё будет статус «Черновик» и то, что уйдёт в GetCourse. Затем выключите «Черновой режим» на вкладке «Настройка».

    API и Woove Connect: заявки с форм в CRM и мессенджеры

Ошибки

Ошибки этой связки

После исправления заявку можно отправить ещё раз с вкладки «Заявки».

API → GetCourse

Не разобрано: GetCourse требует почту или телефон, в заявке нет ни того, ни другого

В заявке не было телефона и почты. Сделайте обязательным хотя бы одно из полей. Передавайте поле "Phone" в каждом запросе.

API

В ответ приходит 404

Ключ в адресе не совпадает с ключом интеграции. Скопируйте адрес из кабинета заново.

GetCourse

GetCourse отвечает «user not found»

В заявке не было ни почты, ни телефона — хотя бы одно поле обязательно. Проверьте, как оно называется в форме и что указано в настройке.

GetCourse

Пользователь создаётся, а заказ нет

Не указан код предложения. Он берётся в карточке продукта: Продукты → нужный продукт → Предложения.

Вопросы

Частые вопросы

Инструкция со скриншотами: настройка API.

Какие поля нужны для GetCourse?

Нужен телефон или почта. Без этого заявка остаётся в кабинете со статусом «Не разобрано». Имя и комментарий можно не заполнять.

Куда в GetCourse попадёт поле Comment?

В поле user.addfields.Комментарий с сайта: «Хочу на ближайший поток».

Сколько стоит связка API и GetCourse?

999 ₽ в месяц или 9 999 ₽ в год за одну интеграцию. Первый месяц 499 ₽. Первые 14 дней бесплатно, карта не нужна. Пакет Connect: до 3 интеграций за 1 990 ₽ в месяц. В Woove Pro за 4 999 ₽ интеграций без ограничения.

Начало

Заявки из вашего кода в GetCourse

14 дней бесплатно, дальше 999 ₽ в месяц за связку. Черновой режим включён по умолчанию.

Ученики смеются у ноутбука