diff --git a/docs/community/community-packages.md b/docs/community/community-packages.md index 97b5f557..0363e9f1 100644 --- a/docs/community/community-packages.md +++ b/docs/community/community-packages.md @@ -52,6 +52,120 @@ 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. + +### 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.