Send SMS to and from Webex spaces using a Webex bot. Powered by Cisco's IMIMobile acquisition.
Report Bug
·
Request Feature
New Video!
Link to previous video
To begin using the production version of this bot, send a Webex message to imidemo@webex.bot
(You can send a Webex message to a bot the same way you send a message to a person)
Configuring a Team
- If you have no teams configured, you should add a team first with the add team button.
- You can enter any team name (i.e. your name)
- And any US/Canadian, or Irish mobile number that is SMS enabled. (i.e. your cell/mobile number)
Note: a team in the bot's context is currently just a single SMS number
Sending an SMS
- Once a team has been configured, you can select the team from the dropdown in the card.
- With a team selected, enter the text you want to send to the SMS number.
- Click send, and the mobile number configured as the team should receive the SMS.
- With your mobile device, you can reply one time to the message received by your mobile device.
- Both the sent and received messages should appear in the Webex chat with the bot.
Configuring a Custom Bot
This bot can be themed to look more like a given org or customer's brand.
To get started, click the customize button of the card returned by imidemo@webex.bot. Then,
- Create a Webex bot. The bot's name and icon should fit the desired look and feel. For example, if you are creating the bot to look like a bot for a specific retail store, consider naming the bot something like, "My Retail Store Notification Bot," and using the logo of the retailer as the bot's icon.
- Once you've created the bot, enter the bot's auth token in the corresponding card field.
- Use an image for the card header. This can be the same image you used as the bot's logo, or a different image, but the image will need to be a public link to a .jpg or .png file.
- Optionally, uncheck or check "Show Instructions"
- Optionally change the name of the card header
- Click "Add bot"
Once you've created a custom bot, our code will automatically configure webhooks to use for your new bot. You can then interact with the bot similar to how imidemo@webex.bot works, and use the new bot to send/receive SMS!
node v14.5.0
npm 7.24.2
npm dependencies:
dotenv: ^8.2.0
express: ^4.17.1"
got: ^11.8.3
mongodb: ^4.2.1
After you clone this repo, you will need to configure a .env file (you can copy from sample.env to get started. However, this code relies on an imiconnect flow to send and receive SMS. Please reach out to wxsd@external.cisco.com for help configuring your own installation. Once you've setup the .env file and imiconnect flows, you can simply:
npm init
npm install
npm start
All contents are licensed under the MIT license. Please see license for details.
Everything included is for demo and Proof of Concept purposes only. Use of the site is solely at your own risk. This site may contain links to third party content, which we do not warrant, endorse, or assume liability for. These demos are for Cisco Webex usecases, but are not Official Cisco Webex Branded demos.
Please contact us at wxsd@external.cisco.com