Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Easy Find and Replace: {"id":"d3ee58c7-0780-4c6b-bb85-d8accc7047e2","find":"/hamburger menu/i","replace":"menu","search-type":"case-insensitive","replace-title":false}

XOi Deep Linking allows users to click a link in MobileTech to open XOi's Vision app. Within the Vision app, users click a Return button to go back to MobileTech.

Table of Contents

XOi Integration Setup in Schedule

This section displays if you have SEE registered. You will also need to turn on the XOi Deep Linking feature

by XOi Technologies to access a specific API that is used by XOi for the Deep Linking workflow feature. This information must be provided to XOi. (A Schedule Administrator can print the contents of this window from a browser.) The XOi Integration Setup section is conditionally enabled if the See feature is registered for MobileTech, otherwise this tab is hidden. After setting up the integration, two XOi user roles are created and are hidden from the User Roles window. The XOi user is hidden from the User Detail window.

XOi Deep Linking is:

  • Compatible with MobileTech v8 and higher.
  • Available for supported versions of Signature 2016 and Signature 2018.
  • Enabled in Schedule 4.5 and higher.
Excerpt

The XOi Integration Setup in Schedule is used to set up XOi integration password and to view Schedule integration information that needs to be provided to XOi Technologies. If you are not the Administrator setting up the XOi integration, you can print Schedule Integration window from your browser.

Note
Note
titleIMPORTANT

XOi Deep Linking must be first be enabled in MobileTech Admin. See XOi Integration in the MobileTech 8.0 Installation & Administration Guide for more information.

To set up the XOi Integration in Schedule:

  1. In Schedule, select the Hamburger menu  Image Removed and icon and then select Administration.
  2. Select the Integrations tab.
  3. Under Account Detail:
    • User Name
      Displays the user name for the XOi integration.
    • Password
      Enter the XOi password.
    • Comfirm Confirm Password
      Enter your XOi password again. If you've mistyped the password, an error message displays that the passwords don't match.
  4. Under Integration Details, complete the following fields:
    • API UrlURL
      Displays the Schedule API UrlURL
    • Signature Version
      Displays the current Signature major version.
  5. In the Active Dynamics Companies section, all active companies' details (Company Name and Company ID) are shown as more than one company may need to be set up with XOi Technologies.

    Note
    The Active Dynamics Companies list includes all active Dynamics companies that may or may not have Signature and/or Schedule installed.


Overview

With XOi Deep Linking turned on , four read-only notes are attached to the service appointment.

...

and XOi integration set up in Schedule, this is what you can expect to happen with Schedule service appointments. In XOi's Vision app, a job is the same as a service appointment in MobileTech.

  1. A new service call with an appointment is created in Schedule, Signature, or MobileTech. The appointment is assigned to a technician and scheduled.

    Note

    If the service appointment is created in MobileTech, the technician will need to sync their device to send the appointment to the back office. The XOi integration will run and the notes will be added to the appointment in the back office and will be available when the technician syncs again, however it could take a while for the XOi Vision notes to be created (based on the XOi polling cycle, syncing of data, etc.).


  2. XOi polls for new appointments that are scheduled and assigned or completed for technicians whose email addresses are also valid XOi Vision email addresses. 
  3. In XOi Vision, the job is created automatically based on the service appointment in Service Management. 
  4. The Schedule API creates several read-only notes that are attached to the service appointment. 

    ...

      • XOi Site History

    ...

      • This internal note contains the hyperlink to the Job Activity in the Vision app. This note is required to display the XOi Site History field on the service appointment.
      • XOi Workflow
        This internal note contains the hyperlink to the job. This note is required to display the XOi Workflow field on the service appointment.
      • XOi Resolution
        This note contains the URL to view any related photos and/or videos on the Vision website and is included on the Call (or Appointment) Summary report.
      • XOi Transcript 
        This note contains Vision's video transcription.

        Note

        This note is generated after the Vision platform processes the audio

    ...

      • , which may be hours after the appointment is completed, so

    ...

      • the XOi Video Transcription note will not be included on the

    ...

      • Appointment

    ...

      • Summary report.

    • Subject: XOi Video Transcription
      Author: xoi
      Note: {this is the captured notes from the techician’s final video recap transcribed to text}
      Internal: False

    An example of how a technician would use deep linking within a service appointment:

    1. Arrive on site.
    2. In the MobileTech service appointment, select the Vision Site History Open XOi Vision hyperlink to open the Vision app to the Site History information.
    3. In Vision, click return link to go back to MobileTech.
    4. Begin working through tasks in MobileTech.
    5. Navigate to Vision to “Capture photos” (appointment window chgs to add the notes & hyperlinks)
    6. In Vision, click the return link to go back to MobileTech.
    7. Continue working through tasks in MobileTech.
    8. Finish work tasks.
    9. Navigate to Vision for final image captures and “Create recap video”.
    10. In Vision, complete the Job (service appointment).
    11. In Vision, click return link to go back to MobileTech. 
    12. Complete service appointment in MobileTech
      • There may be up to three XOi Transcript notes, named XOi Transcript, XOi Transcript 2, and XOi Transcript 3.