Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/FabrizioBrancati/SwiftyBot
How to create a Telegram, Facebook Messenger, and Google Assistant bot with Swift using Vapor on Linux and macOS.
https://github.com/FabrizioBrancati/SwiftyBot
bot bot-platform facebook facebook-messenger-bot google google-assistant-bot linux macos messenger messenger-bot swift swiftybot telegram telegram-bot ubuntu vapor vapor-toolbox xcode
Last synced: 3 months ago
JSON representation
How to create a Telegram, Facebook Messenger, and Google Assistant bot with Swift using Vapor on Linux and macOS.
- Host: GitHub
- URL: https://github.com/FabrizioBrancati/SwiftyBot
- Owner: FabrizioBrancati
- License: mit
- Created: 2016-07-18T22:56:26.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2022-05-18T16:39:31.000Z (over 2 years ago)
- Last Synced: 2024-04-20T18:00:03.530Z (7 months ago)
- Topics: bot, bot-platform, facebook, facebook-messenger-bot, google, google-assistant-bot, linux, macos, messenger, messenger-bot, swift, swiftybot, telegram, telegram-bot, ubuntu, vapor, vapor-toolbox, xcode
- Language: Swift
- Homepage: https://www.fabriziobrancati.com/SwiftyBot-2
- Size: 970 KB
- Stars: 267
- Watchers: 10
- Forks: 42
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: .github/CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://travis-ci.org/FabrizioBrancati/SwiftyBot)
[](https://codecov.io/gh/FabrizioBrancati/SwiftyBot)
[](https://codeclimate.com/github/FabrizioBrancati/SwiftyBot/maintainability)
[](https://codebeat.co/projects/github-com-fabriziobrancati-swiftybot-master)
[](https://www.codacy.com/manual/FabrizioBrancati/SwiftyBot)
[](https://developer.apple.com/swift/)
[](https://developer.apple.com/swift/)
[](https://developer.apple.com/swift/)
[](https://github.com/FabrizioBrancati/SwiftyBot/blob/master/LICENSE)
---
Features •
Platforms and Tutorials •
Language Support •
Requirements •
Communication •
Contributing •
Deploying •
Platforms Usage •
Documentation •
Changelog •
Demos •
Authors •
License
---
Features
========
SwiftyBot is an example of how to create a bot with [Swift](https://swift.org/) on top of [Vapor](https://github.com/vapor/vapor).
Here is the list of all the features:
- [x] Telegram bot integration
- [x] Facebook Messenger bot integration
- [x] Google Assistant bot integration
- [x] Well documented (you can find more in [Documentation](https://github.com/FabrizioBrancati/SwiftyBot#documentation) section)
- [x] Well tested (currently 99% of code coverage)
- [x] Clean (every bot platform has its folder with its files and tests)
- [x] Easy to follow (every bot platform comes with a tutorial, more in [Platforms and Tutorials](https://github.com/FabrizioBrancati/SwiftyBot#platforms-and-tutorials) section)
- [x] Multi language support
> There are a lot of bot platforms out there that can be added...
Platforms and Tutorials
=======================
| **Bot Platform** | **Blog Post Link** |
|--------------------|--------------------|
| Telegram | _[How to create a Telegram bot with Swift using Vapor on Ubuntu / macOS](https://www.fabriziobrancati.com/SwiftyBot)_ |
| Facebook Messenger | _[How to create a Facebook Messenger bot with Swift](https://www.fabriziobrancati.com/SwiftyBot-2)_ |
| Google Assistant | _[Not Available Yet](#)_ |
Language Support
================
- English (en)
Requirements
============
- Ubuntu 14.04 or later with Swift 5.1 or later / macOS with Xcode 11.2 or later
- Telegram account and a Telegram app for any platform (Telegram bot only)
- Facebook account and a Facebook Messenger app for any platform (Facebook Messenger bot only)
- Google account and a Google Assistant app for any platform (Google Assistant bot only)
Communication
=============
- If you need help, open an issue.
- If you found a bug, open an issue.
- If you have a feature request, open an issue.
- If you want to contribute, see [Contributing](https://github.com/FabrizioBrancati/SwiftyBot#contributing) section.
Contributing
============
See [CONTRIBUTING.md](https://github.com/FabrizioBrancati/SwiftyBot/blob/master/.github/CONTRIBUTING.md) file.
Deploying
=========
## Private Server
1. Install Swift on your computer / server
2. Install [Vapor Toolbox](https://github.com/vapor/toolbox) (Optional)
3. Enable TLS (You can use [Let's Encrypt](https://letsencrypt.org))
4. Use Apache or nginx as reverse proxy
5. Use Supervisor to ensure your bot is always up and running
If you need more help through this steps, you can read [How to create a Facebook Messenger bot with Swift](https://www.fabriziobrancati.com/SwiftyBot-2) blog post, from [Step 1](https://www.fabriziobrancati.com/SwiftyBot-2#step-1) to [Step 4](https://www.fabriziobrancati.com/SwiftyBot-2#step-4).
## Heroku
[](https://heroku.com/deploy)
1. Click the button above
2. Go to the _Settings_ section of your application
3. Click on the _Reveal Config Vars_ button in _Config Vars_ section
4. Copy all the created secret key set to up the bots, read the next sections for more info
## Vapor Cloud
1. Create an account on [Vapor Cloud](https://dashboard.vapor.cloud)
2. Create an organization
3. Create a project
4. Create an application
5. Add an hosting service and connect it to your GitHub repository
6. Add at least 1 environment, 2 is better
7. Use the [Vapor Toolbox](https://github.com/vapor/toolbox) to deploy your bot
Platforms Usage
===============
## Telegram
1. Set a secret key in `TELEGRAM_SECRET` environment variable
2. Create a Telegram bot with [BotFather](https://telegram.me/botfather)
If you need more help through this steps, you can read [How to create a Telegram bot with Swift using Vapor on Ubuntu / macOS](https://www.fabriziobrancati.com/SwiftyBot) blog post.
## Facebook Messenger
1. Set a secret key in `MESSENGER_SECRET` environment variable
2. Create a Facebook app and Page
3. Get a Page access token and set it in `MESSENGER_TOKEN` environment variable
If you need more help through this steps, you can read [How to create a Facebook Messenger bot with Swift](https://www.fabriziobrancati.com/SwiftyBot-2) blog post.
## Google Assistant
1. Set a secret key in `ASSISTANT_SECRET` environment variable
2. Create an Actions on Google project
3. Setup Actions on Google project on Dialogflow
Documentation
=============
## Bot
- Every line of every project file is commented.
- If you need Vapor documentation you can find it [here](https://docs.vapor.codes/).
## Platforms
- If you need Telegram bot documentation you can find it [here](https://core.telegram.org/bots/api).
- If you need Facebook Messenger bot documentation you can find it [here](https://developers.facebook.com/docs/messenger-platform).
- If you need Google Assistant bot documentation you can find it [here](https://developers.google.com/assistant) and [here](https://dialogflow.com/docs). You can also find some JSON examples [here](https://developers.google.com/actions/conversation-api-playground) and [here](https://github.com/dialogflow/fulfillment-webhook-json).
Changelog
=========
To see what has changed in recent version of SwiftyBot, see the **[CHANGELOG.md](https://github.com/FabrizioBrancati/SwiftyBot/blob/master/CHANGELOG.md)** file.
Demos
=====
### Telegram
You can open Telegram and search for **[SwiftyBot](https://telegram.me/SwiftyBot)** to start talking with him!
### Facebook Messenger
You can open Facebook Messenger and search for **[SwiftyBotMessenger](http://m.me/SwiftyBotMessenger)** to start talking with him!
### Google Assistant
You can open Google Assistant and write **[Talk to SwiftyBot](https://assistant.google.com/services/invoke/uid/000000d447b4593f)** to start talking with him!
Authors
=======
### Bot
**Fabrizio Brancati**
[https://www.fabriziobrancati.com](https://www.fabriziobrancati.com) - [[email protected]](mailto:[email protected])
### Icon
**Roberto Chiaveri**
[http://robertochiaveri.it](http://robertochiaveri.it)
License
=======
SwiftyBot is available under the MIT license. See the **[LICENSE](https://github.com/FabrizioBrancati/SwiftyBot/blob/master/LICENSE)** file for more info.