Russenger

Russenger is a Rust library that makes it easy to create Facebook Messenger bots. You can check out the documentation here.

Projects using Russenger:

• ankamantatra-bot
• gemini-bot
• examples

Features

• ORM Integration: Built-in support for rusql-alchemy.
• Facebook Verify Token Support: Automatically handles token verification at the /webhook endpoint when you start the application.
• Response Types Supported:
  • Text Messages
  • GenericModel
  • QuickReply
  • Media
  • Actions (e.g., TypingOn/TypingOff)
  • PersistentMenu

Getting Started

Install cargo-generate

cargo install cargo-generate

Create a New Project

cargo generate --git https://github.com/j03-dev/russenger_template

Configuration

For more configuration, update the .env file in your project's root directory:

PORT=8000
HOST=0.0.0.0
VERIFY_TOKEN=your_verify_token
FACEBOOK_API_VERSION=v19.0
DATABASE_URL=postgres://<username>:<password>@<hostname>/<dbname>
PAGE_ACCESS_TOKEN=your_page_access_token_from_facebook_developer

Manual Setup

If you prefer a manual setup, add the following dependencies to your Cargo.toml:

[dependencies]
russenger = { version = "0.3.5-rc", features = ["postgres"] } # supports 'sqlite, postgres, mysql'
actix-web = "4"
sqlx = "^0.8.0"

Contributing

Feel free to contribute by fixing typos, improving documentation, or adding new features. Any help is appreciated!