Now that you've installed Cisco Webex Teams, it's time to set up the app. This short video will show you how to customize your settings and preferences to ge. Webex asks you if you want to allow Cloud App Security access to your team information, activity log, and perform activities as a team member. To proceed, click Allow. Back in the Cloud App Security console, you should receive a message that Webex was successfully connected.
-->APPLIES TO: SDK v4
In this article you will learn how to connect a bot to Webex using the adapter available in the SDK. This article will walk you through modifying the EchoBot sample to connect it to a Webex app.
Note
The instructions below cover the C# implementation of the Webex adapter. For instructions on using the JavaScript implementation, part of the BotKit libraries, see the BotKit Webex documentation.
Prerequisites
- The EchoBot sample code
- Access to a Webex team with sufficient permissions to login to create / manage applications at https://developer.webex.com/my-apps. If you do not have access to a Webex team you can create an account for free at www.webex.com.
Create a Webex bot app
- Log into the Webex developer dashboard and then click the 'Create a new app' button.
- On the next screen choose to create a Webex Bot by clicking 'Create a bot'.
- On the next screen, enter an appropriate name, username and description for your bot, as well as choosing an icon or uploading an image of your own.Click the 'Add bot' button.
- On the next page you will be provided with an access token for your new Webex app, please make a note of this token as you will require it when configuring your bot.
Wiring up the Webex adapter in your bot
Before you can complete the configuration of our Webex app, you need to wire up the Webex adapter into your bot.
Install the Webex adapter NuGet package
Add the Microsoft.Bot.Builder.Adapters.Webex NuGet package. For more information on using NuGet, see Install and manage packages in Visual Studio
Create a Webex adapter class
Create a new class that inherits from the WebexAdapter class. This class will act as our adapter for the Webex channel. It includes error handling capabilities (much like the BotFrameworkAdapterWithErrorHandler class already in the sample, used for handling requests from Azure Bot Service).
Create a new controller for handling Webex requests
We create a new controller which will handle requests from your Webex app, on a new endpoint 'api/webex' instead of the default 'api/messages' used for requests from Azure Bot Service Channels. By adding an additional endpoint to your bot, you can accept requests from Bot Service channels (or additional adapters), as well as from Webex, using the same bot.
Inject Webex Adapter In Your Bot Startup.cs
Add the following line into the ConfigureServices method within your Startup.cs file, which will register your Webex adapter and make it available for your new controller class. The configuration settings, described in the next step, will be automatically used by the adapter.
Once added, your ConfigureServices method should look like this.
Add Webex adapter settings to your bot's configuration file
- Add the 4 settings shown below to your appSettings.json file in your bot project.
- Populate the WebexAccessToken setting within the Webex Bot Access Token, that was generated when creating your Webex bot app in the earlier steps. Leave the other 3 settings empty at this time, until we gather the information needed for them in later steps.
Complete configuration of your Webex app and bot
Create and update a Webex webhook
Now that you have created a Webex app and wired up the adapter in your bot project, the final steps are to configure a Webex webhook, point it to the correct endpoint on your bot, and subscribe your app to ensure your bot receives messages and attachments. To do this your bot must be running, so that Webex can verify the URL to the endpoint is valid.
- To complete this step, deploy your bot to Azure and make a note of the URL to your deployed bot. Your Webex messaging endpoint is the URL for your bot, which will be the URL of your deployed application (or ngrok endpoint), plus '/api/webex' (for example,
https://yourbotapp.azurewebsites.net/api/webex
).NoteIf you are not ready to deploy your bot to Azure, or wish to debug your bot when using the Webex adapter, you can use a tool such as ngrok (which you will likely already have installed if you have used the Bot Framework Emulator previously) to tunnel through to your bot running locally and provide you with a publicly accessible URL for this.Can i download mac os on my pc. If you wish create an ngrok tunnel and obtain a URL to your bot, use the following command in a terminal window (this assumes your local bot is running on port 3978, alter the port numbers in the command if your bot is not). - Navigate to https://developer.webex.com/docs/api/v1/webhooks.
- Click the link for the POST method
https://webexapis.com/v1/webhooks
(with the description Create a webhook). This will display a form that allows you to send a request to the endpoint. - Populate the form with the following details:
- Name - The name for your webhook, for example Messages Webhook.
- TargetUrl - The full URL to your bot's Webex endpoint, such as
https://yourbotapp.azurewebsites.net/api/webex
). - resource - Messages.
- event - Created.
- filter - Leave it blank.
- secret - A secret of your choice to secure your webhook. Later you will add it to your bot's
appsettings.json
.
- Click Run, which should create your webhook and provide you with a success message.
Cisco Webex Meetings Download
Complete the remaining settings in your bot application
Login To Webex Teams Free
Complete the remaining 3 settings in your bot's appsettings.json file (you already populated WebexAccessToken in an earlier step).
- WebexPublicAddress (the full URL to your bot's Webex endpoint)
- WebexSecret (the secret you provided when creating your webhook in the previous step)
- WebexWebhookName (the name for your webhook you provided in the previous step)
Re-deploy your bot in your Webex team
Now that you have completed the configuration of your bot's settings in appsettings.json, you should re-deploy your bot (or restart your bot if you are tunnelling to a local endpoint using ngrok). Configuration of you Webex app and bot are now complete.You can now login to your Webex team at https://www.webex.com and chat with your bot by sending it a message, in the same way you would contact another person.
Text bot allows your customers and partners to send text messages into your business that get delivered into Webex Teams. Your replies to their text messages are typed into Webex Teams then our Text bot sends your replies to the text number it was received from. We allow your customers and partners to interact using their mobile phones without requiring them to install an additional mobile app or login to Webex Teams. Many of the benefits of Webex Teams messaging are leveraged into text messaging.
Imagine allowing the 7 billion mobile phones world-wide to easily and instantly to be able to communicate with the user's teams. We see the potential for the internet of things and text messaging to intersect inside of Webex Teams. Imagine also the potential of connecting our Text bot to other complimentary bots.
Our key industries for the Text Bot are banking, telecommunications, higher education, government, and manufacturing.
Wouldn't it be nice to?
- Text to schedule video interviews for candidates
- Text to schedule accountants, lawyers, loan officers
- Text to open tickets inside of product support
- Text to schedule university professor office hours
- Text to report maintenance requirements for public roads
Login To Webex Teams Online
If you haven’t leased a text number yet from Approved Contact please email [email protected] to begin the process. This service is currently only available in the United States.