Package Information
Released: this month
Downloads: 0 weekly / 0 monthly
Latest Version: 0.1.0
Author: Mehran Asgharian
Available Nodes
Documentation generating…
Documentation
n8n-nodes-soroush
Community node for n8n to interact with the Soroush Plus (سروشپلاس) Bot Platform and Mini App (برنامک) ecosystem.
Features
- Bot Operations: Get bot identity and account information (
getMe). - Messaging: Send text messages (
MarkdownV2,HTML,Markdown), photos, videos, audio, voice notes, animations (with caption), documents, contacts, and map locations (withhorizontal_accuracy). - Message Management: Forward, copy, edit text, and delete messages.
- Mini App (برنامک) Integration:
- Send Mini App Button: Send messages with interactive Mini App launch buttons (both inline keyboard and reply keyboard).
- Verify Init Data: Cryptographically validate
Soroush.WebApp.initDatausingHMAC-SHA-256(WebAppDatasecret key derivation andauth_dateexpiration check). - Mini App Trigger Event: Trigger workflows automatically when a user sends data back from a Mini App (
web_app_data).
- Interactive Keyboards: Full support for inline keyboards and callback query handling (
answerCallbackQuery). - Chat & Member Management: Pin/unpin messages, get member counts, ban/unban users, and leave chats.
- Two Trigger Modes:
- Soroush Plus Trigger: Real-time push updates via secure HTTPS webhooks (
setWebhookon ports443,80,88, or8443) with optional media download. - Soroush Plus Poll Trigger: Long polling (
getUpdates) for local development without a public HTTPS URL.
- Soroush Plus Trigger: Real-time push updates via secure HTTPS webhooks (
Installation
Install in your n8n instance via Settings > Community Nodes > Install:n8n-nodes-soroush
Credentials
- Open Soroush Plus and message
@botfather(splus.ir/botfather) to create your bot and receive an API token. - In n8n, add a Soroush Plus API credential and enter your bot token.