Настройка вебхука

Заводит отправку ответов на ваш адрес и сразу проверяет, что приёмник их принял

WebAsk v1.0БесплатноGitHub

Скачать навык

Вы пишете

Настрой отправку ответов на наш сервер вебхуком

Ассистент собирает

3
полей: нет
незавершённые: 47
доставок: 0
ошибок

https://crm.example.com/hooks/webask метод post
phone ← «Ваш телефон» переименование поля
rating ← «Насколько вы довольны?» переименование поля
Authorization: ****** заголовок
Последняя доставка 10 сентября 14:02

Ответы — прямо в вашу систему. Доставка проверена сразу. Ключи доступа — не в чате.

Как работает

Сначала смотрит, что уже настроено
Спрашивает четыре вещи, без которых нельзя
Бережно с незавершёнными
Проверяет доставку сразу

Не создавать второй вебхук на тот же адресНе слать все вопросы подрядНе просить человека продиктовать ключи доступа в чатНе включать вебхук, который выключили намеренноНе предлагать смену тарифа и не вести на оплату

Попробуйте ещё

Пусть телефон из опроса уходит в CRM как поле phone
Проверь, доходят ли ответы по вебхуку

Открытый кодтекст навыка на GitHub, лицензия MIT
Доступ — у васработает по вашему ключу, отозвать можно в любой момент
9 инструментов 4 только читают, 5 меняют — такие помечены для подтверждения
Бесплатнонавык — обычный файл, скачивается без регистрации

Коротко о главном

Вебхуки доступны на моём тарифе?

Навык проверит это первым делом: вебхуки входят не во все тарифы. Если недоступны — скажет сразу и остановится.

Что нужно сообщить для настройки?

Четыре вещи: адрес — только https, метод — почти всегда POST, какие поля слать и как их называть в вашей системе.

Можно назвать поля так, как ждёт моя система?

Да: если система ждёт phone, а вопрос называется «Ваш телефон», навык переименует поле при отправке. В опросе вопрос останется как был.

Будут ли уходить брошенные прохождения?

По умолчанию — только завершённые. Если нужны и брошенные, навык настроит их отправку с задержкой в 1, 6, 12 или 24 часа — иначе человек, вернувшийся дописать анкету, придёт дважды.

Как понять, что вебхук работает?

Сразу после создания навык смотрит журнал доставки: 200 — работает, 4xx — приёмник не принял, 5xx — ошибка на его стороне. Пустой журнал — ответов ещё не было.

Как передать ключ доступа к моей системе?

Не диктуйте его в чат: ключи вписываются в заголовки вебхука в кабинете. В ответах сервера значения заголовков скрыты звёздочками.

Что будет, если попросить поправить адрес?

Навык предупредит: правка перезаписывает вебхук целиком, включая заголовки, — их нужно будет указать заново. На время правок вебхук лучше выключить, а не удалять.

Что нужно, чтобы заработало?

Аккаунт WebAsk, ключ API / MCP и ассистент с поддержкой MCP: Claude, Cursor, VS Code, Codex или Gemini CLI. И приёмник по https, который отвечает кодом 2xx.

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

1 Создайте ключ
В кабинете WebAsk: Настройки → API / MCP. Ключ показывается один раз.
2 Подключите сервер
Добавьте в настройках ассистента адрес:

https://mcp.webask.io/mcp/v1
3 Добавьте навык
Скачайте архив и распакуйте в папку навыков:

.agents/skills/webask-webhook-setup/