# Integration

## New Integration

In the **Unifi Integration Designer** window, after clicking either on the '**+**' **tile** or '**New Integration**', you are given a 'New Integration' modal to complete.

The fields to be configured for the New Integration modal are as follows:

| Field            | Description                                                                                                 | Value        |
| ---------------- | ----------------------------------------------------------------------------------------------------------- | ------------ |
| Name             | The name of the integration.                                                                                | \<Your Name> |
| Service type\*   | The type of web service this integration is using *(Choices: SOAP/REST)*.                                   | 'REST'       |
| Message format\* | Automatically pre-process incoming messages for simpler message scripting. *(Choices: XML, JSON, Advanced)* | 'JSON'       |

{% hint style="info" %}
\*Service type/Message format: these values are defaulted.
{% endhint %}

*Your 'New Integration' modal should look like this:*

![](/files/WNSwUbaashHUzgEQioty)

{% hint style="info" %}
We have chosen to name this integration 'Push-Pull Incident' as it will also later form the basis for the Poller Guides (where we pull data from your Personal Developer Instance, ‘PDI’).
{% endhint %}

Click **Create**.

You will be redirected to the Details page of the newly created Integration.

## Icons

{% hint style="info" %}
Before continuing we would like to draw your attention to some of the relevant icons that are now visible down the left hand navigation strip.
{% endhint %}

![](/files/k2d1yLMwsthHIg9HcNIe)

*The icons are:*

a) ***'Integration' icon*****:** Opens the current integration's Details page.

b) ***'Messages' icon*****:** Opens the current integration's Messages page.

c) ***'Fields' icon*****:** Opens the current integration's Fields page.

d) ***'Field Maps' icon*****:** Opens the current integration's Field Maps page.

e) ***'Documentation' icon*****:** Opens the automatically generated documentation for the current integration. *(Another awesome feature in **Unifi**.)*

f) ***'Connections' icon*****:** Opens the current integration's Connections page.

## Details

*The Details page of your Integration form should look like this:*

![](/files/NXSMPrSI1GalyR0OjzPQ)

Navigate to **Settings > Feedback**.

## Feedback Settings Fields

The Feedback fields to be configured for the Integration record are as follows:

| Field              | Description                                                                                                                                                                                    | Value   |
| ------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------- |
| Enable UI messages | Allow information and error messages to be shown to the user as UI Notifications. Only applies to certain notifications.                                                                       | \<true> |
| Note bond history  | Use the 'Note bond history' to process bond history updates. *(Set to true for the history to be promoted to the work notes fields of the record we're integrating - for the analyst to view)* | \<true> |

*The Feedback Settings fields should look like this:*

![](/files/ar4ZGktlx0Vh4cpbj3dT)

{% hint style="info" %}
The remaining 'Integration' values are to be left as-is:

* Message Identification

All of the remaining 'Settings' values are to be left as-is:

* Attachments Settings
* Bond Settings

All of the 'Error handling' values are to be left as-is:

* General
* Timeouts
* Retry
  {% endhint %}

Click **Save**.

Click the **'Connections' icon** to move on and configure the **Connection**.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.sharelogic.com/unifi/4.2/integration-guides/outbound-incident-guide/integration.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.