Skip to main content
About the Resource Center

FAQs: Bots

How can my third-party bot proactively trigger a welcome message?

If you are using web messaging with the conversation auto-start feature enabled, then you can send custom text to the bot. In the messaging flow, configure the Call Bot Connector action to send a literal text value such as “Menu” instead of the Message.Message.Body variable.

How to use OAuth within a Bot Connector integration?

Perform these steps before using the Call Bot Connector action in your flow:

  1. Use the Call Data Action to retrieve access tokens from an external OAuth provider.
  2. Using the token retrieved from the Call Data Action (in the previous step), update the access credentials of the Genesys Bot Connector integration.
  3. Use the Call Bot Connector action with the specific bot integration that contains the updated credentials.

How can I obtain the IP address range for my region where Bot Connector protocol requests could originate from so that I can add it to my allowlist?

To obtain the IP address range for Bot Connector specific to the region of your organization, you can make a request to the following Genesys Cloud Public API endpoint: Get public IP address ranges for Genesys Cloud.

The request returns a list of IP ranges. Use the range that is marked as “bot-connector”.

{
  "entities": [
    {
      "cidr": "52.200.73.32/32",
      "service": "data-actions",
      "region": "us-east-1"
    },
    {
      "cidr": "52.200.73.32/32",
      "service": "smtp",
      "region": "us-east-1"
    },
    {
      "cidr": "52.200.73.32/32",
      "service": "open-messaging",
      "region": "us-east-1"
    },
    {
      "cidr": "52.200.73.32/32",
      "service": "audiohook",
      "region": "us-east-1"
    },
    { 
      "cidr": "34.200.73.250/32", 
      "service": "bot-connector", 
      "region": "us-east-1" 
    }, 
    { 
      "cidr": "52.200.73.42/32", 
      "service": "audio-connector", 
      "region": "us-east-1" 
    }, 
    { 
      "cidr": "52.200.73.42/32", 
      "service": "byot-stt", 
      "region": "us-east-1" },
    {
      "cidr": "52.200.73.199/32",
      "service": "data-actions",
      "region": "us-east-1"
    },
    …
  ]
}

How can I obtain the IP address range for my region where BYOT-STT protocol requests could originate from so that I can add it to my allowlist?

To obtain the IP address range for BYOT Speech-to-text (STT) specific to the region of your organization, you can make a request to the following Genesys Cloud Public API endpoint: Get public IP address ranges for Genesys Cloud.

The request returns a list of IP ranges. Use the range that is marked as “byot-stt”.

{
  "entities": [
    {
      "cidr": "52.200.73.32/32",
      "service": "data-actions",
      "region": "us-east-1"
    },
    {
      "cidr": "52.200.73.32/32",
      "service": "smtp",
      "region": "us-east-1"
    },
    {
      "cidr": "52.200.73.32/32",
      "service": "open-messaging",
      "region": "us-east-1"
    },
    {
      "cidr": "52.200.73.32/32",
      "service": "audiohook",
      "region": "us-east-1"
    },
    { 
      "cidr": "34.200.73.250/32", 
      "service": "bot-connector", 
      "region": "us-east-1" 
    }, 
    { 
      "cidr": "52.200.73.42/32", 
      "service": "audio-connector", 
      "region": "us-east-1" 
    }, 
    { 
      "cidr": "52.200.73.42/32", 
      "service": "byot-stt", 
      "region": "us-east-1" },
    {
      "cidr": "52.200.73.199/32",
      "service": "data-actions",
      "region": "us-east-1"
    },
    …
  ]
}

Genesys Bot Connector incurs BYOT charges to use. Will its API usage also be subject to the Genesys Cloud fair use policy?

No, while you use Genesys Bot Connector, you only incur BYOT charges. Genesys does not add additional fair use allocation charges.

What are the charges for a Genesys Cloud voice bot flow that uses the Nuance Recognizer as a Service integration?

To use the Nuance Recognizer as a Service (NRaaS) integration in a bot flow, you must enable the following products in your Genesys organization:

Genesys NRaaS integration
Genesys Dialog Engine Bot Flows (DEBF)
  • Genesys Cloud for Bot Flow – Voice
  • Genesys Cloud for Bot Flow – Digital
Nuance AppFoundry       via the metered billing API

For more information on pricing, review the following tables:  

Genesys call overage chargesChargesRelated article
Genesys Cloud fair use policy – Basic routing / IVR (Minutes)OveragesGenesys Cloud fair use policy
GCV Ingress Telephony rate$0.018

Genesys Cloud fair use policy

BYOC – C Ingress Telephone Rate$0.0024Genesys Cloud fair use policy
Genesys Dialog Engine Bot Flows and Genesys Digital Bot Flows pricing$0.06/min with 15-second incrementsGenesys Dialog Engine Bot Flows and Genesys Digital Bot Flows pricing

 

Genesys NRaaS Integration call
FlowIVR and Customer DialogDurationGenesys ChargesNuance Charges
Call Flow“Welcome to XYZ Company!”
Bot Flow“Please provide your reference number.”

5 seconds

Total session time = 15 seconds
Per minute price is $0.06 with 15-second increments
Total: $0.015

 

Bot flow:
customer response – reference number slot (uses Nuance grammar)

“234ABCXYZ987”10 secondsReference number slot -1 NRaaS per request = $0.00578
Call Flow“Thank you for providing your reference number.”
Bot Flow“How can we help you today? Please tell us …”8 secondsTotal session time = 18 seconds
Two 15-second
increments
Total: $0.030
Bot flow
customer response
“I need some help with my last bill as it is incorrect and … “

10 seconds

 

$0.015 + $0.030 = $0.045$0.00578

 

Total (bot flow + Nuance): $0.05078
Notes:
  • The Nuance AppFoundry SKU uses the Genesys metered billing API.
  • The NRaaS per request charge is subject to change. For the most up-to-date pricing information, contact your AppFoundry partner or Nuance representative before you do any pricing exercise.

 

Are there limits on the number of concurrent Bot Connector interactions?

The limit on the number of concurrent Bot Connector interactions is 60,000 bot invocations per minute, per org

Who handles speech-to-text (STT) when using the Nuance Recognizer as a Service integration in Genesys Cloud?

Nuance Recognizer as a Service (NRaaS) is a third-party, cloud-to-cloud integration. Genesys Cloud streams out audio in real time (along with the GRXML grammar file) to Nuance Recognizer for processing. NRaaS transforms the audio to text, and returns the results to Genesys Cloud.

How do I set the No Input timer for a bot flow?

You can configure No Input timeout for Genesys Dialog Engine Bot flows for voice interactions. For digital interactions, use Genesys Digital Bot Flows. Bot flows can run for up to six days while they wait for input from the participant. For more information, see Set up user input for a bot flow.

When I use environments in a Google Cloud Dialogflow bot, can I remove an intent?

If you choose an environment in the Call Dialogflow bot action and remove intents from the draft version of the agent, then the flow takes the failure path. This action occurs because the flow cannot reach the deleted intents. Therefore, even though the agent fulfills the intent, the flow takes the failure path.

To ensure that the Draft environment always includes the entire set of intents in the published environment, only add intents during the life cycle of an agent throughout various environments. Do not remove them. You can also export the agent configuration into a new agent and then set the intents as appropriate. Then, update the Architect flow to reference the new agent.

To perform this task, you must create a new agent. Export the current agent’s configuration into a new Google Cloud Dialogflow agent, then remove intents and slots as appropriate. Then, reference the new agent from the Architect flow instead. Going forward, follow the add-only approach described previously.