Ubiqod by Skiply 🤝 An activity tracking and customer feedback solution

Connector operation and setup with Skiply

This connector has been set up by Skiply, so Lucca cannot customize it.
If you have any questions about how to integrate it, please contact Skiply’s help desk.

How the integration works

      • Solutions involved: Poplee Core HR and Timmi Timesheet
      • Type of integration: API
      • Integration direction: Ubiqod to Lucca
      • Integration frequency: Daily
      • Setting up the integration: you are free to save your URL and API key in your Ubiqod account

Synchronized data

During the data synchronization process, Ubiqod will transfer and retrieve the following data:

    • the start and end of time submissions (Timmi Timesheet)
    • employee login details (Poplee Core HR)

Setting up the integration in Lucca

To set up integration, go to your Lucca space:

  1. Click on the little rocket at the top right of your Lucca space
  2. Select the "🔌Integrations" field
  3. Search for the relevant application
  4. Follow the instructions to create your pre-configured API key

The API key will be created automatically with all the permissions you need to set up the integration.

The connection steps to be completed in Ubiqod

  1. Log in to your Ubiqod account.
  2. Configure your Lucca connector:
    • Go to the Connectors page.
    • Create a new Lucca type connector - Timmi Timesheet.
    • Enter the URL of your Lucca instance in the "URL" field (for example https://test.ilucca.net).
    • Enter the API key you generated in the "API Key" field.
    • You can edit the maximum transition time if you want to limit a transition time (between 1 and 24 hours).
    • Depending on your time zone, you can edit the time zone used to save the transition date (UTC by default, which means that no time zone is applied).

Notes about the interface: You can create a QR interface to integrate QR codes and Ubiqod Keys, or an IoT interface to integrate Skiply smart boxes (such as Clock S…).

Only apply the part of the file that corresponds to your use case.

3. Create your QR interface (for QR Codes and Ubiqod Keys):

    • Go to the Interfaces page, in the "PIN codes list" tab.
    • Create a new PIN codes list.
      • Each code has a reference corresponding to the user’s PIN code, a label and a list of external references.
      • Fill in the list of external references for each reference by clicking the link icon.
      • Create the reference "Lucca: User ID". The value to be linked corresponds to the user ID in the Lucca platform (you can get this from the HR file URL in the list of employees for your instance)
  • You can create as many PIN codes as there are users to be integrated.
    Note: Each PIN code must have its reference set to Lucca or their data will not be saved.
  • Go to the Interfaces tab.
    • Create a new QR interface "Radio button".
    • Add PIN protection and link the PIN codes list you just created.
    • Create two buttons: one for arrival and one for departure. The references for both buttons must match those configured in your Lucca connector.

4. Create your IoT interface:

      • Go to the Interfaces page, in the "Badge list" tab.
      • Create a new badge list.
        • Each badge has a reference corresponding to the user’s badge number, a label and a list of external references.
        • Fill in the list of external references for each reference by clicking on the link icon.
  • Create the Lucca reference: User ID. The value to be linked corresponds to the user ID in the Lucca platform (you can get this from the HR file URL in the list of employees for your instance)
  • You can create as many badges as there are users to be integrated.
    Note: Each one must have its reference set to Lucca or their data will not be saved.
  • Go to the Interfaces tab.
    • Create a new IOT interface.
      Note: In our example, we will create an interface for Clock S. Clock R and Clock ST are also compatible with this integration.
    • Link the list of badges you just created.
    • Link two buttons: one for Arrival and one for Departure. The references for both buttons must match those configured in your Lucca connector.
  • Link your settings with your tracker:
    • Go to the Trackers page, in the tab corresponding to the tracker to be created / modified (QOD, IoT or Ubiqod Key).
    • Create or modify your tracker to display the edit page.
    • Add the interface and connector you created to your tracker.

Your system is now operational. You can use your tracker to test your integration with Lucca.

Limitations

The integration with Ubiqod has some limits, such as: 

  • You must link the Lucca user reference with your PIN code or IoT badge to integrate your user properly with Lucca.
  • You cannot have two successive arrivals or departures for the same Lucca user.

If you encounter any of these limits, the data will not be sent to your Lucca instance. However, you will receive an email from Ubiqod telling you that your connector has received an error.

Data that could not be sent will be displayed in red in the connector log.

By clicking on … → View details → Server response, you should be able to see the cause of the error. This will allow you to fix it if necessary.

This erroneous data can then be replayed to send it back to your Lucca instance without editing the user’s arrival or departure date.

Page content

Was this article helpful?
0 out of 0 found this helpful