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

Связка · API и ClickUp

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

Заявки из вашего кода уходят в ClickUp без ручного переноса. Заявка становится задачей в списке.

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

Коллеги радуются успеху в офисе

Заявка · API14:02

APIАлина Захарова, +7 910 257-83-60
Woove Connect5 полей разобрано, повторов нет
ClickUpЗаявка становится задачей в списке

Поля

Что уходит в ClickUp

Задача создаётся в конкретном списке — его идентификатор виден в адресе, когда список открыт. Имя и телефон уходят в название и описание.

В ClickUp создаётся задача в указанном списке.

В API
В ClickUp
Пример
Name
nameв составе строки
Заявка: Алина Захарова
все поля формы текстом
description
Name: Алина Захарова · Phone: +7 910 257-83-60 · Email: alina.z@example.ru · Comment: Ср…

Из настройки интеграции: tags[0].

Запрос в ClickUp: POST https://api.clickup.com/api/v2/list/901234567/task.

Запрос к Woove
curl -X POST https://woove.ru/hook/api/<ваш ключ> \
  -H 'Content-Type: application/json' \
  -d '{
    "Name": "Алина Захарова",
    "Phone": "+7 910 257-83-60",
    "Email": "alina.z@example.ru",
    "Comment": "Срок до конца месяца",
    "tranid": "order-1001"
  }'
Текст заявки в ClickUp · description
Name: Алина Захарова Phone: +7 910 257-83-60 Email: alina.z@example.ru Comment: Срок до конца месяца

Обязательно

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

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

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

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

Подключение

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

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

  1. Доступ в ClickUp

    Personal API token ClickUp и идентификатор списка.

    • ClickUp → Settings → Apps
    • Раздел API Token → Generate, токен начинается с pk_
    • Идентификатор списка виден в адресе, когда список открыт

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

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

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

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

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

Ошибки

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

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

API

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

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

ClickUp

ClickUp отвечает «team not authorized»

Токен pk_ выдан пользователю без доступа к нужному пространству. Дайте доступ или создайте токен от другого пользователя.

ClickUp

Задача создаётся не в том списке

Идентификатор списка — число в адресе после /li/. Номер папки или пространства не подойдёт.

Вопросы

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

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

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

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

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

Вместе с остальными полями формы, одним текстом в description. Каждое поле идёт своей строкой: подпись и значение.

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

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

Начало

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

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

Коллеги радуются успеху в офисе