Telegram adalah salah satu aplikasi pesan instan yang populer di dunia. Selain sebagai platform komunikasi, Telegram juga menyediakan API yang kuat yang memungkinkan pengembang untuk berinteraksi dengan aplikasi mereka menggunakan bot Telegram. Integrasi antara CodeIgniter 3 dan Telegram memungkinkan pengembang untuk membangun aplikasi web yang dapat mengirim dan menerima pesan melalui Telegram bot, membuat notifikasi otomatis, atau bahkan membuat sistem yang lebih kompleks, seperti layanan pelanggan berbasis Telegram.

CodeIgniter 3 adalah framework PHP yang ringan dan mudah digunakan untuk membangun aplikasi web. Dalam artikel ini, kita akan membahas langkah demi langkah cara mengintegrasikan CodeIgniter 3 dengan Telegram menggunakan bot Telegram. Panduan ini akan meliputi bagaimana menyiapkan bot Telegram, mengonfigurasi CodeIgniter, dan membuat aplikasi yang dapat mengirim pesan melalui Telegram.

1. Persiapan Awal: Membuat Bot Telegram

Sebelum kita mulai mengintegrasikan Telegram dengan CodeIgniter, langkah pertama adalah membuat bot Telegram yang akan kita gunakan untuk berinteraksi dengan aplikasi.

a. Membuat Bot di Telegram

Untuk membuat bot Telegram, Anda perlu berbicara dengan BotFather, yang merupakan bot resmi untuk membuat dan mengelola bot lain di Telegram. Berikut adalah langkah-langkah untuk membuat bot:

1. Buka Telegram dan cari BotFather di kolom pencarian.
2. Klik Start untuk memulai percakapan dengan BotFather.
3. Kirim perintah /newbot untuk membuat bot baru.
4. BotFather akan meminta Anda untuk memberikan nama bot (misalnya: "MyAwesomeBot").
5. Setelah itu, Anda akan diminta untuk memilih username bot yang harus diakhiri dengan kata "bot" (misalnya: "myawesome_bot").
6. Setelah selesai, BotFather akan memberikan token API yang akan digunakan untuk berkomunikasi dengan bot Telegram melalui API. Salin token tersebut, karena Anda akan membutuhkannya nanti.

b. Menyiapkan Webhook di Telegram

Telegram memungkinkan Anda untuk menghubungkan bot Anda dengan server menggunakan webhook. Webhook adalah cara Telegram untuk memberi tahu server Anda tentang pembaruan terbaru, seperti pesan yang diterima oleh bot.

Untuk menyiapkan webhook, Anda akan mengirimkan permintaan HTTP POST ke API Telegram dengan URL webhook yang sudah Anda tentukan.

https://api.telegram.org/bot/setWebhook?url=

Gantilah dengan token API yang Anda dapatkan dari BotFather dan dengan URL endpoint di server Anda yang akan menangani pesan masuk.

2. Menyiapkan CodeIgniter 3

Setelah Anda memiliki bot Telegram, langkah berikutnya adalah mengintegrasikan bot tersebut dengan aplikasi CodeIgniter 3. Dalam tutorial ini, kita akan membuat aplikasi sederhana yang dapat mengirim pesan ke Telegram dan menerima pesan dari Telegram.

a. Instalasi CodeIgniter 3

Jika Anda belum menginstal CodeIgniter 3, Anda bisa mengunduhnya dari situs resmi CodeIgniter di codeigniter.com. Setelah mengunduh, ekstrak file tersebut ke dalam direktori root server Anda dan pastikan server web seperti Apache atau Nginx sudah terpasang dan berjalan.

b. Membuat Controller dan Model untuk Telegram

1. Buat Controller untuk Telegram Buatlah controller baru di direktori application/controllers. Misalnya, kita akan membuat controller bernama Telegram.php. Controller ini akan menangani semua interaksi dengan bot Telegram.

<?php
defined('BASEPATH') OR exit('No direct script access allowed');

class Telegram extends CI_Controller {

    private $botToken = 'YOUR_BOT_TOKEN'; // Ganti dengan token bot Anda
    private $apiUrl = 'https://api.telegram.org/bot'; // URL API Telegram

    public function __construct()
    {
        parent::__construct();
        // Load helper atau library yang diperlukan
        $this->load->helper('url');
    }

    // Fungsi untuk mengirim pesan
    public function send_message($chatId, $message)
    {
        $url = $this->apiUrl . $this->botToken . "/sendMessage?chat_id=$chatId&text=" . urlencode($message);
        file_get_contents($url); // Kirim permintaan HTTP untuk mengirim pesan
    }

    // Fungsi untuk menangani webhook
    public function webhook()
    {
        $update = json_decode(file_get_contents("php://input"), TRUE); // Ambil data JSON dari Telegram

        // Cek apakah ada pesan baru
        if (isset($update["message"])) {
            $chatId = $update["message"]["chat"]["id"]; // ID chat
            $message = $update["message"]["text"]; // Teks pesan yang diterima

            // Kirim balasan pesan
            $this->send_message($chatId, "Terima kasih telah mengirim pesan: $message");
        }
    }
}

Pada controller di atas, kita memiliki dua fungsi utama:

• send_message($chatId, $message): Fungsi ini mengirimkan pesan ke chat tertentu di Telegram dengan menggunakan API Telegram.
• webhook(): Fungsi ini akan dipanggil ketika Telegram mengirimkan pembaruan (update) ke server kita melalui webhook.

c. Membuat Model untuk Telegram (Opsional)

Jika Anda ingin mengelola data atau interaksi dengan Telegram secara lebih terstruktur, Anda dapat membuat model yang akan menangani komunikasi dengan API Telegram. Misalnya, Anda dapat membuat model Telegram_model.php di direktori application/models.

<?php
class Telegram_model extends CI_Model {

    private $botToken = 'YOUR_BOT_TOKEN'; // Ganti dengan token bot Anda
    private $apiUrl = 'https://api.telegram.org/bot';

    public function send_message($chatId, $message)
    {
        $url = $this->apiUrl . $this->botToken . "/sendMessage?chat_id=$chatId&text=" . urlencode($message);
        return file_get_contents($url); // Kirim permintaan HTTP untuk mengirim pesan
    }
}

d. Menyiapkan Webhook di CodeIgniter

Setelah Anda memiliki controller yang menangani webhook, langkah berikutnya adalah mengonfigurasi webhook untuk bot Telegram Anda. Misalnya, jika server Anda memiliki URL https://yourdomain.com/telegram/webhook, Anda dapat mengonfigurasi webhook di Telegram untuk mengarah ke URL tersebut.

Setelah bot Anda siap dan webhook telah dikonfigurasi, Telegram akan mulai mengirimkan pembaruan setiap kali ada pesan baru. Anda bisa memanfaatkan data ini untuk membangun aplikasi seperti notifikasi, layanan pelanggan otomatis, atau bahkan interaksi berbasis perintah.

3. Mengirim Pesan ke Telegram

Untuk mengirim pesan ke Telegram dari aplikasi CodeIgniter, Anda dapat memanggil fungsi send_message di controller Anda dengan menyediakan chatId (ID pengguna atau grup) dan pesan yang ingin dikirim.

$this->telegram->send_message('USER_CHAT_ID', 'Pesan yang ingin dikirim');

4. Mengelola Pesan yang Masuk

Jika Anda ingin menangani pesan masuk secara otomatis, Anda bisa menggunakan webhook untuk menerima pembaruan dari Telegram. Setiap kali pengguna mengirimkan pesan ke bot, fungsi webhook() di controller akan dipanggil. Anda bisa mengolah pesan ini lebih lanjut, misalnya dengan menambahkan logika pemrosesan atau perintah tertentu.

public function webhook()
{
    $update = json_decode(file_get_contents("php://input"), TRUE);

    if (isset($update["message"])) {
        $chatId = $update["message"]["chat"]["id"];
        $message = $update["message"]["text"];

        if ($message == "/start") {
            $this->send_message($chatId, "Selamat datang di bot kami! Ketik perintah lain untuk interaksi.");
        } else {
            $this->send_message($chatId, "Anda mengirim pesan: $message");
        }
    }
}

5. Uji Coba dan Pengujian

Setelah menyelesaikan pengaturan, uji coba integrasi dengan mengirim pesan ke bot Telegram dan pastikan bahwa aplikasi CodeIgniter Anda dapat mengirimkan balasan dengan benar. Anda juga bisa memanfaatkan fitur debug untuk melacak kesalahan dan memperbaiki jika ada masalah.

6. Kesimpulan

Integrasi CodeIgniter 3 dengan Telegram membuka banyak peluang untuk menciptakan aplikasi web yang lebih interaktif dan otomatis. Dengan menggunakan bot Telegram, Anda bisa mengirim pesan, menerima pembaruan, dan membangun sistem interaksi berbasis pesan yang dapat meningkatkan pengalaman pengguna. Proses integrasi ini relatif sederhana dan hanya membutuhkan pemahaman dasar tentang API Telegram dan kemampuan untuk bekerja dengan CodeIgniter. Dengan mengikuti langkah-langkah di atas, Anda dapat mulai membuat aplikasi yang menggabungkan kekuatan CodeIgniter dengan Telegram untuk membangun aplikasi berbasis pesan yang berguna.