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
| Conector | Ajustes | Secretos | Autenticación |
|---|---|---|---|
servicetitan | id de tenant, client id, ids de unidad de negocio / tipo de trabajo / campaña (necesarios para crear trabajos), interruptor de sandbox | client secret, llave de app (ST-App-Key) | client credentials, el token se guarda en memoria hasta un minuto antes de vencer |
jobber | ninguno (interruptor de trabajo por llamada perdida) | ninguno | conexió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)'.