Configure Interop.io

Configure for interop.io (ioConnect)

  • Go to the Settings menu in your Symphony Messaging client and select the Interoperability tab.

  • Select interop.io from the dropdown menu.

Configure ioConnect for Symphony Messaging

Add Symphony Messaging in the App directory

Symphony Messaging needs to be registered in the App directory, so that it will be able to connect to the platform.

Add a new symphony.json file into your app directory folder (io.Connect Desktop\UserData\{IO_INSTANCE}\apps):

symphony.json
{
    "name": "symphony",
    "title": "symphony",
    "hidden": true,
    "details": {
        "autoInjectFdc3": {
            "enabled": true
        },
        "fdc3InitsGlue": true,
        "allowChannels": true
    },
    "intents": [
        {
            "name": "fdc3.ViewInstrument",
            "displayName": "View Instrument",
            "contexts": [
                "fdc3.instrument"
            ]
        },
        {
            "name": "fdc3.StartChat",
            "displayName": "Start Chart",
            "contexts": [
                "fdc3.chat.initSettings"
            ]
        },
        {
            "name": "fdc3.SendChatMessage",
            "displayName": "Send Chat Message",
            "contexts": [
                "fdc3.chat.message"
            ]
        },
        {
            "name": "fdc3.ViewMessages",
            "displayName": "View Messages",
            "contexts": [
                "fdc3.searchCriteria"
            ]
        },
        {
	    "name": "fdc3.ViewChat",
	    "displayName": "View Chat",
	    "contexts": [
	        "fdc3.chat.room", "fdc3.contact", "fdc3.contactList"
	    ]
	}
    ]
}

Configure the authentication

In the system.json file, add a custom authenticator "symphony".

Replace your pod sub domain with your actual pod URL.

{
  ...
  "gw": {
    ...
    "configuration": {
      "customAuthenticators": {
        "symphony": {
          "file": "%GDDIR%/assets/authenticators/symphony/index.js",
          "configuration": {
            "pem": [
              "https://{MYPOD_SUBDOMAIN}.symphony.com/client-bff/v1/jwt/publicKey"
            ]
          }
        }
      }
    },
    ...
  },
  ...
}

Once your configuration is complete, please have a look at our Troubleshooting guide to validate that everything is working.

Last updated

Was this helpful?