Skip to main content

Creationless Inspections

Crea inspecciones de forma automática compartiendo un enlace con tus usuarios sin necesidad de consumir Autoinspector API

Funcionamiento

La idea principal de este flujo es delegar la creación de la inspección a la app de inspección mediante un enlace que permite identificar a la plantilla y recibir información relacionada al flujo/inspección que se desea crear.

La estructura de este enlace es la siguiente:

  • Template ID: Es el identificador único de la plantilla que se desea usar para crear la inspección
  • Inspection Data: Un search param opcional (si la plantilla requiere de algunos campos requeridos en la creación, sera requerido) en donde se envía la data de la inspección (datos del cliente, locale, respuesta a campos personalizados de la plantilla, etc) en el formato base64 json encoded. El contrato que se espera en este parámetro es el mismo que el de crear inspección
  • Idempotency Key: Un search param opcional en donde se envía una clave unica que no sobrepasa los 255 caracteres que permite la idempotencia al momento de crear la inspección. Esto quiere decir que la inspección que se creara al principio tendrá una relación con esta clave, por lo que en las visitas subsecuentes no se creara una nueva inspección, si no que se redireccionara a la inspección creada al principio. Para conocer mas a detalle el concepto idempotencia, te recomendamos leer la sección Idempotencia
tip

Para codificar el json con la información de la inspección acorde al contrato esperado, te recomendamos usar la librería estándar del lenguaje de programación que vas a usar. En el caso de javascript, te recomendamos usar window.btoa(inspectionData)

Requerimientos

Para implementar este flujo, es necesario que la plantilla que deseas usar para crear la inspección se trate de una plantilla propia (no una plantilla nativa ofrecida por Autoinspector) y que este activada la opción de "Permitir creación automática"

Para activar esta opción, debes dirigirte a la sección Configuración dentro del estudio:

Advertencias

Es importante saber que este flujo esta pensado para aquellas integraciones que no tienen demasiado control de su plataforma, por lo que se les hace complicado realizar una integración nativa y mas segura (server to server communication)

Con este tipo de flujo, hay una mayor probabilidad de un incremento en la cantidad de inspecciones creadas y que su cuenta cuente con inspecciones "fantasmas" (sin contenido alguno) debido a la naturalidad y facilidad con la que se puede crear una inspección

Al activar esta opción en una plantilla, el link generado es publico (cualquiera que tenga acceso a el podrá disparar una inspección), por lo que es importante que la integración sea precavido en que lugares propaga este link

A pesar de lo mencionado anteriormente, usted puede desactivar esta opción en cualquier momento. Desde el momento en que la opción se encuentra desactivada, Autoinspector no permitirá la creación de nuevas inspecciones mediante este flujo