Download the PHP package andisiahaan/gramsea-telegram-bot without Composer

Gramsea Telegram Bot PHP Library

Library PHP sederhana dan powerful untuk berinteraksi dengan Telegram Bot API tanpa dependensi framework.

✨ Fitur

• 🚀 Zero Framework Dependencies - PHP murni, bisa digunakan di mana saja
• 🎯 Magic Method - Panggil method API Telegram langsung
• 📦 Fluent Sender Classes - Method chaining untuk mengirim pesan
• 📨 Update Wrapper - Object-oriented access ke webhook data
• 🖼️ Media Helper - Deteksi otomatis tipe file
• ⌨️ Keyboard Builder - Fluent builder untuk inline & reply keyboard
• 🔘 Callback Data - Encode/decode callback data dengan kompresi
• 🔗 Deep Link - Generate & parse deep links dan referral codes
• ✍️ Text Formatter - Fluent builder untuk formatting HTML
• 📏 Limits Helper - Constants dan validasi untuk Telegram limits
• 😀 Emoji Constants - Collection emoji yang sering dipakai
• 🔧 Moderation Tools - Ban, mute, restrict, pin messages
• ⚠️ Exception Handling - Custom exception untuk error handling

📦 Instalasi

🚀 Quick Start

Penggunaan Dasar

Menggunakan Fluent Sender (Recommended)

📖 Dokumentasi

Class Gramsea

Class utama dengan magic method untuk semua Telegram Bot API.

Sender Factory Methods

Webhook Management

Chat Member Checks

Chat Actions

Moderation

Keyboard Builders

Bot Commands

File Operations

📨 Sender Classes

Library menyediakan 5 sender class dengan fluent chaining API:

MessageSender (Recommended)

Auto-detects dan delegates ke sender yang tepat:

• Text only → TextSender
• 1 media → MediaSender
• 2+ media → MediaGroupSender

TextSender

Untuk text message dengan kontrol penuh atas link preview.

Link Preview Methods:

• noPreview() - Disable link preview
• previewUrl($url) - Set custom URL for preview
• smallPreview() - Prefer small media
• largePreview() - Prefer large media
• previewAboveText() - Show preview above message text

MediaSender

Untuk single media dengan caption.

Media Methods:

• photo($url), video($url), audio($url), document($url), animation($url), voice($url)
• media($url) - Auto-detect type dari extension
• caption($text) - Set caption (supports markdown)
• captionHtml($html) - Set caption tanpa konversi

MediaGroupSender

Untuk mengirim album (2-10 media items).

Media Group Rules:

• ✅ Photo + Video = OK
• ✅ Document + Document = OK
• ✅ Audio + Audio = OK
• ❌ Photo + Document = NOT OK
• ❌ Video + Audio = NOT OK

Common Chaining Methods

Semua sender class memiliki method berikut:

MassMessageSender

Untuk mengirim pesan secara concurrent ke banyak target sekaligus menggunakan Guzzle Pool. Setiap target memiliki konten sendiri (text, media, reply_markup).

Target Format:

• chat_id (required) - Target chat ID
• text (optional) - Text pesan (supports markdown)
• media (optional) - String atau array URL media
• reply_markup (optional) - Keyboard (hasil dari ReplyMarkup class)

Result Methods (MassSendResult):

Global Options:

📨 Update Wrapper

Object-oriented wrapper untuk mengakses data webhook.

Type Checks:

• isMessage(), isEditedMessage(), isChannelPost(), isEditedChannelPost()
• isCallbackQuery(), isInlineQuery()
• isMyChatMember(), isChatMember(), isChatJoinRequest()
• hasMessage() - any message type

Message Object:

• text(), caption(), textOrCaption()
• from(), chat(), chatId(), fromId()
• hasPhoto(), hasVideo(), hasDocument(), hasMedia()
• isCommand(), command(), commandArgs()
• isReply(), replyToMessage()

Chat Object:

• id(), type(), name(), username()
• isPrivate(), isGroup(), isSupergroup(), isChannel()

User Object:

• id(), fullName(), username(), languageCode()
• isPremium(), mentionHtml()

Support Classes

Support\DeepLink

Generate dan parse Telegram deep links.

Support\TextFormatter

Fluent builder untuk HTML formatting.

Support\ReplyMarkup

Format keyboard markup dengan auto row wrapping.

Support\Limit

Constants untuk Telegram API limits.

Support\Emoji

Emoji constants yang sering dipakai.

Support\MediaHelper

Deteksi tipe media dari file extension.

Support\InlineKeyboard

Fluent builder untuk inline keyboard dengan pattern umum.

Support\CallbackData

Encode/decode callback data dengan kompresi untuk ID besar.

Curl Configuration

Exception Handling

Library menyediakan exception classes yang spesifik untuk berbagai error dari Telegram API:

Basic Usage

Exception Methods

ApiException (Base Class)

ForbiddenException

NotFoundException

ConflictException

TooManyRequestsException

NetworkException

📁 Struktur Library

🧪 Testing

📄 License

MIT License - lihat LICENSE

👤 Author

Andi Saputra Siahaan

• Website: andipedia.com
• Email: [email protected]