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

Связка · API и Discord

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

Заявки из вашего кода уходят в Discord без ручного переноса. Заявка падает сообщением в канал.

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

Мужчина улыбается

Заявка · API14:02

APIКирилл Морозов, +7 962 118-27-93
Woove Connect5 полей разобрано, повторов нет
DiscordЗаявка падает сообщением в канал

Поля

Что уходит в Discord

Никаких полей кроме адреса вебхука не нужно. Заголовок сообщения можно поменять под себя.

В канал Discord прилетает карточка-embed с заголовком из настройки.

В API
В Discord
Пример
Name
embeds[0].fields[name=Имя].value
Кирилл Морозов
Phone
embeds[0].fields[name=Телефон].value
+7 962 118-27-93
Email
embeds[0].fields[name=Почта].value
kirill.m@example.ru
Comment
embeds[0].fields[name=Комментарий].value
Команда из пяти человек

Из настройки интеграции: username, embeds[0].title, embeds[0].timestamp.

Запрос в Discord: POST https://discord.com/api/webhooks/1234567/….

Запрос к Woove
curl -X POST https://woove.ru/hook/api/<ваш ключ> \
  -H 'Content-Type: application/json' \
  -d '{
    "Name": "Кирилл Морозов",
    "Phone": "+7 962 118-27-93",
    "Email": "kirill.m@example.ru",
    "Comment": "Команда из пяти человек",
    "tranid": "order-1001"
  }'

Обязательно

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

У Discord нет обязательных полей формы.

Обязательных полей нет

Заявка уйдёт в Discord с любым набором полей. Имя и телефон всё равно стоит спрашивать: без них некому перезвонить.

Подключение

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

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

  1. Доступ в Discord

    Webhook-адрес канала Discord из настроек канала.

    • Откройте настройки нужного канала — шестерёнка рядом с названием
    • Раздел «Интеграции» → «Вебхуки»
    • Создайте вебхук и нажмите «Копировать URL»
    • Ключей заводить не нужно

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

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

    В кабинете откройте «Connect» и подключите Discord. На вкладке «Настройка» в поле «Источник заявок» выберите «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. Проверка

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

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

Ошибки

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

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

API

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

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

Discord

Сообщения перестали приходить

Вебхук удалён или канал перенесён. Создайте вебхук заново: шестерёнка канала → Интеграции → Вебхуки.

Discord

Хочу другое имя и аватар отправителя

Имя отправителя всегда «Woove»: его задаём мы при отправке. Аватар меняется в настройках вебхука в Discord. Заголовок сообщения меняется на вкладке «Настройка», в поле «Заголовок сообщения».

Вопросы

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

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

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

Обязательных полей нет: Discord примет заявку с любым набором полей.

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

В поле embeds[0].fields[name=Комментарий].value: «Команда из пяти человек».

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

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

Начало

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

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

Мужчина улыбается