From f203aed66d8b4fd429e2311229bb975fdafae5fd Mon Sep 17 00:00:00 2001 From: eraykeskinmac Date: Thu, 6 Nov 2025 15:07:34 +0300 Subject: [PATCH] docs: add strands-telegram-listener to Community Packages Add strands-telegram-listener v1.0.1 - a production-ready real-time Telegram message processing tool with AI-powered auto-responses and background monitoring. Features: - Real-time processing with long polling for instant message processing - AI auto-replies with intelligent responses powered by Strands agents - Event storage with comprehensive message logging (JSONL format) - Smart filtering with message deduplication and own message filtering - Configurable environment variable control for auto-reply behavior - Background processing with non-blocking operation and thread safety - Perfect companion to strands-telegram for complete Telegram ecosystems Package: https://pypi.org/project/strands-telegram-listener/ GitHub: https://github.com/eraykeskinmac/strands-telegram-listener --- docs/community/community-packages.md | 187 +++++++++++++++++++++++++++ 1 file changed, 187 insertions(+) diff --git a/docs/community/community-packages.md b/docs/community/community-packages.md index 97b5f557..c5c41aaf 100644 --- a/docs/community/community-packages.md +++ b/docs/community/community-packages.md @@ -52,6 +52,193 @@ The [strands-agents-tools](https://github.com/strands-agents/tools) repository s - [sleep](https://github.com/strands-agents/tools/blob/main/src/strands_tools/sleep.py) - includes explicit error checking with messages that guide the caller on how to correct errors - [browser](https://github.com/strands-agents/tools/blob/main/src/strands_tools/browser/__init__.py) - detailing how to support multiple tools that share a common core. +### Community Tool Packages + +#### Communication & Messaging + +**[strands-telegram](https://pypi.org/project/strands-telegram/)** + +A production-ready, comprehensive Telegram Bot API integration providing complete access to the Telegram Bot API with 60+ methods. Enables agents to create sophisticated Telegram bots and messaging workflows with full API coverage. + +```bash +pip install strands-telegram +``` + +Key Features: +- ๐Ÿ“จ Complete Bot API with 60+ Telegram API methods (messages, media, keyboards, polls, groups) +- ๐ŸŽฎ Interactive Elements including inline keyboards, polls, dice games, location sharing +- ๐Ÿ‘ฅ Group Management with admin tools, user management, permissions control +- ๐Ÿ“ Media Support for photos, videos, documents, audio, stickers, voice messages +- ๐Ÿ”— Webhooks with full webhook support for real-time message processing +- ๐Ÿ› ๏ธ Custom API Calls extensible for any Telegram Bot API method + +```python +from strands import Agent +from strands_telegram import telegram + +agent = Agent(tools=[telegram]) + +# Send messages +agent("send a Telegram message to @username: Hello from AI agent!") + +# Interactive keyboards +agent("send a poll to Telegram: What's your favorite color? Red, Blue, Green") + +# Media sharing +agent("send this image to Telegram with caption: image.jpg") +``` + +Perfect for global communication (800M+ users), sophisticated user experiences, customer support automation, and comprehensive Telegram bot workflows with full API access. + +**[strands-telegram-listener](https://pypi.org/project/strands-telegram-listener/)** + +A production-ready real-time Telegram message processing tool with AI-powered auto-responses and background message monitoring. Enables agents to listen for incoming Telegram messages and respond intelligently in real-time. + +```bash +pip install strands-telegram-listener +pip install strands-telegram # Companion package +``` + +Key Features: +- ๐ŸŽง Real-time Processing with long polling for instant message processing +- ๐Ÿค– AI Auto-Replies with intelligent responses powered by Strands agents +- ๐Ÿ“Š Event Storage including comprehensive message logging and history (JSONL format) +- ๐Ÿ” Smart Filtering with message deduplication and own message filtering +- โš™๏ธ Configurable through environment variable control for auto-reply behavior +- ๐Ÿงต Background Processing with non-blocking operation and thread safety + +```python +from strands import Agent +from strands_telegram_listener import telegram_listener + +agent = Agent(tools=[telegram_listener]) + +# Start listening for messages +agent("start listening to Telegram messages and respond with AI") + +# Get recent message history +agent("show me the last 10 Telegram messages received") + +# Check listener status +agent("what's the status of the Telegram listener?") +``` + +Perfect for creating interactive chatbots, customer support automation, real-time conversation AI, and complete Telegram ecosystems when paired with strands-telegram. + +### Community Tool Packages + +#### Communication & Messaging + +**[strands-telegram](https://pypi.org/project/strands-telegram/)** + +A production-ready, comprehensive Telegram Bot API integration providing complete access to the Telegram Bot API with 60+ methods. Enables agents to create sophisticated Telegram bots and messaging workflows with full API coverage. + +```bash +pip install strands-telegram +``` + +Key Features: +- ๐Ÿ“จ Complete Bot API with 60+ Telegram API methods (messages, media, keyboards, polls, groups) +- ๐ŸŽฎ Interactive Elements including inline keyboards, polls, dice games, location sharing +- ๐Ÿ‘ฅ Group Management with admin tools, user management, permissions control +- ๐Ÿ“ Media Support for photos, videos, documents, audio, stickers, voice messages +- ๐Ÿ”— Webhooks with full webhook support for real-time message processing +- ๐Ÿ› ๏ธ Custom API Calls extensible for any Telegram Bot API method + +```python +from strands import Agent +from strands_telegram import telegram + +agent = Agent(tools=[telegram]) + +# Send messages +agent("send a Telegram message to @username: Hello from AI agent!") + +# Interactive keyboards +agent("send a poll to Telegram: What's your favorite color? Red, Blue, Green") + +# Media sharing +agent("send this image to Telegram with caption: image.jpg") +``` + +Perfect for global communication (800M+ users), sophisticated user experiences, customer support automation, and comprehensive Telegram bot workflows with full API access. + +### Community Tool Packages + +#### Communication & Notifications + +**[strands-teams](https://pypi.org/project/strands-teams/)** + +A production-ready Microsoft Teams notifications tool powered by Adaptive Cards and rich messaging capabilities. Enables agents to send beautiful, interactive notifications to Teams channels with professional UI elements. + +```bash +pip install strands-teams +``` + +Key Features: +- ๐ŸŽจ Adaptive Cards with rich, interactive message cards and modern UI +- ๐Ÿ“‹ Pre-built templates for notifications, approvals, status updates, and more +- โšก Custom Cards with full adaptive card schema support for unlimited flexibility +- ๐Ÿ”˜ Action Buttons for interactive elements like approve/reject functionality +- ๐ŸŽฏ Rich Formatting with Markdown support, images, media, and color coding +- ๐Ÿ› ๏ธ Easy Integration as a drop-in tool for Strands agents + +```python +from strands import Agent +from strands_teams import teams + +agent = Agent(tools=[teams]) + +# Simple notification +agent("send a Teams message: New lead from Acme Corp") + +# Use pre-built templates +agent("send an approval request to Teams for the Q4 budget") + +# Status updates with rich formatting +agent("send a status update to Teams: website redesign is 75% complete") +``` + +Perfect for enterprise communication, team collaboration, workflow notifications, approval processes, and professional team messaging for AI agents. + +### Community Tool Packages + +#### CRM & Customer Data + +**[strands-hubspot](https://pypi.org/project/strands-hubspot/)** + +A production-ready HubSpot CRM tool designed for **READ-ONLY** operations with zero risk of data modification. Enables agents to safely access and analyze CRM data without any possibility of corrupting customer information. + +```bash +pip install strands-hubspot +``` + +Key Features: +- ๐Ÿ” Universal READ-ONLY access to all HubSpot object types (contacts, deals, companies, tickets) +- ๐Ÿ”Ž Smart search with advanced filtering and property-based queries +- ๐Ÿ“„ Detailed object retrieval by ID with customizable property selection +- ๐Ÿท๏ธ Property discovery and metadata exploration for any object type +- ๐Ÿ‘ค User management and owner details retrieval +- ๐Ÿ›ก๏ธ 100% safe design with NO CREATE, UPDATE, or DELETE operations + +```python +from strands import Agent +from strands_hubspot import hubspot + +agent = Agent(tools=[hubspot]) + +# Search contacts (READ-ONLY) +agent("find all contacts created in the last 30 days") + +# Get company details (READ-ONLY) +agent("get company information for ID 67890") + +# List available properties (READ-ONLY) +agent("show me all available deal properties") +``` + +Perfect for sales intelligence, customer research, data analytics, and CRM workflows that require safe data access without modification risks. + ## Support & Resources Building community packages extends the Strands Agents ecosystem and helps other developers solve complex problems with AI agents. Your contributions make the entire community more capable and productive.