Acquire
  • Home
  • Chatbots
  • Amazon Lex Bot

Amazon Lex Bot


Connect an Amazon Lex Bot to Acquire to use trained responses in your widget. Lex Bots can be deployed by triggers or called in by other chatbots in your widget.


In this article:

  • Configuring an Amazon Lex Bot for Acquire
  • Integrating an Amazon Lex Bot
  • Deploying an Amazon Lex Bot

Configuring an Amazon Lex Bot for Acquire

Amazon Lex allows you to create multiple bots, but only one bot can be connected to Acquire at this time. You can connect an existing bot or create a new one for use in Acquire.


Required:

In the bot editor, under 'Fulfillment' you must select 'Return parameters to client' to connect it with Acquire.


v9FeLU8zCjWjfhPGx-EbrO2yYCQ7ecFRi631gJsK3wavW58VAfAhGFm-2z8ToxvTMq_9wk2uxV-opCw7uq2kwubOWGVvHPYyhnXq1M3VmeRJNDamHar5Ba4WkpD0uNAG3TXZEp7d

Optional:

In the Lex Bot editor under 'Add Message' you can choose 'Custom Markup' and enter webhook variables used in Acquire such as visitor_name, visitor_email, and visitor_phone.


Once a bot is built and published, you can integrate it with Acquire.


Integrating an Amazon Lex Bot


To integrate your Amazon Lex Bot, you'll need to gather:

  • Bot name
  • Bot alias (located under Bot Settings > Aliases)
  • AWS region
  • Secret key
  • Access key

To view your secret key and access key, head to Amazon IAM Service > Delete your access keys. Click on 'Manage Security Credentials'.


ksCJqr9B_BebdFAHLjvIEUVVet7frvqpQ-3G0piNBIOUGBkF_M2wUzHZyIRvQqkopzpZfVyKinilf8yTzOhAepBSp9u0Fqbb6M9UjXA3-eYj96ik0b2oBX193B-pdOwlyCSfBYYH

Select 'Get Started with IAM Users'. 


Q-SXeFTD5xl5JKp3oHivdKQPuwcGPSuFbDkqXA12uN4hXLDSxdKRUFgdE9mcGfP6sXypu1AwxjwykCyVgDFK6lDx0Man43m8qkkQ9u0zYOqMP7qrgn2oyRFB7MYTEuQSkqd3sjxY

Enter a new 'User name' and check the box named 'Programmatic access'.


hCoDQ2H9S92c7HRCBBMgt27Nq-_Cg8bqo1DlSWGUGi9pk8nmaX9oij7PkQ_q4wmnXTvf4XQ7EgkPpuA8kkwOcLFVCf_x51Bvw9upoi7XLKM7zZ5Q32y7d4w6UYOMEmcHnfnPpkV9

Now, you can add the user to an existing group or create a new group. Click on 'Create Group' to create a new group.

 

q2LJsVXFncL35sLvBvEnq0M9W6OLXCvGkQFw6K63flJwiD3Yp-zHsnK0YDV7DBv_a-kuOy_mP1e_k2xvCSCSrXTaCQpkyyasE0ajVIldfb5pjifPCw91fZRyEwkOwSrQ3fguQ5UC

Give a new name to the group and add permissions of 'AmazonLexReadOnly' and 'AmazonLexRunBotsOnly' and then click on 'Create Group'.


5ynPph-RL2JB5VYOj9ucfKp21Mvylal-2-ZWsFZ8jDOzt_Xlwm37uh_E31KrDynzBhv3zhnToCqy0RfGCtMV28QxH_TyRzrEbyL5t_tmoKe78nkhEJBT-iGqxbbjqY38-Xl7YiAO

Next, 'Add tags' if you'd like or just click 'Next'.


6_pSewfzffr2uURp1MRO-3if0dWaO67RKltQmKL0bMJ6GzZXxQzI_iCFlRrgEJ2jQwePl4wTKJMv8d5d8lCvQRNKq8-z7aFDN7DcmYQMhFj5IqaNsyD12XvRYdG8mDNTpi8DBGl7

Review all the information and press 'Create User'. 


cymPuggVmHQo1ifT6qxSlf1bn4zf40ZEoSlIBr-yd1A7xPoraDz1AX8rCJmRnnYX8QC4t-55dAWPWUPAj3DHR2aN_CsdxIzCR_BzD0G1UMvhKNuH5_r9Ac7bPcxWNmT7EouGR6vQ

Your 'Access key ID' and 'Secret access key' will appear on the next screen. You can also download a CSV file to save these credentials.


Ro39EDJMIw7_B9mzXCmIS9aJd7bn7Jn58DqRX3oJCQZ8daBSW5zxF7SBH-_kMP0nKlxNejS4UeyVN5HW38gc4VLjNyWGemeSVHagl6UMSNFK-Fja3EZAgLPQ45T_7ubVhVN2Qfc6

Once you have those parameters, in Acquire go to Chatbots > Third Party Bots. Click 'Install Bot' under Amazon Lex Bot. Click 'Install', review the app permissions, and then click 'Authorize Access'. Complete each field using the parameters you gathered from AWS. Optionally, you can add a bot name and icon under 'Bot Identity' before clicking 'Save' to complete the integration.


Deploying an Amazon Lex Bot


Deploy your Lex Bot by setting a trigger. Learn how to create a trigger →


Once the trigger is live, your Amazon Lex Bot will be available in the widget.


Related Articles