Feature/add telegram integration

[pulinduvidmal]

Description

Type of Change

• Bug fix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)
• Breaking change (fix or feature that would cause existing functionality to not work as expected)
• Documentation update
• Refactoring (no functional changes)
• Performance improvement
• Test update
• CI/CD update
• Other (please describe):

Related Issues

Changes Made

Testing

• Unit tests pass locally
• Integration tests pass locally
• Manual testing completed
• New tests added for changes

Checklist

• My code follows the project's style guidelines
• I have performed a self-review of my code
• I have commented my code, particularly in hard-to-understand areas
• I have made corresponding changes to the documentation
• My changes generate no new warnings
• I have added tests that prove my fix is effective or that my feature works
• New and existing unit tests pass locally with my changes
• Any dependent changes have been merged and published

Screenshots (if applicable)

Additional Notes

[Copilot]

Pull request overview

This PR adds Telegram Bot integration to Agent Kernel, enabling deployment of AI agents as Telegram bots. The integration uses webhooks to receive messages from Telegram and responds with AI-generated content from configured agents. This brings Agent Kernel's messaging platform support in line with existing integrations like WhatsApp, Messenger, and Slack.

Key changes:

• New AgentTelegramRequestHandler class for handling Telegram Bot API webhooks
• Configuration support for Telegram bot token and webhook secrets
• Complete example implementation with tests and comprehensive documentation
• Version bump to 0.2.7 across all dependency lock files

Reviewed changes

Copilot reviewed 13 out of 36 changed files in this pull request and generated 10 comments.

Show a summary per file

File	Description
ak-py/pyproject.toml	Adds telegram optional dependency group with httpx requirement
ak-py/uv.lock	Updates to include telegram extras and httpx dependency
ak-py/src/agentkernel/telegram.py	Entry point module for Telegram integration
ak-py/src/agentkernel/integration/telegram/init.py	Package initialization and exports
ak-py/src/agentkernel/integration/telegram/telegram_chat.py	Core implementation of webhook handler and message processing
ak-py/src/agentkernel/integration/telegram/README.md	Integration-level documentation for Telegram
ak-py/src/agentkernel/core/config.py	Adds _TelegramConfig class for bot configuration
examples/api/telegram/*	Complete working example with server, tests, config, and build script
docs/docs/integrations/telegram.md	User-facing documentation for Telegram integration
examples/*/uv.lock	Version updates from agentkernel 0.2.6 to 0.2.7 across all examples

Comments suppressed due to low confidence (2)

ak-py/src/agentkernel/integration/telegram/telegram_chat.py:1

• Import of 'hashlib' is not used.

import hashlib

ak-py/src/agentkernel/integration/telegram/telegram_chat.py:2

• Import of 'hmac' is not used.

import hmac

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.