Mengirim pesan foto di bot Telegram
Pesan foto Telegram adalah format pesan di mana pengguna mengirim gambar dengan atau tanpa tanda tangan. Pesan semacam itu digunakan dalam obrolan pribadi, grup, dan terutama di saluran di mana konten visual membantu menarik perhatian pelanggan. Foto Telegram dapat disertai dengan teks, tagar, tautan, dan emoji, menjadikannya alat yang nyaman untuk pemasaran konten visual dan promosi merek.
Format apa yang diterima Telegram untuk foto dan apa batasannya?
Persyaratan foto saat mengirim
API Bot Telegram menerima gambar sebagai berikut format:
- JPEG / JPG adalah yang utama dan direkomendasikan format untuk mengirim foto melalui bot.
- PNG didukung, tetapi tidak selalu disarankan, terutama untuk ukuran besar.
- WEBP didukung, tetapi lebih umum digunakan untuk stiker.
- GIF adalah tidak didukung dalam metode dan animasi akan dikirim.
Penting: format foto yang dikirim oleh bot sebenarnya terbatas pada apa yang dikenali Telegram sebagai "foto". Artinya dalam praktiknya, bot harus mengirimkan gambar dalam format JPEG format sehingga Telegram menafsirkannya dengan benar sebagai foto (dan bukan sebagai file).
Ini memiliki batas ukuran 20 MB.
Parameter dan pengaturan pesan foto
Persyaratan tautan foto
Tautan langsung ke gambar harus mengarah langsung ke file, bukan ke halaman web.
Contoh: https://example.com/images/photo.jpg ✅
Salah: https://example.com/gallery/photo?id=123 ❌ (ini adalah halaman, bukan file)
Format gambar harus kompatibel (biasanya JPG, JPEG, PNG, WEBP):
URL harus diakhiri dengan .jpg, .jpeg, .png, .webp, dll.
Contoh: https://cdn.domain.com/photo123.jpg ✅
File tersebut harus tersedia untuk umum.:
Tanpa otorisasi, token, atau cookie.
Telegram (server) harus dapat mengunduhnya langsung di URL ini.
Konten URL harus berupa gambar yang valid.:
The Tipe Konten header harus, misalnya: gambar / jpeg, gambar / png.
Cara mendapatkan kode gambar untuk dikirim melalui file_id
Ada dua cara untuk mendapatkan kode gambar dengan cepat.:
Tempel tautan ke gambar, lalu klik tombol "Uji"
Aktifkan mode debugging dalam peristiwa perintah/kesalahan yang tidak diketahui dan kirim foto ke bot. Hasilnya, kode gambar akan tersedia di bagian "Data uji"
Kesalahan populer saat mengirim foto di bot Telegram
400 Permintaan Buruk: pengidentifikasi file / URL HTTP salah ditentukan
Alasannya:
- Format foto salah (misalnya, URL tidak mengarah ke gambar atau file_id tidak valid).
Bagaimana cara memperbaikinya:
- Pastikan itu:
- URL diakhiri dengan .jpg, .png dan mengarah ke gambar, bukan halaman HTML.
- File_id relevan untuk bot ini (jika digunakan).
- Header URL adalah Tipe Konten: gambar / jpeg atau gambar / png.
Contoh yang salah: "https://example.com/page ?id=123"
400 Permintaan Buruk: jenis konten halaman web yang salah
Alasannya:
- Telegram mengharapkan gambar dari URL, tetapi menerima HTML atau jenis konten lain yang tidak didukung.
Bagaimana cara memperbaikinya:
- Pastikan header Tipe Konten pada tautan adalah gambar / jpeg, gambar / png, dll.
400 Permintaan Buruk: foto harus tidak kosong
Alasannya:
- Bidang foto hilang atau file kosong telah ditransfer.
Bagaimana cara memperbaikinya:
- Pastikan bidang foto disetel dengan benar (URL, InputFile, atau file_id) dan gambar benar-benar ada.
413 Entitas Permintaan Terlalu Besar
Alasannya:
- File melebihi batas (20 MB untuk sendPhoto).
Bagaimana cara memperbaikinya:
- Perkecil ukuran gambar atau gunakan sendDocument (hingga 50 MB) jika Anda tidak perlu menampilkannya sebagai foto.
400 Permintaan Buruk: obrolan tidak ditemukan
Alasannya:
- Chat_id salah ditentukan, atau bot tidak memiliki akses ke obrolan.
Bagaimana cara memperbaikinya:
- Pastikan itu:
- Bot telah ditambahkan ke grup / saluran.
- ID yang benar ditentukan (misalnya, @yourchannelname atau angka).
- Bot memiliki hak untuk mengirim pesan.
403 Terlarang: bot diblokir oleh pengguna
Alasannya:
- Pengguna atau saluran telah memblokir bot.
Bagaimana cara memperbaikinya:
- Tidak lain adalah meminta pengguna untuk buka blokir bot.
Informasi teknis untuk BOT-MARKET API
Kode jenis pesan untuk mengirim permintaan (Tipe pesan) adalah "2"
