RSS bot for Webex is a parser bot designed to enrich the data provided from any compatible RSS Feeds, and update a Webex space of your choosing whenever there is a new feed.
Note: No initial messages will be published to the spaces when app is loaded. Only when a message is received on the RSS Feed it will be published into the respective space.
- Register a Bot at Webex Developers for your Organization, noting the Token ID
- Create Spaces for Output Messages in Webex App (or skip to step 3 if you have a space/room already)
- Obtain RoomId for the space/room
- Add Bot created in Step 1 to your space.
- Clone / Download repository
- Run
npm installto add the require dependencies (ensure Node and NPM are installed) - Create an
.envfile and include the required variables outlined below.
- Recommend adding
CONSOLE_LEVEL=debugduring initial testing
- Start the integration using
npm run start - Review the console logs to confirm no errors encountered
The simplest deployment method is using Docker and Docker Compose
- Clone / Download repository
- Only docker-compose.yml is needed if using prebuilt docker image
- Update the included docker-compose.yml file with the correct Environmental parameters
-
- Use the prebuilt image available on Docker Hub (default in docker-compose.yml)
- Build local image - Uncomment build and comment image line in docker-compose.yml
- Provision and start the service using
docker-compose up -d - Review the console logs using
docker logs webex-rss -f(assuming you are using the default container name)
These variables can be individually defined in Docker, or loaded as an .env file in the /app directory.
| Name | Type | Default | Description |
|---|---|---|---|
| TOKEN | Required | |
Bot Token for Webex Messaging Posts |
| FEED_ROOM_ID | Required | |
RoomId for Webex Announcement Space |
| RSS_FEED_URL | Required | |
Rss Feed URL to get the feeds |
| RSS_INTERVAL | Optional | 5 |
Interval for RSS Checks (Seconds) |
| Logging Settings | |||
| CONSOLE_LEVEL | no | bool | info |
| APP_NAME | no | string | webex-rss |
| SYSLOG_ENABLED | no | bool | false |
| SYSLOG_HOST | no | string | syslog |
| SYSLOG_PORT | no | num | 514 |
| SYSLOG_PROTOCOL | no | str | udp4 |
| SYSLOG_SOURCE | no | str | localhost |
| LOKI_ENABLED | no | bool | false |
| LOKI_HOST | no | string | http://loki:3100 |
| HTTP Proxy | |||
| GLOBAL_AGENT_HTTP_PROXY | no | string | |
| GLOBAL_AGENT_NO_PROXY | no | string | |
| NODE_EXTRA_CA_CERTS | no | string | |
In case you've found a bug, please open an issue on GitHub.
This application is provided as a sample only and is NOT guaranteed to be bug free and of Production quality.