Add the EqualWeb accessibility widget to Dev Portal

Before you configure the integration in Konnect, you need your Dev Portal domain and your EqualWeb site key.

1. In the Konnect sidebar, expand Dev Portal.
2. Click Portals.
3. Click your Dev Portal.
4. Copy your Dev Portal domain. This is the URL you’ll register in EqualWeb.
5. In your EqualWeb account, click Add new site.
6. In the Insert your domain field, enter your Dev Portal domain.
7. Click Continue to customize design.
8. Configure the widget design settings as needed.
9. Click Continue to install widget.
10. Click Collapse for your widget code. This will expand the widget configuration.
11. Copy your site key from the get sitekey (){ return "79ad2e1..."} field. For example: 79ad2e1ec52e63565e254555077aaaec.

12. (Optional) If you configured the widget design, copy the configuration. For example:

    "Position": "left",
    "Menulang": "EN",
    "draggable": true,
    "btnStyle": {
        "vPosition": [
            "80%",
            "80%"
        ],
        "margin": [
            "0",
            "0"
        ],
        "scale": [
            "0.5",
            "0.5"
        ],
        "color": {
            "main": "#1c4bb6",
            "second": "#ffffff"
        },
        "icon": {
            "outline": false,
            "outlineColor": "#ffffff",
            "type": 1,
            "shape": "circle"
        }
    }

    Toggle code

    The configuration you copy won’t be valid JSON. When you add it to the Dev Portal integration configuration, you’ll add {} to make it valid.

Configure the EqualWeb integration in your Dev Portal settings.

1. In the Konnect sidebar, expand Dev Portal.
2. Click Portals.
3. Click your Dev Portal.
4. Click the Settings tab.
5. Click the Integrations tab.
6. Click EqualWeb.
7. Click the Enabled toggle.
8. In the Site key, enter the site key from the EqualWeb widget you configured previously. For example: 79ad2e1ec52e63565e254555077aaaec.

9. (Optional) If you configured the widget design in EqualWeb, click Advanced configurations and enter the JSON configuration in the configuration field with opening and closing brackets ({}). For example:

   {
    "Position": "left",
    "Menulang": "EN",
    "draggable": true,
    ...
   } 

10. Click Save.

You can also configure the EqualWeb integration using the Konnect API by sending a PUT request to the /portals/{portalId}/integrations endpoint.

You can verify that the integration is working as expected by navigating to your Dev Portal URL. The EqualWeb accessibility widget should display on the page. It can take several minutes to display the widget after you’ve enabled the integration.