> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usehatchapp.com/llms.txt
> Use this file to discover all available pages before exploring further.

# improveit360 (i360) Lightning

> An automatic and bi-directional sync between Hatch and improveit360 

### Overview

* **Type:** CRM
* **Set-Up:** OAuth (Credentials)
* **Sync Frequency:** 15 minutes

### Setting Up the Integration

#### Instructions

Here’s what we need to get started:

1. Navigate to the Hatch app marketplace.
2. Click "Configure" on the improveit360 Lightning integration
3. The integration uses OAuth protocol to allow access to the Salesforce APIs, so all you need to do it click  *connect* and then  *authorize* on the i360 screen that will pop-up. Once authorized, return to the Hatch integration screen and the connection bubble should be blue.

<img src="https://mintcdn.com/usehatchapp/v_VMk57hRIk0rCvf/images/integrations/crm-field-management-systems/image-png-Dec-27-2024-08-33-51-8077-PM.png?fit=max&auto=format&n=v_VMk57hRIk0rCvf&q=85&s=728e78b76ba26b0a8265309bf3eb36d7" alt="" width="688" height="408" data-path="images/integrations/crm-field-management-systems/image-png-Dec-27-2024-08-33-51-8077-PM.png" />

4. Continue through the configuration wizard to select the desired data objects and push communication options.
5. Don't forget to click Finish in order to save.

### Objects that Sync with Hatch

* Sales Opportunity (+ Contact + Account)
* Sales Appointment
* Project (and optionally Project Activities)

*Any fields or values under these objects will be syncing in Hatch and are available in the Hatch product.*

### How are Hatch opportunities created?

<Note>
  When an **opportunity** is generated that doesn’t match an existing **contact** , a new **contact** will be created. A new **opportunity** will be added to an existing **contact** if a match is found.
</Note>

The integration will replace an existing Hatch opportunity when:

* The sync’d Hatch External ID matches the existing opportunity’s Hatch External ID (see below for how the External ID is mapped)

The integration will create an additional (new) Hatch opportunity when:

* The sync’d Hatch External ID does not match the existing opportunity’s Hatch External ID (see below for how the External ID is mapped)

### Hatch → lmproveit360

Hatch events and communications can be sync’d to Improveit360 Lightning in the following scenarios. These options are configured during the integration setup and can be reconfigured at any time.

**Push Events can be configured to appear in Improveit360 in the following locations:**

* A Note related to the Contact

<img src="https://mintcdn.com/usehatchapp/v_VMk57hRIk0rCvf/images/integrations/crm-field-management-systems/image-png-Dec-27-2024-09-05-41-3196-PM.png?fit=max&auto=format&n=v_VMk57hRIk0rCvf&q=85&s=507e3d17c7140df5499e65b59cfe6bbe" alt="" width="1258" height="735" data-path="images/integrations/crm-field-management-systems/image-png-Dec-27-2024-09-05-41-3196-PM.png" />

* A completed Task related to the Contact (where the event details can be found in a comment)

<img src="https://mintcdn.com/usehatchapp/v_VMk57hRIk0rCvf/images/integrations/crm-field-management-systems/image-png-Dec-27-2024-09-37-39-4144-PM.png?fit=max&auto=format&n=v_VMk57hRIk0rCvf&q=85&s=ad3e692f520857c8ec4a5fa6758ff2aa" alt="" width="1225" height="422" data-path="images/integrations/crm-field-management-systems/image-png-Dec-27-2024-09-37-39-4144-PM.png" />

**The following Hatch events are supported:**

* When a Hatch campaign sends an outbound communication to a contact
* When a Hatch user sends an outbound communication to a contact
* When a contact sends an inbound communication to a Hatch workspace
* When specific events occur within a Hatch campaign:
  * A contact is launched (added) to a Hatch campaign
  * A contact is sent the first message of a Hatch campaign
  * A contact is removed from a Hatch campaign before it has ended
  * A contact completed a Hatch campaign

### Frequently Asked Questions

<AccordionGroup>
  <Accordion title="I am getting a generic error when attempting to integrate ImproveIt360 with Hatch that just tells me to reach out to a Salesforce Admin. Are there any steps I can take before reaching out?">
    Most of the time this error occurs, it's due to missing API permissions. In particular, it's worth checking to make sure the user you're attempting to authorizing Hatch with [**has Connected Apps OAuth Usage enabled**](https://help.salesforce.com/s/articleView?id=005132365\&type=1).

    On the profile level, there is a new permission that needs to be added to the **custom** Admin Profile regarding Connected Apps:\
     \
    *Setup>Profile( Admin)>Edit>Administrative Permission*\
    \
    In here, check the box that says 'Approve Uninstalled Connected Apps'.

    Afterwards, make sure you saved the changes and attempt to reintegrate with Hatch.
  </Accordion>
</AccordionGroup>