Webchat
    • 19 Feb 2025
    • 3 Minutes to read
    • Dark
      Light
    • PDF

    Webchat

    • Dark
      Light
    • PDF

    Article summary

    Who should read this article: Administrators

    Embed a webchat widget in your organization's website to enable your contact center to receive and reply to messages from your website visitors.

    Introduction

    Voiso enables you to add a webchat widget to your organization's website so that your contacts can initiate chat sessions with your agents.

    Embedding the webchat widget

    This section describes how you can connect, configure, and manage the Webchat widget in your website. Use the JavaScript code you generate in the Add channel page to embed the Voiso Webchat widget in your website.

    Omnichannel Embedded Webchat Widget Contact Initiated Chat

    Tip

    Use the username parameter in the JavaScript code to automatically insert the name or ID of contacts that are logged in to your website.

    Webchat configuration

    The Voiso Webchat channel provides a widget that you embed on your website to allow your website visitors to send Webchat interactions to your agents.

    For more information about the Webchat channel, refer to these articles:

    To set up the Webchat channel widget and get JavaScript code that you embed in your website, follow these steps:

    1. In the Channel name field, enter a name for your channel.
    2. Select the Webchat channel type to display the Configuration section.
      Digital Channels Add Channel Webchat
    3. In the Heading field, enter the name that appears at the top of the widget.
    4. From the Color menu, select the color of the agent messages displayed to your website visitors. You can preview the widget in the Preview area.
    5. When you are satisfied with the appearance of the widget, click Generate code to display JavaScript code that you can copy and add to your website.
      Digital Channels Webchat Channel Configuration
    6. To generate a link to preview your widget, click Regenerate code (1). In the Preview your widget link field (2), click the Copy button, then paste the URL into a new browser tab or window. In the Code to include field (3), click the Copy button to copy the JavaScript code you embed in your website to activate the widget.
      Digital Channels Webchat Channel Configuration
    7. If you make changes to the configuration, click Regenerate code to update the preview and code.
    8. Click Save to add the new channel to your contact center.
    Tip

    You can adjust the dimensions of the widget by editing the JS code. The default height and width are 600px by 320px. The width can be set to any value between 320px and 768px, and the height can be set to any value between 600px and 800px.

    Webchat widget preview

    When you configure the Webchat channel, you can preview how the widget will look on a website using the preview URL in the Preview your widget field of the Configuration section.

    Tip

    Any time you modify the widget configuration, click Regenerate code to get the latest preview URL and embeddable code.

    Paste the URL into a new browser tab or window to display the preview page.

    Digital Channels Webchat Preview

    Try out the widget by clicking the Chat icon on the lower right corner of the browser window.

    Digital Channels Webchat Preview Masked

    Identifying contacts

    If your website allows contacts to log in before starting a webchat, Voiso offers a username parameter in the widget script. This parameter lets you programmatically insert the contact's name or ID into the script. When a logged-in contact clicks the Chat icon, the page loads and the script launches, allowing your website code to populate it programmatically with the contact’s name or ID. If no data is added to the username parameter, Voiso will display the contact as Guest.

    When the username parameter is populated, messages sent to your agent in Omnichannel Workspace include the contact’s name or ID.

    The Webchat widget on mobile phones

    The widget appearance you specified when you added it automatically adjusts to fit the entire screen of the mobile phone being used. Fonts and attachment previews are also optimized for mobile displays, so they may appear slightly different from how they look on a desktop browser.

    Emojis are managed directly through the mobile device's keyboard, so your contacts will only see the Attach and Send buttons. The Send button becomes highlighted when your contact starts typing in the message field.

    Enabling agents to handle webchat

    Once you embed the JavaScript webchat widget code in your organization's website, ensure that the Omnichannel Workspace is enabled for your agents. Refer to Enabling Omnichannel.


    Was this article helpful?


    What's Next