PHPackages                             koyabu/telegramapi - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. koyabu/telegramapi

ActiveLibrary[API Development](/categories/api)

koyabu/telegramapi
==================

Telegram API Client

081PHP

Since Nov 28Pushed 5mo agoCompare

[ Source](https://github.com/stievenk/TelegramAPI)[ Packagist](https://packagist.org/packages/koyabu/telegramapi)[ RSS](/packages/koyabu-telegramapi/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependenciesVersions (1)Used By (1)

📦 Koyabu Telegram API Client (PHP)
==================================

[](#-koyabu-telegram-api-client-php)

`koyabu/telegramapi` adalah library PHP sederhana dan fleksibel untuk berkomunikasi dengan **Telegram Bot API**, mendukung pengiriman pesan, media, webhook, update, dan berbagai fitur Telegram lainnya.

Library ini dibangun menggunakan **GuzzleHttp** sebagai HTTP client.

---

🚀 Fitur Utama
-------------

[](#-fitur-utama)

- Mengirim pesan text
- Mengirim photo, video, audio, document, voice
- Mengirim album (media group)
- Edit message
- Delete message
- Mendapatkan update (long polling)
- Mengatur webhook (setWebhook / deleteWebhook)
- Mendapatkan file & membuat URL unduhan
- Mendapatkan informasi bot (`getMe`)
- Mengirim *typing action* (sendChatAction)

---

📥 Instalasi
-----------

[](#-instalasi)

Install via Composer:

```
composer require koyabu/telegramapi
```

Atau tambahkan pada `composer.json`:

```
{
  "require": {
    "koyabu/telegramapi": "dev-master"
  }
}
```

---

🛠 Cara Menggunakan
------------------

[](#-cara-menggunakan)

### 1. Inisiasi Class

[](#1-inisiasi-class)

```
use Koyabu\TelegramAPI\Telegram;

$bot = new Telegram([
    'token'   => 'YOUR_TELEGRAM_BOT_TOKEN',
    'botname' => 'MyAwesomeBot'
]);
```

---

📤 Mengirim Pesan
----------------

[](#-mengirim-pesan)

### 1. Kirim Pesan Text

[](#1-kirim-pesan-text)

```
$bot->sendMessage(123456789, "Halo dunia!");
```

### 2. Kirim Photo

[](#2-kirim-photo)

```
$bot->sendPhoto(123456789, './image.jpg', 'Ini contoh foto');
```

### 3. Kirim Document

[](#3-kirim-document)

```
$bot->sendDocument(123456789, './test.pdf', 'Berikut file PDF');
```

### 4. Kirim Video

[](#4-kirim-video)

```
$bot->sendVideo(123456789, './video.mp4', 'Video contoh');
```

### 5. Kirim Audio

[](#5-kirim-audio)

```
$bot->sendAudio(123456789, './audio.mp3');
```

### 6. Kirim Voice Message

[](#6-kirim-voice-message)

```
$bot->sendVoice(123456789, './voice.ogg');
```

### 7. Kirim Media Group (Album)

[](#7-kirim-media-group-album)

```
$bot->sendMediaGroup(123456789, [
    ['type' => 'photo', 'file' => './1.jpg', 'caption' => 'Foto 1'],
    ['type' => 'photo', 'file' => './2.jpg'],
    ['type' => 'document', 'file' => './file.pdf']
]);
```

---

✏ Edit & Delete Message
---------------------------

[](#-edit--delete-message)

### Edit Message

[](#edit-message)

```
$bot->editMessageText(123456789, 45, "Teks diganti!");
```

### Hapus Message

[](#hapus-message)

```
$bot->deleteMessage(123456789, 45);
```

---

🔄 Mendapatkan Update (Long Polling)
-----------------------------------

[](#-mendapatkan-update-long-polling)

```
$updates = $bot->getUpdates();
print_r($updates);
```

Jika ingin polling dari offset tertentu:

```
$bot->getUpdates($start = 50);
```

---

🌐 Webhook
---------

[](#-webhook)

### Set Webhook

[](#set-webhook)

```
$bot->setWebhook("https://example.com/webhook-handler.php");
```

### Delete Webhook

[](#delete-webhook)

```
$bot->deleteWebhook();
```

### Get Webhook Info

[](#get-webhook-info)

```
$info = $bot->getWebhookInfo();
print_r($info);
```

---

📁 Mendapatkan File
------------------

[](#-mendapatkan-file)

### 1. Ambil informasi file

[](#1-ambil-informasi-file)

```
$file = $bot->getFile($file_id);
$file_path = $file['result']['file_path'];
```

### 2. Buat URL download file

[](#2-buat-url-download-file)

```
$url = $bot->buildFileUrl($file_path);
echo $url;
```

---

🧪 Contoh Webhook Handler (PHP)
------------------------------

[](#-contoh-webhook-handler-php)

```
require 'vendor/autoload.php';

use Koyabu\TelegramAPI\Telegram;

$bot = new Telegram([
    'token' => 'YOUR_BOT_TOKEN',
]);

$data = json_decode(file_get_contents('php://input'), true);

$chat_id = $data['message']['chat']['id'];
$text    = $data['message']['text'];

$bot->sendMessage($chat_id, "Anda berkata: $text");
```

---

📂 Struktur Folder Direkomendasikan
----------------------------------

[](#-struktur-folder-direkomendasikan)

```
project/
│── src/
│   └── Telegram.php
│── public/
│   └── webhook.php
│── composer.json
│── README.md

```

---

💬 Dukungan & Kontribusi
---------------------------

[](#-dukungan--kontribusi)

Pull Request dipersilakan. Jika ingin menambah fitur Telegram lainnya, tinggalkan issue.

---

📄 Lisensi
---------

[](#-lisensi)

MIT License — bebas digunakan untuk kebutuhan personal & komersial.

###  Health Score

18

—

LowBetter than 8% of packages

Maintenance48

Moderate activity, may be stable

Popularity4

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity13

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://www.gravatar.com/avatar/09b7ee9510aae1fe1a8aea5c2f2c39683d3c3f20d389420e6f862b322aed8eee?d=identicon)[stievenk](/maintainers/stievenk)

---

Top Contributors

[![stievenk](https://avatars.githubusercontent.com/u/486428?v=4)](https://github.com/stievenk "stievenk (2 commits)")

### Embed Badge

![Health badge](/badges/koyabu-telegramapi/health.svg)

```
[![Health](https://phpackages.com/badges/koyabu-telegramapi/health.svg)](https://phpackages.com/packages/koyabu-telegramapi)
```

###  Alternatives

[stripe/stripe-php

Stripe PHP Library

4.0k143.3M480](/packages/stripe-stripe-php)[twilio/sdk

A PHP wrapper for Twilio's API

1.6k92.9M272](/packages/twilio-sdk)[facebook/php-business-sdk

PHP SDK for Facebook Business

90821.9M34](/packages/facebook-php-business-sdk)[meilisearch/meilisearch-php

PHP wrapper for the Meilisearch API

74513.7M114](/packages/meilisearch-meilisearch-php)[google/gax

Google API Core for PHP

265103.1M454](/packages/google-gax)[google/common-protos

Google API Common Protos for PHP

173103.7M50](/packages/google-common-protos)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)