Add an inbound message flow that calls a digital bot flow

This article demonstrates how to create an inbound message flow, call a digital bot flow, and then test the bot behavior.

Create an inbound message flow and then call a digital bot flow

  1. In Architect under flow type, create a new inbound message flow or open an existing one.
  2. Under Starting State, confirm that the Initial State has focus.
  3. From the Toolbox, expand the Bot menu and drag a Call Digital Bot Flow action below Start.
  4. Configure the action:
    1. Leave the default Call Digital Bot Flow name unchanged or update it with a new name.
    2. Under Flow, click the Digital Bot Flow list and select the appropriate bot flow.
  5. Click Publish.

Click the image to enlarge.

Call bot flow from message flow

Configure the bot in Messenger

  1. In Genesys Cloud, click Admin.
  2. Under Message, click Messenger Configurations.
  3. Click New Configuration.
  4. Give the Messenger a meaningful name.
  5. Under Messenger Homescreen, click Off to enable the setting. The setting changes to On.
  6. Under Labels & Language Support, complete these steps:
    1. Under Select your Supported Languages, click the Select language(s) list and choose the languages that you want to support in the Messenger interface.
    2. Under Select Default Language, click the Select language list and choose the default language. Messenger attempts to automatically detect the customer’s languages from the browser preferences. If the detected language matches any supported language, the Messenger applies the corresponding localized labels to the UI elements. If the detected language does not match any supported language, the Messenger shows UI labels in the default language. For more information, see Genesys Cloud supported languages.
  7. Complete the remaining configuration to customize Messenger according to your organization’s preferences. For more information, see Configure Messenger.
  8. Click Save New Version.

Click the image to enlarge.

Messenger config for Coffee demo

Configure the Messenger deployment

  1. Click Messenger Deployments.
  2. Click New Deployment.
  3. Give the deployment a meaningful name.
  4. Under Status, use the toggle to set the status of the Messenger deployment. 
    1. To enable the Messenger deployment on your website or in your mobile application, turn on the toggle. The status shows as Active.
    2. To disable the Messenger deployment on your website or in your mobile application, turn off the toggle. The status shows as Inactive.
  5. Under Select your Configuration, click Select Configuration to select a version of a Messenger configuration to assign to this deployment.
    1. In the Assignment pane, navigate to the Messenger configuration you want to assign to the configuration and click the name of the Messenger configuration.
    2. Select the version that you want to assign.
    3. Click Save.
  6. Under Restrict domain access, determine whether to allow all domains or restrict the domains on which you want to deploy the snippet.  
    1. To allow all domains, select the Allow all domains option. Use this option for testing and development purposes.
    2. To restrict domains, enter a domain and click Add Domain. You can add multiple domains to the list. Restrict domains to prevent unauthorized usage of your snippet from unknown domains. If you restrict a domain, then Messenger does not run on that website and rejects API requests from that domain.
  7. Under Select your Architect Flow, select a published inbound message flow.
  8. Complete the remaining configuration to customize Messenger according to your organization’s preferences. For more information, see Deploy Messenger.
  9. Click Save. The Messenger Deployments page now displays the snippet and deployment key. Next, copy the Messenger snippet and deploy the Messenger snippet to your website. If you are building a custom Messenger, copy the deployment key.

Click the image to enlarge.

Messenger deployment for Coffee demo

Test the end to end configuration

Note: You can also perform a test directly in Architect, but only for the digital bot flow.

  1. Navigate to https://developer.genesys.cloud/devapps/web-chat-messenger.
  2. Add a new account or log in with your credentials.
  3. Under Chat configuration (required), click Select a deployment and then select the newly created deployment.
  4. Click Start Chat.

Click the image to enlarge.

Start a chat