Deepomatic Platform
  • Overview
  • Release notes
    • May 2025
    • January 2025
    • November 21, 2024
    • October 17, 2024
    • September 19, 2024
    • July 18, 2024
    • June 27, 2024
    • May 23, 2024
    • April 18, 2024
    • March 21, 2024
    • February 22, 2024
    • January 18, 2024
    • December 13, 2023
    • October 26, 2023
    • July 20, 2023
    • June 29, 2023
    • May 29, 2023
    • April 27, 2023
    • March 30, 2023
    • February 17, 2023
    • January 19, 2023
    • December 22, 2022
    • November 18, 2022
    • October 19, 2022
    • September 19, 2022
    • July 27, 2022
    • June 26, 2022
    • May 17, 2022
    • April 13, 2022
    • March 17, 2022
    • February 10, 2022
    • December 21, 2021
    • October 26, 2021
  • Getting started
  • ADMIN & USER MANAGEMENT
    • Invite and manage users
      • Invite group of users at once
      • SSO
        • OIDC
        • SAML
  • Deepomatic Engage
    • Integrate applications
      • Deepomatic vocabulary
      • Deepomatic connectors
        • Set-up
        • Camera Connector
        • Work Order Connector
      • API integration
        • Authentication
        • Errors
        • API reference
          • Work order management
          • Analysis
            • Guide field workers
            • Perform an analysis
            • Correct an analysis
          • Data retrieval
          • Endpoints' list
      • Batch processing
        • Format
        • Naming conventions
        • Processing
        • Batch status & errors
      • Data export
    • Use the mobile application
      • Configure a mobile application
      • Create & visualize work orders
      • Complete work orders
      • Offline experience
    • Manage your business operations with customisable solutions
      • Roles
      • Alerting
      • Field services
        • Reviewing work orders
        • Exploring work orders
        • Grouping work orders
        • Monitoring assets performance
      • Insights
  • Security
    • Security
    • Data Protection
Powered by GitBook
On this page
  • Token
  • Default callback URI
  • Flow interruption

Was this helpful?

  1. Deepomatic Engage
  2. Integrate applications
  3. Deepomatic connectors

Set-up

Last updated 10 months ago

Was this helpful?

Both connectors work via a URL redirection. The users are redirected from their original application to the Deepomatic interface. After finishing their job in Deepomatic, they can be automatically redirected to their original application.

Three elements are necessary to allow this bi-directional redirection :

  • Token - an authenticator which allows the redirection to the Deepomatic interface.

  • Default callback URI - a static URL on which the users will be automatically redirected after finishing their job in Deepomatic.

  • Flow interruption - defines at which step the flow of the field user is interrupted.

Token

The authentification is token-based, a token will therefore need to be passed at the redirection.

The token is linked to our user management system. A token is bound to a single user, the user rights determine what the user can see based on the permissions of the account. It is possible to have a token for multiple users (considering for example that the account in Deepomatic is a grouping of several users).

The token will be set-up and provided by the Deepomatic team. It is possible to specify an expiration date for a token.

The character & is not supported in the token and the token length must be below 256 characters.

Default callback URI

In order to have a seamless user experience, it is mandatory to provide a default callback URI so the users are sent back to where they were on the field app after they performed their job on the Deepomatic interface.

This URI is static, will be stored in our database and linked to your token. However, when making a redirection you will be able to pass callback URIs as a query parameter to implement more dynamic redirection. The default callback URI is mandatory to ensure that even when no callback URI is provided as a query parameter the users can be redirected to their parent app. More information on the callback URIs as query parameters in this .

For the callback to work with a native app, the schema URI must be registered as being handled by the native app.

Flow interruption

Depending on the desired user flow, it is possible to define when field users will be redirected to their field app. There are three options of flow interruption:

  • BEFORE_ANALYSIS : field users take the photo and are then automatically redirected to their field app without seeing the AI results in Deepomatic.

  • AFTER_ANALYSIS : field users take the photo, see the AI results in Deepomatic and then are redirected to their field app.

  • AFTER_WORK_ORDER : field users are redirected to the field app once they leave the work order page. This option is specific to the Work order connector.

section