Integrate Digital IVA in Studio with VCC

Follow these instructions to access the Studio Digital IVA from a VCC IVR script. A Studio chatbot task runs with the permissions assigned to the Studio API key.

Studio API Key

  1. Generate a Studio API key with build permissions.

    1. From the Manage menu, select API Keys.

    2. Click Add API Key.

    3. Fill in the API key properties.

      For more information on API key properties, see API Keys.

    4. Click Edit Permissions.

    5. Select Build to grant build permissions to the API key.

  2. Copy the Studio API key.

    1. From the Manage menu, select API Keys.

    2. Select the API key you added earlier.

      Properties of the selected API key display to the right.

    3. From the properties display, copy the API key.

  3. Paste the Studio API key in the VCC auth profile.

    Create an auth profile from the Admin Console or VCC menu Actions > Configure.

    Configure the auth profile as follows.

    Field

    Description

    Type

    Select Basic.

    Name

    Enter the name of the auth profile.

    User Name

    Enter apiKey.

    Password

    Paste the Studio API key.

  4. Add the VCC auth profile to the IVA transfer module.

    Do this when you are configuring the IVA transfer module. See further down in these instructions.

Studio Chatbot Task

  1. Create a Studio chatbot task.

    1. From the Build menu, select Tasks.

    2. From the tabs at the top of the screen, select Chatbot.

    3. Click Create Chatbot task.

    4. Fill in the task properties.

      For more information on chatbot task properties, see Task Properties - Digital.

  2. Copy the Studio chatbot task key.

    Do this when you are configuring the IVA transfer module. See further down in these instructions.

    If you are using the call flow editor, see ChatBot Key/Workflow Key to copy the chatbot task key.

    Alternatively, copy the chatbot task key as follows.

    1. From the Build menu, select Tasks.

    2. From the tabs at the top of the screen, select Chatbot.

    3. Select the chatbot task you created earlier.

      Properties of the selected chatbot task display to the right.

    4. From the properties display, copy the task key.

IVA Transfer Module

The IVA transfer module in the IVR script transfers the flow to the Studio chatbot task.

Edit the IVA transfer module properties.

  1. On the General tab, fill in the AI Provider field.

    Region

    Description

    US

    The format for the AI provider is https://interaction.us7.studioportal.io//tasks/<your Studio chatbot task key here>

    Example:

    https://interaction.us7.studioportal.io//tasks/52e37d5e2dbdd534a72784171614c2005176c2d87e4bd0f388cf7194d5c17370

    EU

    The format for the AI provider is studio://<your Studio chatbot task key here>

    Example:

    studio://52e37d5e2dbdd534a72784171614c2005176c2d87e4bd0f388cf7194d5c17370

  2. Add the VCC auth profile to the Authorization tab.

    1. Select the Authorization tab.

    2. Select the Authorization Profile option.

    3. In the Name field, select the VCC auth profile created above.

For more information on the IVA transfer module and how to configure it, see the IVA transfer module.