You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
This repository was archived by the owner on Oct 21, 2024. It is now read-only.
Copy file name to clipboardExpand all lines: README.md
+19-20Lines changed: 19 additions & 20 deletions
Original file line number
Diff line number
Diff line change
@@ -9,40 +9,39 @@ The Microsoft Bot Framework requires that the connector is available via https.
9
9
Your bot needs to be published and you need to know the engine url.
10
10
11
11
## Setup instructions
12
+
### Create an app in Microsoft's Application Registration Portal
13
+
Before we can deploy our connector, we need an 'Application Id' and 'Application password' from Microsoft. To obtain those, we need to create an app in Microsoft's Application Registration Portal.
14
+
1. Go to [https://apps.dev.microsoft.com/](https://apps.dev.microsoft.com/#/appList) and choose 'Add an app'
15
+
2. Provide an 'Application Name' (for example, your bot's name) and click 'Create'
16
+
3. Copy the 'Application Id' in the 'Properties' section, you will need it later.
17
+
4. Under 'Application Secrets' click 'Generate new password'. Copy the password that is shown in the popup, you will need it later. Store it securely. This is the only time when it will be displayed.
12
18
13
-
### Setup the bot connector
19
+
### Deploy the bot connector
14
20
Click the button below to deploy the connector to Heroku:
The values for 'Config Vars' section will be set after later on. For now, click 'View app' and copy the url of your Heroku app, you will need it in the next step.
24
+
25
+
In the 'Config Vars' section, add the following:
26
+
***MICROSOFT_APP_ID:** The 'Application Id' you copied earlier.
27
+
***MICROSOFT_APP_PASSWORD:** The Application password you copied earlier.
28
+
***TENEO_ENGINE_URL:** The engine url.
29
+
30
+
Click 'View app' and copy the url of your Heroku app, you will need it in the next step.
31
+
32
+
If you prefer to run your bot locally, see [Running the connector locally](#running-the-connector-locally).
19
33
20
34
### Register a bot with the Azure Bot Service
21
35
To register your bot with the Azure Bot Service, you will need to create a new 'Bot Channels Registration'.
22
-
1.Go to [https://portal.azure.com/#home](https://portal.azure.com/#home) and in the search bar, find "Bot Channel Registration".
36
+
1.Visit [https://portal.azure.com/#create/hub](https://portal.azure.com/#create/hub) and click 'Create'.
23
37
2. Give the bot a name, this name will be available in Skype etc.
24
38
3. Provide the details for the Subscription, Resource Group and Location.
25
39
4. For 'Pricing Tier' you can choose the free 'F0 (10K Premium Messages)' during development.
26
40
5. Enter the following URL in the Messaging Endpoint field: https://[yourherokuappname].herokuapp.com/api/messages (replace [yourherokuappname] with the name of your app on Heroku).
27
-
6. Click 'Create'. You will be notified when the bot is available.
28
-
29
-
### Create an app in Microsoft's Application Registration Portal
30
-
Before we can deploy our connector, we need an 'Application Id' and 'Application password' from Microsoft. To obtain those:
31
-
1. Go to [https://portal.azure.com/#home](https://portal.azure.com/#home) and in the search bar, find "App Registration".
32
-
2. Go into the "Applications from personal account" tab, and click on your bot's name.
33
-
3. Click on the "Overview" menu section. Stroe the Application (client) ID value (`Application (client) ID`) somewhere safe. You will need it later for the `MICROSOFT_APP_ID` Config Variable
34
-
4. Click on the "Certificates & Secrets" menu section. Create a `MICROSOFT_APP_PASSWORD` by clicking `+New Client Secret`. Copy the newly generated value, you will need it later. Store it securely. This is the only time when it will be displayed.
35
-
36
-
### Deploy the bot connector
37
-
Go back to the Settings section of your Heroku setup.
38
-
39
-
In the 'Config Vars' section, add the following:
40
-
***MICROSOFT_APP_ID:** The 'Application Id' you copied earlier.
41
-
***MICROSOFT_APP_PASSWORD:** The Application password you copied earlier.
42
-
***TENEO_ENGINE_URL:** The engine url.
41
+
6. Click on 'Auto create App ID and password' and in the 'blade' that appears click 'Create new' and in the next blade that appears enter your Application Id and Application Password and click 'Ok'.
42
+
7. Click 'Create' in the first blade to create your bot. You will be notified when the bot is available.
43
43
44
44
That's it! You can now test your bot by opening your bot resource in the Azure portal and choosing 'Test in Web Chat'.
45
-
If you prefer to run your bot locally, see [Running the connector locally](#running-the-connector-locally).
46
45
47
46
### Add a channel
48
47
You can make your bot available on various channels by opening your bot resource in the Azure portal and choosing 'Channels'. As you can see, your bot is already available via the web channel. From here you can choose to make your bot available on other channels like Microsoft Teams or Skype.
0 commit comments