Channels

To be accessible to your customers, Humley Studio allows you to deploy your conversational assistant on a number of communication channels.

Humley Studio currently supports the following channels:

We are constantly reviewing more channels to be added to Humley Studio.

You can access the Manage Channels page from either the More menu (to the right of each project) on the Project list page (to the right of each project) or from the More menu (next to the project's title) within a project itself. Click on your chosen channel and follow the Setup Guide in the sidebar to link it to your project.

Test Client

You can use the ready-made Test Client to chat with your assistant from within your Humley Studio project without the need to deploy it to a customer-facing channel.

To launch, click Test Client (top-right) -

  1. A chat window will open in a new browser window

  2. If there are intents waiting to be trained, you will be given the chance to initiate training, or ignore and continue to the Test Client chat window

  3. Test your project by chatting to the assistant

  4. Close the chat window to end the session

Humley Conversation API

The Humley Conversation API can be used to create a conversational experience on any platform.

Setup Guide

This API uses basic authentication, and each request must be authenticated to receive a response.
To find your authentication credentials -

  1. Click on the ellipses menu (next to the Project name on the left-hand side of the page) and select Manage Channels.
    Here you will see all the live Channel options, plus the Channels that are coming soon.

  2. Click on the Humley Conversation API card.
    Here you can view the project-specific Username and Password for the Humley Conversation API, and copy each your clipboard if needed.

Our conversation API has two key endpoints - Open Conversation and Talk.

Open Conversation is used to start your conversation and receive the assistant's initial introduction message, if configured.

Talk is used for surface responses to user queries and the main request assistant during the conversation.

Microsoft Teams

Microsoft Teams is a cloud-based team collaboration tool.

Setup Guide

  1. From within your Azure platform, navigate to the 'Bot Services' application. You can do this by searching for 'Bot Services' in the top search bar.

  2. At the top of the Azure Bot Service page, click Add to open the Create Bot Service sidebar on the left-hand side.

  3. Select the 'Bot Channels Registration* card.

  4. Click Create on the Bot Channels Registration page.

  5. Fill in all mandatory fields: Bot Handle, Subscription, Resource Group, Location, etc. In the Messaging Endpoint field, copy and paste in the contents of Humley Request URL field.

  6. Click Create at the bottom of the Bot Channels Registration page.

  7. Once registration is complete, use the Home>Bot Services breadcrumb to navigate to the list of bot services, where your newly created service will be visible. You may need to refresh your page to see this the first time.

Facebook Workplace

Facebook Workplace is a communication tool that connects everyone in your company, even if they are working remotely. It uses familiar features like Groups, Chat, Video calls and Live video broadcasting.

Setup Guide

  1. Navigate to Facebook Workplace and log in as an administrator

  2. On the left hand vertical tool bar, select the Admin Panel button

  3. Under the new menu, select Integrations

  4. From under the "Custom Integrations" segment you will be able to view and edit your existing Facebook bots. Firstly, create a new bot via the "Create Custom Integration" button

  5. A Create modal will appear where you will enter the "Name" of the bot, and perhaps a "Description". Once all fields have been completed, select the create button, finalising the credentials and creating the integration

  6. Navigating back to Humley studio, we will be linking the two platforms via channels. To view the selection of channels within Studio, select the vertical more menu in the top left hand corner and selecting "Manage Channels"

  7. The page will display a selection of channels for your conversational deployment, yet we will focus on Facebook Workplace

  8. Select the channel card, opening the "Configuration" panel on the right hand side. You will see that there are three pieces of information required to successfully activate the channel:

    • Access Token
    • Callback URL
    • Verification Token
  9. In terms of the access token, navigate to the Facebook Workplace and under integration details select "Create Access Token" button. The token is generated, allowing you to copy the values back into the Humley Platform. Select the "Access Token" input field and past the values

  10. Back in Facebook Workplace, from the modal, select the "I Understand" bot and the "Done" button to continue

  11. Still in Facebook Workplace, let’s set up the integration permissions. For our conversational assistant we require the following permissions to be selected:

    • Mention Bot
    • Message any member
    • Delete Chat messages
  12. Once these have been selected, scroll down the page to the "Configure Webhooks" segment

  13. From Humley studio, copy the "Callback URL" in the configuration panel into the "Callback URL" input field

  14. A verification token is also required which is a unique password to your bot. To create this, navigate back to Humley and enter your desired password as an alphanumeric. Copy the created value and pass into the "Verification Token" Input field back in Facebook Workplace.

  15. Once these fields have been completed, select the below options:

    • Mention
    • Messaging_postbacks
    • Message_deliveries
    • Message_reads
    • Messages
  16. All specific fields have now been set up. The final step is to navigate to the bottom of the page and select the save button. The callback URL will be verified saving the credentials and closing the configuration tab.

  17. Now navigate back to Facebook Workplace and select the save button at the bottom of the page. The callback URL will be verified saving the credentials and closing the configuration tab.

  18. Back under the "Custom Integrations" on the "Integrations Page", you will see the newly created bot

  19. Navigate back to the Facebook Workplace home and under the Bots segment of the side menu you will see your newly created Bot. If it is not visible, select the integrations button to view all bots

  20. Select the newly created bot, which opens a new chat window in the bottom right hand side of the screen. Ask the bot a question from your Humley Studio project and view the responses appearing in the chat window

Still need help? Get in touch!
Last updated on 20th Jul 2020