Перейти к основному содержимому

ServiceTitan и Jobber

Всплывающее окно звонящего показывает клиента, его открытые заказы и техника на каждом заказе; ИИ-агент может искать клиентов и заказы, открывать заказ и сообщать, где техник. Устанавливается как любая интеграция (Админ, Интеграции). Код: pbx/crates/integrations/src/fieldservice/, по одному файлу регистрации на поставщика в src/connectors/. Собственной таблицы нет: заказы остаются у поставщика.

Установка​

КоннекторНастройкиСекретыАутентификация
servicetitanid тенанта, client id, id бизнес-подразделения / типа заказа / кампании (нужны для создания заказов), переключатель песочницыclient secret, ключ приложения (ST-App-Key)client credentials, токен хранится в памяти до минуты до истечения
jobberнет (переключатель «заказ по пропущенному звонку»)нетподключение OAuth (oauth_connections): «Подключить» выполняет вход в Jobber, MonoPbx хранит и ротирует refresh token. Установка, сделанная до появления фреймворка, хранит собственные client id, secret и refresh token (ротация только в памяти), пока её не подключат

Обоим нужно партнёрское/разработческое приложение поставщика (работа владельца). «Проверить подключение» получает токен и читает одного клиента (ServiceTitan) или аккаунт (Jobber).

Что делает​

  • Всплывающее окно (поиск звонящего по E.164): имя клиента, e-mail, число открытых заказов и для первых трёх открытых заказов «техник <имя> (<scheduled|dispatched|working|done>)». Завершённые и отменённые/архивные заказы не показываются.
  • Инструменты ИИ (int_<connector>_<tool>, список разрешённых для каждой установки): find_customer (телефон, e-mail или имя), list_open_jobs, create_job (id клиента или телефон звонящего; тот же запрос в течение 10 минут — тот же заказ), technician_status (техник, состояние, окно визита).
  • Заказ из звонка: при включённом «открывать заказ по пропущенному звонку или голосовому сообщению» неотвеченный входящий звонок или голосовое сообщение известного клиента открывает один заказ (описание, ИИ-сводка и ссылка на запись в заказе). Неизвестные номера никогда не создают заказ, а повторно доставленный журнал звонка не создаёт второй.

Примечания​

  • ServiceTitan требует назначенное время для создания заказа: заказ получает временное окно-заглушку (завтра 08:00–12:00 UTC), которое диспетчер переносит. Используется первая активная локация клиента.
  • Все значения передаются в Jobber как переменные GraphQL; идентификаторы проверяются перед подстановкой в путь.
  • Исходящие вызовы идут только через защищённый клиент исходящего трафика; тесты используют записанную имитацию.
  • Тесты: cargo nextest run -p mpbx-integrations -E 'test(servicetitan) | test(jobber)'.