Installation Guide

This document provides step-by-step instructions to install and configure the Safecube package in your Salesforce environment.

📘

Note

This installation and configuration process needs to be completed only once per Salesforce instance.

For more information on using the Safecube application within Salesforce, refer to our guide.



1. Install the Safecube Package

To begin, install the Safecube package using the following link:

👍

Install Safecube Package

You will be prompted to:

  • Log in to your Salesforce environment.
  • Confirm installation of a non-Salesforce application.
  • Authorize api.sinay.ai to send data to Salesforce for container tracking integration.


2. Assign the Permission Set

After installing the package:

  • Assign the Safecube permission set to all users who need access.

Steps:

  1. Navigate to Setup in Salesforce.

  2. In the Quick Find box, type Permission Sets and select it.

  3. Click on the Safecube permission set.

  4. Click Manage Assignments.

  5. Click Add Assignments.

  6. Select the users who need access and click Next, then Assign.


3. Activate the Site to Obtain a Public URL

Salesforce requires a public site URL for external integrations.

Steps:

  1. Go to Setup in Salesforce.

  2. In the Quick Find box, type Sites and select it.

  3. Click New to create a new site.

  4. Fill in the required information:

    • Site Label: Safecube

    • Site Name: Safecube

    • Default Web Address: Safecube

    • Active: ✅ (Make sure this is checked)

    • Active Site Home Page: Unauthorized

  5. Click Save.


4. Assign technical Guest User Permission Set

You must assign a Guest User, that will have permission on Safecube application settings (including API key).

Steps:

  1. In the Quick Find box, type Sites and select it.

  2. Find the Safecube site, and clic Safecube

  3. Select Public access Settings

  4. Select View Users

  5. Clic Site Guest User

  6. Select Permission Set Assignment and then Edit Assignments

  1. Search Safecube Guest User, Click Add and then Save



5. Configure your API key

The API Key is necessary to give you the rights to access container tracking data.

Steps:

  1. In the Quick Find box, type Custom Settings and select it.

  2. Next to "Safecube Settings", select Manage

  3. Select New

  4. In another browser tab, look for your API key in Safecube app and Copy your API key.

  5. Back to Safecube Settings in Salesforce, paste the API key in the API Key field, and Save


6. Set up Safecube public URL

We will use this public URL to send the tracking information to your salesforce instance.

Steps:

  1. In the Quick Find box, type Sites and select it.
  2. In Safecube, Copy the Domain Name

❗️

Get the correct url

Don't select it and copy the selection : this will not work (you won't be able to create your endpoint in step 7).

Instead right-click and select "Copy link address".

  1. In the Quick Find box, type Custom Settings and select it.

  2. Select Safecube Settings

  3. Select Manage

  4. Select Edit

  5. Paste the Public URL you copied in step 2, and Save


7. Activate the endpoint

Steps:

  1. Open App Launcher, and then the Safecube application.

  2. Select the Safecube Settings tab.

  3. Select Create endpoint


👍

Congrats !

You have completed the installation procedure. You can now proceed to using the Safecube Container tracking app in your Salesforce instance.


Need Help?

If you encounter issues or have questions, feel free to reach out to our support team.