# Configure with Embedded Mode

### **What is Embedded Mode?**

Symphony Messaging's **Embedded Mode** allows you to embed Symphony Messaging as a FDC3 enabled web component on your desktop platform. 

{% hint style="info" %}
Reminder: Embedded Mode is available as an add-on to the Symphony Services, and is subject to additional charges, terms, and Symphony review of your use case. 
{% endhint %}

We recommend loading Embedded Mode automatically at startup and always keep it on. It may also be possible to configure your desktop platform so that if the user closes the Embedded Mode window, the web app gets hidden instead of closed.

### Configure your FDC3 platform

Depending on your platform, the following steps will slightly differ. However the configuration will roughly consist in the following steps:

* Create a new app, that you can name "Symphony Messaging".
* The platform needs to provide the FDC3 API to Symphony Messaging using the window\.fdc3 object. This option may be named `Inject FDC3` depending on your platform.
* Configure the FDC3 version:  Symphony Messaging supports FDC3 API version 1.2 and 2.0. 
* Configure the `load URL` of Symphony Messaging. This URL depends on the **mode** that best suits your use case: *Focus* mode or *Collaboration* mode. 

### Modes

Two modes are supported.

* The **Focus** mode, that displays a single view. The chat list is not visible. The Focus mode is very compact.
* The **Collaboration** mode, which looks like a simplified version of the Symphony Messaging desktop app (SDA). The user has access to the usual chat list, can navigate, search, and perform most actions available in the desktop app.

Depending on what you want to do, one mode may be more adapted than the other.

#### **Load URL for Focus mode**

Configure the following **load URL** in your FDC3 platform:

```html
https://{your_pod_url}.symphony.com/apps/embed?partnerId={partnerId}&container=true&mode=dark&condensed=true
```

In Focus mode, Symphony Messaging will not show the usual chat list. On startup, a landing page will be displayed instead.

To open a first chat or to navigate to another chat, you can raise a [ViewChat ](https://docs.developers.symphony.com/embedded-modules/fdc3-intents#view-chat)intent. Symphony Messaging will automatically display the specified chat conversation.

Please note the presence of the `container` parameter and the absence of the `streamId` parameter.

Not all FDC3 intents may be available in Focus mode.

#### **Load URL for Collaboration mode**

In collaboration mode the user is able to navigate between his chats and can also start a new chat. 

Configure the following **load URL** in your fdc3 platform:

```html
https://{your_pod_url}.symphony.com/apps/client2?embed=true&partnerId={partnerId}&mode=dark&condensed=true
```

{% hint style="info" %}
Loading Symphony Messaging in Embedded Mode requires a`partnerId` to be passed along in the load URL. More info on Partner Id is available [here](https://docs.developers.symphony.com/embedded-mode/pricing-tiers#partner-id).
{% endhint %}

Once your configuration is complete, please have a look at our [troubleshooting](https://docs.developers.symphony.com/embedded-modules/desktop-interoperability/configuration-guide/troubleshooting "mention") guide to validate that everything is working.

{% hint style="info" %}
Broadcasts from Action buttons are not supported in Embedded Mode. 
{% endhint %}

### Get started quickly with Here core

If you are using the Here Core platform, you can see an example of how to setup Symphony Messaging Embedded Mode in Here Core (previously known as OpenFin Workspace) in the [following GitHub page](https://github.com/built-on-openfin/contest-starter/blob/main/workspace/symphony/challenge-2023/README.md).