Saltar al contenido principal

ServiceTitan y Jobber

La ventana emergente de quien llama muestra al cliente, sus trabajos abiertos y qué técnico atiende cada uno; el agente de IA puede buscar clientes y trabajos, abrir un trabajo y decir dónde está el técnico. Se instala como cualquier integración (Admin, Integraciones). Código: pbx/crates/integrations/src/fieldservice/, un archivo de registro por proveedor en src/connectors/. No tiene tabla propia: los trabajos se quedan en el proveedor.

Instalación​

ConectorAjustesSecretosAutenticación
servicetitanid de tenant, client id, ids de unidad de negocio / tipo de trabajo / campaña (necesarios para crear trabajos), interruptor de sandboxclient secret, llave de app (ST-App-Key)client credentials, el token se guarda en memoria hasta un minuto antes de vencer
jobberninguno (interruptor de trabajo por llamada perdida)ningunoconexión OAuth (oauth_connections): Conectar inicia sesión en Jobber, MonoPbx guarda y rota el refresh token. Una instalación hecha antes del framework conserva su propio client id, secret y refresh token (rotado solo en memoria) hasta que se conecte

Ambos necesitan la app de socio/desarrollador del proveedor (trabajo del propietario). "Probar conexión" obtiene un token y lee un cliente (ServiceTitan) o la cuenta (Jobber).

Qué hace​

  • Ventana emergente (búsqueda de quien llama por E.164): nombre del cliente, correo, número de trabajos abiertos y, para los primeros tres trabajos abiertos, "técnico <nombre> (<scheduled|dispatched|working|done>)". Los trabajos terminados y los cancelados o archivados no se listan.
  • Herramientas de IA (int_<connector>_<tool>, lista de permitidos por instalación): find_customer (teléfono, correo o nombre), list_open_jobs, create_job (id de cliente o el teléfono de quien llama; la misma solicitud en 10 minutos es el mismo trabajo), technician_status (técnico, estado, ventana de visita).
  • Trabajo desde una llamada: con "abrir un trabajo por llamada perdida o mensaje de voz" activado, una llamada entrante sin contestar o un mensaje de voz de un cliente conocido abre un trabajo (resumen, resumen de IA y enlace a la grabación en el trabajo). Los números desconocidos nunca crean un trabajo, y un registro de llamada reenviado nunca crea un segundo.

Notas​

  • ServiceTitan necesita una cita para crear un trabajo: el trabajo recibe una ventana provisional (mañana 08:00-12:00 UTC) para que el despachador la mueva. Se usa la primera ubicación activa del cliente.
  • Todos los valores llegan a Jobber como variables GraphQL; los ids se validan antes de entrar a una ruta.
  • Las llamadas salientes pasan solo por el cliente de salida protegido; las pruebas usan un simulacro grabado.
  • Pruebas: cargo nextest run -p mpbx-integrations -E 'test(servicetitan) | test(jobber)'.