Una vez configurado, cada vez que marques un trabajo como Completado en ServiceTitan, se envía automáticamente una solicitud de reseña al cliente. La reseña que regresa se asigna al técnico que realizó el trabajo.

La configuración se divide en tres pasos, en este orden:

Al finalizar, tienes cuatro credenciales. Tres son obligatorias. Mantén un bloc de notas abierto mientras avanzas.

Necesitas dos permisos habilitados en tu usuario de ServiceTitan, y un administrador en tu equipo debe habilitarlos:

Si no tienes esos permisos, el portal de desarrolladores no te dejará entrar. Esto es obligatorio por parte de ServiceTitan.

También necesitas una cuenta de Reviewflowz en un plan que incluya la integración y atribución de técnicos, así como créditos de SMS si deseas enviar mensajes de texto en lugar de correos. Puedes configurar todo a continuación y agregar la facturación más tarde. Nada se envía hasta que actives la campaña.

El ID de inquilino identifica tu cuenta de ServiceTitan. Si gestionas más de una empresa en ServiceTitan, cada una tiene su propio ID y necesita su propia configuración.

Deja esta pestaña abierta. Volverás a ella en la Parte 3, y verás el número nuevamente bajo la etiqueta Valor permitido de "inquilino", para confirmar que copiaste el correcto.

Este paso suele complicar un poco, así que lee toda la sección antes de hacer nada.

Ve a developer.servicetitan.io e inicia sesión. La pantalla de inicio te ofrece cuatro botones en dos columnas. Selecciona la columna de la derecha: Clientes de ServiceTitan, y el botón que dice Iniciar sesión como usuario del entorno de producción. Los botones de entorno de integración llevan a un sandbox que no puede ver tus trabajos reales.

Inicia sesión con tus credenciales de ServiceTitan. Los inicios de sesión de Enterprise Hub y Partner Portal no funcionan aquí; debe ser un inicio de sesión de usuario de ServiceTitan.

En Mis Aplicaciones, haz clic en Registrar nueva aplicación, responde a la pregunta que te hace ServiceTitan y llegarás al formulario de registro. Los Detalles del desarrollador en la parte superior describen el software con el que la aplicación se comunica, que somos nosotros, así que complétalos así:

El campo del sitio web necesita el https:// completo al frente. Si pegas www.reviewflowz.com solo, el formulario lo rechazará.

Detalles de la aplicación que están más abajo se refieren a la aplicación en sí. Dale un nombre que puedas reconocer más tarde, por ejemplo Reviewflowz. La descripción, la pregunta de construir y mantener y la categoría no cambian lo que puede hacer la aplicación, así que responde de manera sencilla. Haz clic en Generar en el GUID de la aplicación de datos externos.

Más abajo en el mismo formulario está APIs de inquilinos. Agrega el ID de inquilino que copiaste en la Parte 1, luego haz clic en Agregar alcances de API.

Elige estos cinco:

El acceso de solo lectura es suficiente. Reviewflowz nunca escribe nada en ServiceTitan. Cada uno de los cinco tiene una función específica, y faltar uno no romperá la conexión, simplemente eliminará una característica:

La primera empresa que conectamos no incluyó el alcance de Ubicaciones y perdieron todos los contactos el primer día. Marca los cinco.

Guarda la aplicación. En Mis Aplicaciones, cada fila tiene tres iconos bajo Acciones. El lápiz abre la aplicación para editarla, y allí está la Clave de Aplicación. Cópiala. Esa es la credencial número dos.

La clave de aplicación identifica la aplicación, no tu cuenta. No cambia cuando agregas inquilinos, y es la misma en los entornos de integración y producción.

El ID de cliente y el secreto de cliente no existen inicialmente. Solo se crean cuando tu cuenta de ServiceTitan concede acceso a la aplicación, por lo que este paso debe realizarse después de la Parte 2.

En ServiceTitan, ve a Configuración, busca Integraciones y abre Acceso de Aplicación API. Esta es la misma página de donde sacaste tu ID de inquilino en la Parte 1, y enumera todas las aplicaciones que ya tienen acceso a tus datos.

Haz clic en Conectar nueva aplicación. Tu aplicación debería aparecer en la lista. Si la lista está vacía, la aplicación no tiene tu ID de inquilino, así que vuelve y agrégalo.

Selecciona y haz clic en Conectar. ServiceTitan te muestra los alcances que la aplicación está solicitando y luego los apruebas. La aplicación obtiene entonces su propia página de detalles, la cual debes revisar. El Valor permitido de "inquilino" en ella es tu ID de inquilino, con un botón de Copiar al lado para que, si la Parte 1 te dejó dudas, aquí puedes confirmar que tenías el número correcto. Más abajo, Tiene acceso a enumera exactamente a qué tiene acceso la aplicación.

Regresa al portal de desarrolladores, a Mis Aplicaciones. En la fila de tu aplicación, haz clic en el icono del medio, el que parece un enlace de cadena. Es App Connections, y no está bien señalizado.

App Connections muestra una fila por cada inquilino conectado a tu aplicación. La fila incluye el ID de inquilino/red, el ID de cliente, y un botón Generar para el Secreto de cliente.

Copia el ID de cliente. Haz clic en Generar y copia el secreto de inmediato, ya que solo se muestra una vez. Trátalo como una contraseña: pégalo en Reviewflowz y en ningún otro lugar. Lo almacenamos encriptado y nunca te lo mostramos de vuelta.

Revisamos las credenciales y luego verificamos el ID de inquilino por separado, así que el mensaje de error te dirá cuál de los dos está incorrecto:

Cuando todo funciona, la tarjeta se vuelve verde y muestra cuántos trabajos completaste en los últimos 30 días. Ese conteo es la prueba de que realmente podemos leer tus datos.

Luego importamos tu historial de trabajos completados. Estos trabajos anteriores se utilizan para clasificar a tus técnicos de inmediato, y ninguno de ellos recibe una solicitud de reseña. Solo los trabajos completados después de que conectes se enviarán.

Omite esto si gestionas un solo lugar.

En el panel de configuración de ServiceTitan, bajo Ubicaciones, elige cómo decidimos cuál de tus ubicaciones llevó a cabo el trabajo:

Configura también Fallback to. Esa es la ubicación que usamos cuando la unidad de negocio no está vinculada y la dirección no coloca al cliente cerca de nada.

Si la lista de unidades de negocio está vacía, completa un trabajo en ServiceTitan y presiona Actualizar lista.

La conexión creó una campaña borrador llamada Solicitudes de reseñas de ServiceTitan. No se envía hasta que la actives.

Desde ese momento en adelante funciona por sí solo. Un trabajo completado se convierte en un contacto en Solicitudes, y la solicitud se envía después del tiempo de retardo configurado.

Verificamos ServiceTitan para trabajos completados cada 15 minutos. ServiceTitan no ofrece webhooks para nuevas aplicaciones, así que nadie nos avisa del evento, y el método recomendado por ServiceTitan es consultar cada cierto tiempo. Espere la solicitud unos 15 minutos después de que se cierre el trabajo, más cualquier retardo que configures.

Solo el estado Completado activa una solicitud. Los estados Programado, Despachado, En progreso, En espera y Cancelado no lo hacen.

La aplicación falta en Conectar nueva aplicación. Tu ID de inquilino no está en la aplicación. Ve al portal de desarrolladores, Mis Aplicaciones, edita la aplicación, sección de Inquilinos.

Todo está conectado pero no se envían solicitudes. Verifica tres cosas en orden: que la campaña está activa y no en borrador, que el estado del trabajo en ServiceTitan es Completado, y que el trabajo se completó después de que te conectaste. Los trabajos completados antes de conectarte se importan solo para informes y nunca se envían mensajes.

Las sucursales se muestran como números. Falta el alcance de las Unidades de Negocio en tu aplicación. Agrégalo en el portal de desarrolladores, luego presiona Actualizar lista en la tarjeta de Ubicaciones.

Las reseñas no se están acreditando a los técnicos. Falta el alcance de Asignaciones de Citas. Un trabajo con varios técnicos acredita a cada uno de ellos, así que si falta un técnico en lugar de todos, es la asignación en ServiceTitan la que está incompleta, no el alcance.

Regeneraste el Secreto de Cliente. Regenerarlo invalida el anterior. Pega el nuevo secreto en Reviewflowz, o la sincronización se detiene.