ServiceTitan и Jobber
Всплывающее окно звонящего показывает клиента, его открытые заказы и техника на каждом заказе; ИИ-агент может искать клиентов и заказы, открывать заказ и сообщать, где техник. Устанавливается как любая интеграция (Админ, Интеграции). Код: pbx/crates/integrations/src/fieldservice/, по одному файлу регистрации на поставщика в src/connectors/. Собственной таблицы нет: заказы остаются у поставщика.
Установка
| Коннектор | Настройки | Секреты | Аутентификация |
|---|---|---|---|
servicetitan | id тенанта, 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)'.