View source for DES/Current/Designer/BotRegistry

{{Article
|Standalone=No
|DisplayName=Bot Registry
|TocName=Bot Registry
|Context=The '''Designer Bot Registry''' contains a collection of bot resources you can use in your applications.
|ComingSoon=No
|Platform=GenesysEngage-cloud
|Role=Administrator
|Application=Designer
|Section={{Section
|sectionHeading=Before you start
|anchor=prereq
|alignment=Vertical
|structuredtext=The Bot Registry does not enable you to create bots. Rather, it stores information about bots that you've configured with a supported bot services provider, such as '''Google DialogFlow''', '''Amazon Lex''', or {{Link-AnywhereElse|product=GDE|version=Current|manual=User|topic=Overview|display text=Genesys Dialog Engine}}.   

Before you can add a bot resource to the registry, you'll need to set it up with one of the supported bot services providers. 

After you've added a bot to the registry, you can start using it by adding a {{Link-SomewhereInThisVersion|manual=Designer|topic=BotBlock|display text=Bot Block}} to your application.
|Status=No
}}{{Section
|sectionHeading=Adding a new bot resource
|anchor=addbot
|alignment=Vertical
|structuredtext='''Watch:''' Add a bot resource to Designer

{{#widget:Vimeo|id=440114334|width=500}}

Click '''Add Bot Definition''' and enter a '''Name''' for the bot resource. Note that as described in {{Link-SomewhereInThisVersion|manual=Designer|topic=Resources|anchor=validchar|display text=Valid naming characters}}, the following characters are not permitted when naming a bot resource: 

*@ ("at" sign)
* : (colon)
* ! (exclamation mark)

Next, select the '''Type''' from the list of supported bot services providers.

[[File:Des_define_bot.png]]

For most of the bot services providers, you can click '''Submit''' and then enter the details manually. For example, here is an example of the properties for a '''LEX''' type bot:

[[File:des_bot_registry_lex_ex.png]]

However, for '''Dialogflow''' bots, you can import a JSON file that contains all of the required settings for your bot resource. You can export this file from your Dialogflow account page — if you need help doing this, see the documentation for your bot service.

[[File:Des_add_dialogflow_bot.png]]

After the settings for the Dialogflow bot are added, you can select an optional setting called '''Wait Conversation End'''. When enabled, the {{Link-SomewhereInThisVersion|manual=Designer|topic=BotBlock}} recognizes intents that are marked as end-of-conversation intents in the bot. 

Here's an example of a Dialogflow bot with the settings imported and the '''Wait Conversation End''' option selected:  

[[File:des_bot_registry_dialogflow_ex.png]]

After you've entered the settings for your bot, you can click '''Test Connection''' to check if Designer can communicate with it. When you are finished setting up the properties, click '''Save''' to add it to the registry.

After a bot resource is added to the registry, you can use it in your applications by adding a {{Link-SomewhereInThisVersion|manual=Designer|topic=BotBlock|display text=Bot Block}} to your application and selecting the bot resource in the block properties.
|Status=No
}}
}}