Woove Woove Connect Связки API и Ветменеджер

Связка · API и Ветменеджер

Интеграция Ветменеджера по API

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

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

Врач разговаривает с пациенткой

Заявка · API14:02

APIМартынова Елена, +7 912 345-67-89
Woove Connect8 полей разобрано, повторов нет
ВетменеджерЗаявка с сайта клиники становится записью на приём

Поля

Что уходит в Ветменеджер

Телефон владельца обязателен. Имя разбираем как фамилию, имя и отчество. Кличка питомца берётся из отдельного поля формы: если его нет, приём создаётся на владельца, а питомца заводит администратор.

В Ветменеджере появляются три записи.

В API
В Ветменеджер
Пример
Name
client.last_name
Мартынова
Name
client.first_name
Елена
Phone
client.cell_phone
+7 912 345-67-89
Email
client.email
e.martynova@example.ru
Pet
pet.alias
Барсик
Date и Time
admission.admission_date
2026-10-14 10:00:00
все поля формы текстом
client.note
Name: Мартынова Елена · Phone: +7 912 345-67-89 · Email: e.martynova@example.ru · Commen…
все поля формы текстом
admission.description
Name: Мартынова Елена · Phone: +7 912 345-67-89 · Email: e.martynova@example.ru · Commen…

Из настройки интеграции: admission.reception_write_channel, admission.admission_length.

Запрос к Woove
curl -X POST https://woove.ru/hook/api/<ваш ключ> \
  -H 'Content-Type: application/json' \
  -d '{
    "Name": "Мартынова Елена",
    "Phone": "+7 912 345-67-89",
    "Email": "e.martynova@example.ru",
    "Comment": "Плановая прививка",
    "Pet": "Барсик",
    "Date": "2026-10-14",
    "Time": "10:00",
    "tranid": "order-1001"
  }'
Текст заявки в Ветменеджер · client.note
Name: Мартынова Елена Phone: +7 912 345-67-89 Email: e.martynova@example.ru Comment: Плановая прививка Pet: Барсик Date: 2026-10-14 Time: 10:00

Обязательно

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

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

Телефон

Без него заявка не уйдёт в Ветменеджер. Передавайте поле "Phone" в каждом запросе.

Подключение

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

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

  1. Доступ в Ветменеджер

    Домен клиники и ключ REST API из настроек Ветменеджера.

    • Зайдите в программу под пользователем с ролью «Админы»
    • Настройки → Интеграция с сервисами → Rest Api → нажмите ВКЛ и «редактировать», там же ключ
    • Доступ к REST API входит во все тарифы Ветменеджера, отдельно платить не нужно
    • Домен клиники — то, что стоит до точки в адресе вашей программы. Настоящий адрес сервера мы узнаём сами
    • Номер клиники нужен, если клиник несколько; номера типа приёма и врача можно оставить пустыми

    Где взять доступ к Ветменеджер

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

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

    Для Ветменеджера добавьте в JSON:

    • поле "Pet"
    • поле "Date"
    • поле "Time"
  4. Поля формы

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

    Менять ничего не нужно: имена полей совпадают с теми, что Woove ждёт по умолчанию.

  5. Проверка

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

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

Ошибки

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

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

API → Ветменеджер

Не разобрано: нужен телефон владельца

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

API

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

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

Ветменеджер

«Ветменеджер не принял ключ»

Включите Rest Api в разделе «Настройки → Интеграция с сервисами» и скопируйте ключ заново. Если Rest Api выключен, сервис молча переадресует запрос на страницу входа.

Ветменеджер

«Ветменеджер не знает домен»

В поле домена нужно только имя клиники до точки, без https и без пути. Настоящий адрес сервера мы узнаём сами.

Вопросы

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

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

Какие поля нужны для Ветменеджера?

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

Куда в Ветменеджер попадёт поле Comment?

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

Сколько стоит связка API и Ветменеджер?

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

Начало

Заявки из вашего кода в Ветменеджер

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

Врач разговаривает с пациенткой