Подключение заявок с сайта

AXKED может автоматически получать обращения из формы на вашем сайте. После отправки формы CRM создаёт или находит карточку ученика и добавляет заявку в выбранную воронку, канал и филиал.

Что подготовить перед подключением

• воронку с начальным статусом для новых заявок;
• канал, по которому обращения с сайта будут отображаться в CRM;
• при необходимости филиал, к которому нужно привязывать заявки;
• доступ к настройкам формы или webhook на вашем сайте.

Если в CRM ещё не настроена подходящая воронка, воспользуйтесь инструкцией «Настройка статусов и автоматизаций воронки».

Как получить данные для интеграции

1. Откройте Настройки.
2. Найдите блок Заявки и нажмите Интеграция.
3. Выберите воронку, в которую должны поступать обращения.
4. Выберите канал заявки.
5. При необходимости выберите филиал.
6. Нажмите Получить код.

AXKED покажет готовые варианты подключения. Используйте вариант, который соответствует вашему сайту или конструктору.

Какой вариант подключения выбрать

Как подключить обычную форму на сайте

1. В окне интеграции найдите блок Форма на сайт.
2. Скопируйте сформированный код формы и добавьте его на сайт.
3. Сохраните в форме поля name, phone и email, чтобы AXKED получил имя и контакты клиента.
4. Добавьте к форме нужное оформление средствами вашего сайта.
5. Нажмите Доступные сайты.
6. Укажите домен сайта без https:// и пути, например school.ru;. Несколько доменов разделяйте точкой с запятой.
7. Нажмите Сохранить.

После этого браузер сможет отправлять обращения с указанного сайта в AXKED. Если форма размещена на другом домене или поддомене, добавьте его в список доступных сайтов отдельно.

Как подключить форму через webhook

1. В окне интеграции найдите блок с названием вашего конструктора или сервиса.
2. Скопируйте сформированный адрес webhook.
3. Откройте настройки формы на стороне сервиса и добавьте этот адрес в поле для webhook или приёма данных.
4. Настройте передачу имени, телефона и электронной почты.
5. Сохраните форму и опубликуйте изменения на сайте.

Если форма передаёт стандартные UTM-метки, AXKED сохранит их в заявке. Это позволяет анализировать источник, кампанию и объявление, из которых пришёл клиент.

Что происходит после отправки формы

• AXKED ищет ученика по телефону или электронной почте.
• Если подходящей карточки нет, CRM создаёт нового ученика.
• Заявка попадает на первый этап выбранной воронки.
• В заявке сохраняются выбранные канал и филиал, а также переданные комментарий и UTM-метки.
• Правила повторных обращений зависят от способа подключения. Для обычной формы и варианта «Отправка запроса» они описаны ниже.

Повторные обращения через обычную форму и «Отправку запроса»

Приёмник использует прежний поиск по телефону или электронной почте и сверяет имя ученика. Совпадение только контакта не гарантирует выбор существующей карточки. Если ученик найден, активная заявка в другой воронке не мешает создать новую в выбранной воронке.

Если в выбранной воронке у ученика уже есть активная заявка, приёмник использует её. Переданные комментарий, сообщение и комментарий для карточки сохраняются отдельной записью в комментариях карточки ученика с номером заявки и названием воронки. Пустая запись не добавляется. Исходный комментарий, этап, канал и филиал существующей заявки не изменяются. Закрытая заявка не мешает создать новую.

Как получить результат серверной отправки

Для варианта «Отправка запроса» добавьте к сформированному адресу параметр response_format=json. Заголовок Accept: application/json сам по себе не включает подробный ответ. Этот параметр относится к обычному приёмнику заявок с сайта; webhook-адреса конструкторов могут возвращать другой ответ.

{
  "status": "created",
  "req_id": 12345,
  "student_id": 67890,
  "deal_id": 12,
  "reason": null
}

• 201, status: created - создана новая заявка; ответ содержит её номер, ID ученика и воронки.
• 200, status: existing - использована активная заявка в выбранной воронке; reason: active_request_in_funnel.
• 403, status: rejected - неверные данные доступа (invalid_credentials) или сайт не разрешён (site_not_allowed).
• 404, status: rejected, reason: company_not_found - компания не найдена.
• 422, status: rejected - проверьте данные по reason: invalid_name, empty_contact, funnel_not_found, funnel_has_no_statuses, channel_not_found или student_not_found.
• 409, status: rejected, reason: request_in_progress - совпадающий запрос или заявка этого ученика в выбранной воронке сейчас обрабатывается. Повторите отправку после завершения обработки.

Без нового параметра сохраняется прежний ответ: перенаправление обратно на сайт либо {"status":"success"} при json=1. Прежний короткий ответ не подтверждает создание новой заявки. При status: rejected поля идентификаторов подробного ответа пусты.

Уведомления об изменениях заявки на вашем сайте

1. Под директором откройте Настройки → Заявки и найдите Вебхук при изменении статуса заявки.
2. Укажите публичный HTTP/HTTPS-адрес обработчика на сервере вашего сайта.
3. Выберите нужные события и, при необходимости, расширенные данные и повторы доставки.
4. Нажмите Сохранить под галочками. Если повторы недоступны, попросите администратора AXKED настроить обработку очереди.

В настройках компании найдите «Вебхук при изменении статуса заявки», укажите публичный URL своего сервера и сохраните его. Настройки сохраняет директор компании. При смене этапа сохраняется прежний GET-запрос с полями id, name, channel, status, phone, email, worker, comment.

Дополнительные события включаются отдельными галочками: создание заявки, закрытие с согласием или отказом и возврат в работу. Они изначально выключены. Нажмите «Сохранить» после выбора галочек. Уведомление о создании отправляется после появления начальной истории заявки; при работе через сайт - после завершения HTTP-ответа. Вебхуки отдельных этапов воронки продолжают работать по своим настройкам.

Это общий адрес компании: он получает включённые события заявок из разных воронок и источников, а не только из одной формы сайта. Сопоставляйте номер req_id ответа приёмника с полем id уведомления, а воронку определяйте по deal_id расширенных данных. Для события создания достаточно галочки При создании заявки у общего вебхука; отдельно включать вебхук первого этапа для этого не требуется.

Новые события содержат event со значением created, closed или reopened, а также event_id, occurred_at, company_id, student_id, deal_id, status_id, request_state, result, cause, req_comment. Поле status по-прежнему содержит название этапа. Итог закрытия передаётся отдельно: result=agreed или result=refused; для активной заявки result пуст. Поле cause содержит причину отказа.

comment содержит комментарий к последнему переходу в этап, а req_comment - комментарий самой заявки. Чтобы получать дополнительные поля и для обычной смены этапа, включите «Расширенные данные при смене этапа»; её событие называется status_changed. Без этой галочки набор полей прежнего уведомления не расширяется.

Галочка «Повторять отправку при ошибках доставки» включает отправку через настроенную очередь заданий: максимум четыре попытки с паузами 1, 5 и 15 минут. Повторяются сетевые ошибки, ошибки сервера и ответы 408/429; остальные ответы 4xx завершают доставку без повторов. Успешным считается HTTP-ответ 2xx. Очередь и её обработчик должны быть настроены администратором. Без галочки выполняется одна попытка; ошибка вашего сервера не отменяет операцию с заявкой в CRM.

Уведомления могут повторяться и приходить с задержкой или в другом порядке. Повторные попытки расширенного уведомления сохраняют один event_id и исходные данные; для времени события используется occurred_at в UTC. Настройте на своём сервере обработку повторов и более старых событий. Отключение URL или изменение адреса отменяет ожидающие отправки на прежний адрес; снятие галочки события или повторов отменяет соответствующие ожидающие задания.

Пример уведомления о закрытии

Данные передаются параметрами GET-запроса, а не JSON-телом. Ниже показан фрагмент параметров после разбора строки запроса на вашем сервере; значения вымышлены.

{
  "id": "12345",
  "event": "closed",
  "event_id": "00000000-0000-4000-8000-000000000001",
  "occurred_at": "2026-10-23T09:30:00.000000Z",
  "deal_id": "12",
  "status": "Консультация",
  "request_state": "agreed",
  "result": "agreed",
  "comment": "Комментарий к переходу в этап",
  "req_comment": "Первоначальный текст обращения"
}

Обработчик должен сохранить событие и вернуть HTTP 2xx. При повторе с тем же event_id не выполняйте бизнес-действие повторно, но подтвердите приём тем же успешным кодом. occurred_at помогает учитывать задержавшиеся события. Если действие одновременно меняет этап и возвращает заявку в работу, могут прийти разные события: различайте их по event и event_id.

Галочки влияют на новые отправки; ранее пропущенные события автоматически не досылаются. Проверяйте создание, согласие, отказ и возврат на тестовой заявке после сохранения настроек.

Как проверить подключение

1. Опубликуйте форму или сохраните webhook.
2. Отправьте тестовую заявку с уникальным телефоном или электронной почтой.
3. Откройте раздел Заявки и выберите настроенную воронку.
4. Найдите обращение по контактным данным.
5. Проверьте канал, филиал, начальный статус и переданные данные.

Если заявка не появилась

• проверьте, что форма передаёт имя, телефон или электронную почту;
• для обычной HTML-формы проверьте домен в списке Доступные сайты;
• для конструктора повторно скопируйте адрес из блока с названием нужного сервиса;
• проверьте выбранные воронку и канал;
• для обычной формы и «Отправки запроса» проверьте активную заявку в выбранной воронке и комментарии карточки ученика: повторное сообщение могло сохраниться там.

Связанные инструкции

Как работать с заявками в AXKED CRM

Настройка статусов и автоматизаций воронки

Доступ к REST API V2

Учёт оплат внешнего сайта