Paket ini berisi fungsi sendMessage dan fungsi sendPhoto dari bot telegram. Paket ini untuk pengguna laravel 8 keatas
Jalankan perintah berikut ini di terminal untuk menginstall package ini
composer require iqbalfarhan08/telegramtools
Jalankan fungsi publish config seperti berikut ini di terminal kamu
php artisan vendor:publish --provider="Iqbalfarhan08\Telegramtools\TelegramToolServiceProvider"
dari command ini akan ada file baru didalam fonder config kamu dengan nama "telegramtools.php" berisi konfigurasi file yang bisa kamu ubah sesuai dengan kebutuhan.
Tambahkan key ini di file .env untuk konfigurasi bot kamu;
TELEGRAM_BOT_TOKEN="TELEGRAM_BOT_KAMU"
TELEGRAM_DEFAULT_CHAT_ID="CHAT_ID"
TELEGRAM_WEBHOOK_URL="WEBHOOK URL"
Telegramtools ini adalah sebuah trait gunakan use TelegramTrait didalam class yang kamu buat
use Iqbalfarhan08\Telegramtools\Trait\TelegramTrait;
class YourController extends Controller
{
use TelegramTrait
...
}
Atur chat id sebelum mengirim pesan text atau pesan gambar. chat id bisa untuk perorangan atau group. chat id berupa angka dan bisa kamu dapatkan dari banyak bot ditelegram kemudian set chat id kamu dengan cara:
$this->setChatId("CHATID");
Untuk mengirimkan pesan text kamu bisa menggunakan method sebagai berikut
$text = "hallo gais apkabs?";
$this->setChatId($chat_id);
return $this->sendMessage($text);
Parameter pertama sendMessage bersifat required (harus diisi) dan string.
Untuk mengirimkan pesan berupa gambar kamu bisa menggunakan method sebagai berikut
$photo = "https://cdn-icons-png.flaticon.com/512/282/282100.png";
$caption = "gambar link";
$this->setChatId($chat_id);
return $this->sendPhoto($photo, $caption);
Method sendPhoto memiliki 2 parameter yaitu:
- $photo : bersifat required (harus diisi) dan string.
- $caption : optional (tidak harus diisi) dan string.
Untuk mengatur webhook kamu bisa membuat route tersendiri baik di web.php atau di api.php.
// file api.php
Route::get('telegram/setWebhook', [API\TelegramController::class, 'setWebhook']);
// file API\TelegramController.php
use TelegramTrait;
// dengan url
public function setWebhook(){
$url = "https://https://domain.com/api/telegram/";
$this->setWebHook($url);
}
// atau tanpa url
public function setWebhook(){
$this->setWebHook();
}
Kemudian akses route tersebut di https://domain.com/api/telegram/setWebhook.
Apabila tidak memasukkan $url wehbook akan diisi sesuai dengan value TELEGRAM_WEBHOOK_URL di file .env
Buatlah sebuah controller untuk action telegram kamu. sebagai contoh buat file API\TelegramController dengan menjalankan
php artisan make:controller API/TelegramController
kemudian buat fungsi index untuk sebagai tujuan post jangan lupa untuk membuat route webhook telegram kamu.
// file api.php
// webhook https://domain.com/api/telegram
Route::post('telegram', [API\TelegramController::class, 'index']);
// file API TelegramController.php
namespace App\Http\Controllers\API;
use App\Http\Controllers\Controller;
use App\Traits\TelegramTrait;
use Illuminate\Http\Request;
class TelegramController extends Controller
{
use TelegramTrait;
public function index()
{
$req = json_decode(file_get_contents("php://input"), TRUE);
$chat_id = $req['message']['chat']['id'];
$this->setChatId($chat_id);
return $this->sendMessage("silakan ini dia Telegram ID kamu <b>{$chat_id}</b>");
}
public function resetWebhook()
{
return $this->setWebhook();
}
}
ini masih versi awal dan kemungkinan akan ada optimalisasi di paket ini.