Find or regenerate a widget Integration ID

What you'll achieve

Each website keeps the correct widget configuration and you can invalidate one widget's old installation without affecting the others.

What the Integration ID controls

DobroDesk generates a random public Integration ID when you create a widget. The loader or SDK sends this ID to DobroDesk to select that widget's public name, allowed websites, Inbox route, language and customer experience.

Each saved widget has a different Integration ID and its own customer sessions. The ID is a public selector used in website code. Website addresses remain the control that prevents an unrelated origin from using the widget.

Copy the current Integration ID

  1. Open Admin > Channels > Website widgets.

    Find or regenerate a widget Integration ID: Copy the current Integration ID, 1. Open Admin > Channels > Website widgets.
  2. Choose the widget for the website or product you are updating.

    Find or regenerate a widget Integration ID: Copy the current Integration ID, 2. Choose the widget for the website or product you are updating.
  3. Find Integration ID in Widget settings. Compare the widget name and Website addresses before copying it.

    Find or regenerate a widget Integration ID: Copy the current Integration ID, 3. Find Integration ID in Widget settings. Compare the widget name and Website addresses before copying it.
  4. For a script installation, use Copy widget code so the ID is included automatically. For @dobrodesk/widget, copy the ID into the integrationId option exactly as shown.

    Find or regenerate a widget Integration ID: Copy the current Integration ID, 4. For a script installation, use Copy widget code so the ID is included automatically. For @dobrodesk/widget, copy the ID into the integrationId option exactly as shown.

Regenerate the ID safely

  1. Prepare access to every website or application that currently uses this widget. Do not regenerate the ID until you can publish the replacement configuration.

  2. Next to Integration ID select Regenerate and read the confirmation. It lists the immediate effects before anything changes.

    Find or regenerate a widget Integration ID: Regenerate the ID safely, 2. Next to Integration ID select Regenerate and read the confirmation. It lists the immediate effects before anything changes.
  3. Confirm Regenerate ID. DobroDesk creates a new random value and invalidates every existing customer session for this widget.

    Find or regenerate a widget Integration ID: Regenerate the ID safely, 3. Confirm Regenerate ID. DobroDesk creates a new random value and invalidates every existing customer session for this widget.
  4. Copy the new widget code or replace integrationId in the SDK configuration on every approved website.

    Find or regenerate a widget Integration ID: Regenerate the ID safely, 4. Copy the new widget code or replace integrationId in the SDK configuration on every approved website.
  5. Publish each website or application and clear its deployment cache if it has one.

The previous ID stops loading this widget immediately. Existing conversations remain in the DobroDesk Inbox, but returning website visitors start a new widget session after the replacement is published.

Verify every product separately

  1. Open each updated website in a new private browser window.

    Find or regenerate a widget Integration ID: Verify every product separately, 1. Open each updated website in a new private browser window.
  2. Confirm the header shows the correct product or support name, not the name from another widget.

    Find or regenerate a widget Integration ID: Verify every product separately, 2. Confirm the header shows the correct product or support name, not the name from another widget.
  3. Send a unique test message and record the displayed request reference.

  4. In DobroDesk confirm the message reached the Inbox selected for that widget and that each product created a different conversation reference.

    Find or regenerate a widget Integration ID: Verify every product separately, 4. In DobroDesk confirm the message reached the Inbox selected for that widget and that each product created a different conversation reference.
  5. Reply once and confirm the reply appears only in the matching website session.

    Find or regenerate a widget Integration ID: Verify every product separately, 5. Reply once and confirm the reply appears only in the matching website session.

Keep going