Bikin bot AI WhatsApp dan Telegram dengan satu API key

Kit bot Ezkielyna adalah kode Python kecil yang bisa kamu jalankan di laptop atau VPS sendiri. Bot-nya bisa ngobrol dan mengingat 10 pesan terakhir per pengguna, membaca foto, memahami voice note lalu membalas dengan teks dan suara, serta membuat gambar. Semua lewat satu API key Ezkielyna, tanpa akun OpenAI atau layanan suara terpisah.

Saldo bisa diisi dengan QRIS mulai Rp8.000 (Starter Pack $0.5).

Diperbarui dari data live · Sumber: daftar model · tabel harga · halaman status

Unduh kit bot (zip, ±10 KB)

Versi 1.0. Isinya ezk.py, telegram_bot.py, whatsapp_bot.py, .env.example, requirements.txt dan README berbahasa Indonesia.

SHA-256: 23559deb0541b83a850766dc54d806c43c82ce0bb3819c38317b249312d28b3e

Yang kamu butuhkan

  • Python 3.10 atau lebih baru
  • API key Ezkielyna grup Auto (fitur gambar butuh grup ini) dan saldo
  • Untuk Telegram: token bot dari @BotFather
  • Untuk WhatsApp: app di developers.facebook.com dengan produk WhatsApp, dan server HTTPS (VPS + domain, atau tunnel untuk uji coba)

Langkah-langkah

  1. 1Beli saldo API dengan QRIS

    Buka ezkielyna.store/api-credit, pilih nominal (paket terkecil $0.5), lalu bayar dengan QRIS dari aplikasi bank atau e-wallet. USDT (BEP-20, Solana) dan Binance Pay juga bisa. Kode redeem muncul di halaman order setelah pembayaran terkonfirmasi. Saldo tidak kedaluwarsa dan tidak ada biaya bulanan.

  2. 2Buat API key grup Auto

    Masuk ke api.ezkielyna.store, buka Wallet dan tempel kode redeem. Lalu buka API Keys, buat key baru dan pilih grup Auto. Key Standard cukup untuk chat, tapi fitur membuat gambar butuh Auto. Supaya saldo aman, beri key ini batas kuota sendiri.

  3. 3Unduh dan pasang kit

    Ekstrak zip, masuk ke foldernya, buat virtualenv, pasang dependensi, lalu salin .env.example menjadi .env dan isi EZK_API_KEY.

    terminal
    curl -fsSLO https://ezkielyna.store/agent/download/ezk-bot-kit-1.0.zip
    unzip ezk-bot-kit-1.0.zip && cd ezk-bot-kit
    python3 -m venv .venv && source .venv/bin/activate   # Windows: .venv\Scripts\activate
    pip install -r requirements.txt
    cp .env.example .env                                  # lalu isi .env
  4. 4Bot Telegram (paling mudah)

    Chat @BotFather, kirim /newbot, lalu salin token ke TELEGRAM_BOT_TOKEN di .env. Jalankan bot-nya dan kirim /start ke bot kamu. Tidak perlu server publik; bot jalan selama komputer atau VPS menyala. Isi ALLOWED_USER_IDS dengan id Telegram kamu kalau bot hanya untuk dipakai sendiri.

    terminal
    python telegram_bot.py
  5. 5Bot WhatsApp (WhatsApp Cloud API resmi)

    Buat app di developers.facebook.com dan tambahkan produk WhatsApp. Isi WA_TOKEN (access token), WA_PHONE_NUMBER_ID, WA_APP_SECRET (Settings, Basic) dan WA_VERIFY_TOKEN (kata rahasia buatanmu) di .env. Jalankan whatsapp_bot.py di server yang bisa diakses lewat HTTPS, lalu di dashboard Meta buka WhatsApp, Configuration, Webhook: isi Callback URL https://domain-kamu/webhook, verify token yang sama, dan subscribe field messages.

    terminal
    python whatsapp_bot.py
  6. 6Coba fiturnya

    Kirim pesan biasa untuk ngobrol, kirim foto dengan pertanyaan di caption, kirim voice note, atau minta gambar: /gambar kucing astronot di Telegram, gambar: kucing astronot di WhatsApp.

Belum punya saldo? Lihat paket API Credit.

Kenapa WhatsApp Cloud API resmi?

Kit ini memakai API resmi dari Meta. Library WhatsApp tidak resmi berisiko membuat nomor diblokir. Aturan Meta: balasan bebas hanya boleh dalam 24 jam setelah pengguna terakhir mengirim pesan. Bot ini hanya membalas pesan yang masuk, jadi sesuai aturan itu.

Ganti model dan gaya bot

Semua diatur di .env tanpa mengubah kode. Daftar model dan harga terbaru ada di /models.

Setelan di .env
SetelanBawaanKeterangan
EZK_CHAT_MODELdeepseek-v4.1-flashChat dan membaca foto
EZK_STT_MODELstt-xai-v1Voice note ke teks; alternatif whisper-large-v3
EZK_TTS_MODELedge-ttsBalasan suara bahasa Indonesia
EZK_TTS_VOICEid-ID-GadisNeuralSuara pria: id-ID-ArdiNeural
EZK_IMAGE_MODELgpt-image-2.5Butuh key Auto; satu gambar bisa 30–60 detik
EZK_SYSTEM_PROMPTasisten ramahUbah jadi CS toko, guru les, dan lain-lain
VOICE_REPLY10 = voice note dibalas teks saja

Perkiraan biaya per aksi

Biaya dipotong dari saldo API sesuai pemakaian. Angka di bawah hasil uji 10 Nov 2026 dengan model bawaan (kurs saldo $1 = Rp15.000); harga model bisa berubah, jadi cek /models untuk angka terbaru. Setiap request juga tercatat di menu Log api.ezkielyna.store.

Perkiraan, model bawaan, uji 10 Nov 2026
AksiPerkiraan biaya
Chat 1 pesan pendekdi bawah Rp1
Membaca 1 fotosekitar Rp1 (foto besar bisa sedikit lebih)
Voice note 30 detik ke tekssekitar Rp30
Balasan suara (edge-tts)sekitar Rp3–10
1 gambarsekitar Rp125

Keamanan

Jangan bagikan file .env atau API key ke siapa pun, dan jangan unggah ke GitHub.

Kalau key bocor, hapus di api.ezkielyna.store, API Keys, lalu buat key baru.

Bot yang terbuka untuk umum bisa menghabiskan saldo. Batasi dengan ALLOWED_USER_IDS (Telegram) atau beri key ini batas kuota di halaman API Keys.

Kalau ada masalah

  • 401 atau 403 dari Ezkielyna: EZK_API_KEY salah, terpotong, atau saldo habis. Salin ulang key dan cek saldo di Wallet.
  • Perintah /gambar gagal, tapi chat jalan: key-nya bukan grup Auto. Buat key Auto dan ganti EZK_API_KEY.
  • Webhook WhatsApp tidak terverifikasi: verify token di dashboard Meta harus sama persis dengan WA_VERIFY_TOKEN, dan Callback URL harus HTTPS yang bisa diakses dari internet.
  • Bot WhatsApp tidak membalas: pastikan field messages sudah di-subscribe dan WA_APP_SECRET benar. Pesan dengan tanda tangan yang tidak cocok ditolak.
  • Bot Telegram diam: cek TELEGRAM_BOT_TOKEN, dan kalau ALLOWED_USER_IDS diisi, pastikan id Telegram-mu ada di daftar itu.

Pertanyaan yang sering muncul

Apakah kit ini gratis?

Kodenya gratis. Yang dibayar hanya pemakaian model dari saldo API Ezkielyna, per pesan, per foto, per detik suara atau per gambar sesuai harga model.

Apakah nomor WhatsApp saya aman dari blokir?

Kit ini memakai WhatsApp Cloud API resmi dari Meta, bukan library tidak resmi. Kamu tetap harus mengikuti kebijakan WhatsApp Business, misalnya tidak mengirim pesan massal yang tidak diminta.

Di mana data percakapan disimpan?

Ingatan 10 pesan terakhir disimpan di memori bot, di komputer atau server tempat kamu menjalankannya, dan hilang saat bot dimatikan. Isi pesan dikirim ke gateway Ezkielyna untuk diproses model.

Bisa dipakai untuk CS toko online?

Bisa. Ubah EZK_SYSTEM_PROMPT dengan informasi tokomu dan gaya bahasa yang kamu mau. Cek jawabannya dulu sebelum dipakai untuk pelanggan sungguhan.

Bayarnya pakai apa, dan minimal berapa?

API Credit dibayar dengan QRIS, USDT (BEP-20, Solana) atau Binance Pay. Paket terkecil bernilai $0.5; harga Rupiah setiap paket ada di ezkielyna.store/api-credit. Saldo terpotong per token sesuai model yang dipakai dan tidak kedaluwarsa.

Panduan terkait: daftar model dan harga · MCP gambar untuk agent coding · jaminan Gagal = Gratis · paket API Credit

Ezkielyna adalah gateway API independen dan tidak berafiliasi dengan Anthropic, OpenAI atau pembuat alat yang disebut di halaman ini.

In English

Free Python bot kit for Telegram and the official WhatsApp Cloud API on Ezkielyna API: chat with 10-message memory, photo understanding, voice notes transcribed and answered with voice, and image generation (/gambar). Download https://ezkielyna.store/agent/download/ezk-bot-kit-1.0.zip (SHA-256 23559deb0541b83a850766dc54d806c43c82ce0bb3819c38317b249312d28b3e), set EZK_API_KEY to an Auto-group key in .env, then run python telegram_bot.py or python whatsapp_bot.py behind HTTPS. Each action is billed from your API balance (a short chat message costs under IDR 1 with the default model; an image about IDR 125, measured 10 Nov 2026).