Skip to main content

Alexa

Integrating Amazon Alexa with the Yellow.ai bot enables businesses to build voice-enabled experiences for their customers. This integration allows users to interact with the bot using Alexa-powered devices, offering a hands-free, conversational interface for customer support, information retrieval, and task automation.

Alexa skill consists of two components:

  1. Voice User Interface (VUI): This is where you define how to handle a user's voice input.
  2. Amazon Developer Portal: The backend logic on the Yellow.ai Platform that determines bot responses.

Setting up Your Alexa Skill in the Developer Portal​

  1. Login to your Amazon Developer Portal.

  2. Navigate Developer Console and click Alexa > Alexa Skills Kit.

  1. Create Alexa Skill
    1. Click Create Skill to begin with creating a new Alexa skill.
    2. Build a skill using the instructions provides on Alexa Documentation.
    3. Use the Custom Interaction Model and set the primary language.
    4. Define Skill information
    • Skill Type - Create all skills using the Custom Interaction Model. This is the default choice.
    • Language - Choose the first language you want to support. You can add additional languages in the future. For now, set it to English(India).
    • Name - This is the name that will be shown in the Alexa Skills Store, and the name your users will refer to.
    • Invocation Name - This is the name that your users will need to say to start your skill. We have provided some common issues developers encounter in the list below, but you should also review the entire Invocation Name Requirements.
  2. Define an Intent for Sending Text to the Chatbot Configure Interaction Model
    1. Click the Continue with template to move to the Interaction Model.
    2. In the Skill Builder Checklist, complete the necessary fields.
  3. Create a Custom Slot Type
    1. Navigate to Slot Types (0) from the menu.
    2. Click ADD+ to create a new slot type.
    3. Name it FreeText and provide common utterances.
    4. Enter 10-15 common utterances that users might say to the chatbot.
  4. Define an Intent for Sending Text to the Chatbot
  5. In the Intents section, click ADD+ to create a new intent.
  6. Name the intent RawText.
  7. Select "RawText" from the left panel and navigate to Intent Slots on the right side.
  8. Create a new intent called RawText and add an intent slot RawTextData, linking it to the FreeText slot type.
  9. Define sample utterances such as {RawTextData} to send raw user input to the backend.
  10. Build & Configure the Model
    1. Click Build Model in the top menu.
    2. Once the model is successfully built, go to Configuration.
    3. Select Endpoint from the menu.
    4. Choose HTTPS as the Service Endpoint Type.
    5. Enter the following URL in the Default Endpoint: https://cloud.yellowmessenger.com/integrations/alexa/getResponse
  11. Set Up Permissions & SSL Certificate
    1. If your skill requires device location access, refer to Amazon's Device Address API. Click for more details
    2. Under SSL Certificate Settings, select the second option as shown in the reference image.
  1. On your Alexa Developer Console Navigate to Skill Information and copy the Application ID (e.g., amzn1.ask.skill.111ffc3d-229f-46f7-b537-0c19bf89aca2).
  2. Open the Yellow.ai Cloud Platform and go to Extensions. > Channels and select Alexa.
  3. In Alexa skill ID, enter skill ID (example: mzn1.ask.skill.111ffc3d-229f-46f7-b537-0c19bf89aca1).
  4. Click Save.