Передача заказа в производство

POST /v1/conversations/{id}/handoff
{ "seat": "Цех на Ленина" }

Ради этого всё и затевалось: лид приходит в производство собранным заказом, а не текстом переписки, который менеджер пересказывает конструктору.

Что происходит на самом деле

Заказ разговора ложится строкой на рабочее место мебельной компании и появляется карточкой в её кабинете — ровно так же, как появляется заказ после удачного хода самого проектировщика. Проектировщик открывает карточку, видит состав, чертёж и расход и продолжает работу своими средствами.

{ "ok": true, "handoff": {
  "seat_id": 5, "seat_title": "Цех на Ленина",
  "order_id": "кухня-иванов", "turn": 3 } }

Чего эта ручка НЕ делает

Она не кладёт мебель в модель Базис-Мебельщика. Класть туда может только агент, запущенный на машине проектировщика при открытом Базисе; сервер сам в чужую программу ничего не записывает и записать не может.

Говорим об этом прямо, чтобы вы не строили на этом обещание клиенту: /handoff кладёт заказ проектировщику на стол, а собирает его в модели он — своим ходом, когда сядет за работу.

seat — это место, а не человек

seat — id рабочего места или его название, как оно записано в кабинете мебельной компании («Цех на Ленина», «Замерщик», «Иван»). Спросите список у компании один раз и держите его у себя в настройках.

Место чужой учётной записи или отозванное отвечает 403. Это защита по построению: список мест берётся из учётной записи, на которую выдан ваш ключ, и места из него просто не существует для вашего запроса.

Повторная передача

Передавать один и тот же разговор можно сколько угодно: строка на паре «место + заказ» одна, и каждая передача её обновляет. Разговор, у которого после передачи было ещё три хода, передайте заново — проектировщик увидит свежий состав.

Хотите держать на месте два варианта — передайте второй раз с другим order_id:

{ "seat": "Цех на Ленина", "order_id": "кухня-иванов-вариант-2" }

Когда передавать

Разумная граница — когда клиент сказал «да, примерно так»: состав собран, техника названа, стены известны. Ходы после передачи ничему не мешают — просто передайте ещё раз.

Передать разговор, в котором ничего не собрано, нельзя: 400.