Automatically open chat widget

Hi All, is it possible to open the widget automatically if you use a specific link parameter for example "/?OpenChat=true". I don't want the widget to open every time just with a specific link which i can use for a qr code. Thanks for the help.

JJan Hi All, is it possible to open the widget automatically if you use a specific li...

Tico | Voiceflow Assistant•9/17/25, 12:21 PM

Yep – you can do it with one small script.

Load the widget as usual with window.voiceflow.chat.load({...})window.voiceflow.chat.load({...}).
Right after the load call, check the current URL for a query-string flag (e.g. ?OpenChat=true?OpenChat=true).
If the flag is present, call the Web Chat API’s window.voiceflow.chat.open()window.voiceflow.chat.open() method to pop the widget open.

<script type="text/javascript">
  (function (d, t) {
    const v = d.createElement(t);
    const s = d.getElementsByTagName(t)[0];

    v.onload = function () {
      // 1️⃣  initialise your widget
      window.voiceflow.chat.load({
        verify: { projectID: 'YOUR_PROJECT_ID' },
        url: 'https://general-runtime.voiceflow.com',
        versionID: 'production'
      });

      // 2️⃣  look for ?OpenChat=true
      const params = new URLSearchParams(window.location.search);
      const shouldOpen = params.get('OpenChat');

      // 3️⃣  open only when the flag is present
      if (shouldOpen === 'true') {
        window.voiceflow.chat.open();
      }
    };

    v.src = 'https://cdn.voiceflow.com/widget/bundle.mjs';
    v.type = 'text/javascript';
    s.parentNode.insertBefore(v, s);
  })(document, 'script');
</script>

<script type="text/javascript">
  (function (d, t) {
    const v = d.createElement(t);
    const s = d.getElementsByTagName(t)[0];

    v.onload = function () {
      // 1️⃣  initialise your widget
      window.voiceflow.chat.load({
        verify: { projectID: 'YOUR_PROJECT_ID' },
        url: 'https://general-runtime.voiceflow.com',
        versionID: 'production'
      });

      // 2️⃣  look for ?OpenChat=true
      const params = new URLSearchParams(window.location.search);
      const shouldOpen = params.get('OpenChat');

      // 3️⃣  open only when the flag is present
      if (shouldOpen === 'true') {
        window.voiceflow.chat.open();
      }
    };

    v.src = 'https://cdn.voiceflow.com/widget/bundle.mjs';
    v.type = 'text/javascript';
    s.parentNode.insertBefore(v, s);
  })(document, 'script');
</script>

• Scan the QR code to a URL like https://your-site.com/?OpenChat=truehttps://your-site.com/?OpenChat=true, and the widget auto-opens.
• Visiting the page without that parameter leaves the launcher closed as usual.
• You can adapt the flag name/value to whatever you like.

Reference: “Custom triggers” – Voiceflow Web Chat API docs (window.voiceflow.chat.open/close/show/hide). https://docs.voiceflow.com/docs/custom-triggers