Telegram ke Todoist: Ubah Curahan Ide Menjadi Tugas yang Ditinjau

Piotr Grudzień
Diterbitkan Waktu baca 10 menit
Action tugas di Quickchat AI berdampingan dengan proyek Todoist berisi tiga tugas contoh

Bot Telegram Todoist dapat mengubah pesan berisi berbagai niat menjadi daftar tugas yang sudah Anda tinjau. Anda akan membuat Pocket Inbox, bot pribadi yang memisahkan tugas, menanyakan tanggal yang belum jelas, dan menyimpan seluruh daftar ke satu proyek Todoist setelah Anda menyetujuinya.

Mulailah dengan pesan yang mungkin Anda kirim saat pulang kantor:

Beli kertas printer Jumat, kirim email ke pengelola tempat mungkin Senin, dan baca panduan jalur pendakian kalau ada waktu.

Proyek Capture demo di Todoist dengan Buy printer paper pada Jumat, Email the venue pada Senin, dan Read the trail guide tanpa tanggal Daftar yang akan Anda buat: tiga tugas, dua tanggal, dan satu tugas yang sengaja tanpa tanggal. Tangkapan layar Todoist asli ini menggunakan tugas demo yang disiapkan secara manual; tangkapan layar Quickchat AI menunjukkan konfigurasi lokal. Langkah 6 memeriksa hasil bot Anda saat digunakan langsung.

Bagian yang menarik adalah “mungkin Senin.” Ini perlu dipastikan sebelum membuat tenggat. “Kalau ada waktu” seharusnya tetap tanpa tanggal. Peninjauan kecil itulah yang membuat percakapan berguna: Anda bisa mencatat pikiran dahulu, lalu menentukan detail tanpa menulis ulang seluruh pesan.

Ikuti enam langkah untuk menyiapkan akun, membatasi akses, menghubungkan Todoist, mengajarkan peninjauan, menyetujui tiga tugas, dan memverifikasi hasil. Kit awal Pocket Inbox berisi keempat resep Action, prompt, dan daftar periksa pengujian. Isinya berupa file yang bisa disalin, bukan impor Agent otomatis.

1. Apa yang diperlukan untuk menghubungkan Telegram ke Todoist?

Anda memerlukan bot Telegram yang Anda kendalikan, akun Todoist, dan Agent Quickchat AI dengan kapasitas untuk empat HTTP Action. Batasi versi pertama pada satu orang, satu proyek, dan pesan teks.

  1. Masuk ke Todoist dan buat proyek bernama Capture demo. Jika memungkinkan, gunakan akun khusus pengujian. Token API pribadi memiliki izin akun tersebut; ID proyek tetap dalam resep tidak mempersempit izin token itu sendiri.

Dialog Add project di Todoist dengan nama Capture demo yang sudah dimasukkan, diikuti proyek Capture demo yang masih kosong Beri nama proyek terlebih dahulu, lalu buka daftar tugasnya yang masih kosong. Inilah tujuan yang akan Anda pilih pada setiap Action pembuatan tugas.

  1. Buat akun Quickchat AI, lalu pilih Add new AI Agent → Set up manually. Beri nama Pocket Inbox. Periksa paket dan batas Action saat ini; balasan AI dan Simulation Testing menggunakan kredit.
  2. Buat bot dengan BotFather. Panduan pembuatan bot Telegram menjelaskan nama pengguna dan token. Masukkan token langsung di External Apps → Telegram → Your own bot → Connect to Telegram, lalu aktifkan integrasi dan simpan.
  3. Di Your Website → Install → Availability and access, matikan Widget & Embed access dan atur Chat Page Access ke Nobody. Gunakan percakapan Telegram pribadi Anda untuk alur ini.
  4. Buka bot di Telegram, tekan Start, lalu kirim sapaan singkat. Biarkan Action Todoist tidak aktif sampai aturan akses di bawah selesai diatur.

Pengaturan Telegram Quickchat AI dengan opsi koneksi Your own bot Berikan Pocket Inbox identitas Telegram sendiri. Layar konfigurasi lokal ini tidak memuat token bot aktif.

Kini Anda memiliki tempat untuk mencatat pikiran. Sebelum menghubungkan tugas, tentukan pengirim Telegram mana yang boleh mengaksesnya.

2. Bagaimana menjaga bot Todoist tetap pribadi?

Batasi setiap pembacaan dan penulisan berdasarkan ID pengguna Telegram Anda dan percakapan pribadi. Quickchat AI mengevaluasi kondisi ini sebelum mengirim permintaan HTTP.

  1. Di Inbox, buka percakapan Telegram asli dari sapaan tadi. Pilih Details → Visitor. Salin angka di sebelah Telegram User Id dan pastikan Telegram Chat Type bernilai private.
  2. Pada setiap Action yang dibuat di langkah berikutnya, atur When to run ke AI decides.
  3. Di Run only when, tambahkan kedua kondisi berikut. Gunakan ID dari percakapan tersebut, bukan nama pengguna atau ID yang diketik dalam pesan.
Kunci metadataPerbandinganNilai
telegram_user_idequalsID numerik pengguna Telegram Anda yang sudah diverifikasi
telegram_chat_typeequalsprivate

Editor Action menampilkan ID pengguna Telegram dan percakapan pribadi sebagai dua kondisi wajib Kedua kondisi harus terpenuhi. ID numerik dalam data uji lokal ini hanya contoh; ganti dengan nilai Anda sendiri yang telah diverifikasi.

Diagram pengirim Telegram melewati pemeriksaan pemilik dan percakapan pribadi sebelum permintaan Todoist Telegram menyediakan identitas. Percakapan menyediakan usulan tugas. Keduanya adalah masukan yang berbeda.

Dokumentasi Run only when menjelaskan kondisi tersebut. Percakapan pribadi saja tidak cukup karena orang lain juga bisa membuka percakapan pribadi dengan bot Anda. Prompt yang menyebut khusus pemilik juga tidak cukup. Terapkan kedua pemeriksaan pada Action pembacaan dengan ketelitian yang sama seperti Action pembuatan.

Pratinjau web biasa tidak memiliki metadata Telegram yang terverifikasi, sehingga Action ini seharusnya menolak berjalan di sana. Pertahankan kondisinya dan gunakan saluran asli untuk pengujian akhir.

3. Bagaimana menghubungkan bot ke API Todoist?

Buat empat HTTP Action: menampilkan tugas aktif proyek, membuat tugas bertanggal, membuat tugas tanpa tanggal, dan membaca kembali tugas yang tersimpan. Pemisahan Action pembuatan menjadikan tanpa tanggal sebagai pilihan yang eksplisit.

Permintaan menggunakan kolom yang sama seperti saat Anda menambahkan tugas di Todoist: judul, proyek tujuan, dan tanggal opsional.

Formulir tugas Todoist dengan Buy printer paper, pemilih proyek Capture demo, dan kontrol Date, beserta tampilan kolom-kolom tersebut yang diperbesar Lihat kolom tugas lebih dekat. Resep API di bawah mengirim judul sebagai content, proyek sebagai project_id, dan tanggal yang disetujui sebagai due_date. Resep tanpa tanggal tidak menyertakan tanggal.

Siapkan token dan ID proyek

  1. Di aplikasi web Todoist, buka avatar → Settings → Integrations → Developer → Copy API token, seperti dijelaskan dalam petunjuk token resmi.
  2. Di Quickchat AI, pilih Actions & MCPs → Add Action → API Action → Create manually. Untuk setiap resep, masukkan token langsung di Headers → Authorization sebagai Bearer YOUR_TODOIST_TOKEN. Anggap header tetap dapat diakses orang yang bisa mengedit Agent. Jangan masukkan token ke prompt, obrolan, atau tangkapan layar.
  3. Untuk mencari ID proyek, buat Action pengaturan sementara yang tidak aktif dengan GET https://api.todoist.com/api/v1/projects, header Authorization, dan Accept: application/json. Gunakan Test di editor, periksa results, lalu salin id di sebelah Capture demo. Jika perlu, berikan next_cursor yang dikembalikan sebagai nilai kueri cursor pada permintaan berikutnya. Hapus Action pengaturan setelah selesai.
  4. Tempel ID dari server itu di setiap tempat yang bertuliskan YOUR_PROJECT_ID. Pertahankan sebagai nilai tetap, bukan parameter yang diisi AI. ID tmp- belum tersinkron dan tidak dapat digunakan di sini.

Referensi API Todoist terkini mendokumentasikan endpoint ini. Gunakan /api/v1, termasuk respons daftar berhalaman, alih-alih menyalin resep REST-v2 lama.

Konfigurasikan keempat Action

Petunjuk API Action builder menjelaskan editor. Tambahkan setiap masukan di What to ask the user first. Gunakan Add AI Data untuk memasukkan chip parameter ke URL, baris kueri, atau body; notasi {{...}} di bawah menyebut nama chip tersebut.

Untuk keempat Action, tambahkan Accept: application/json, pertahankan kedua kondisi pemilik, dan biarkan Response Filter kosong agar ID tugas dan informasi halaman yang dikembalikan tetap terlihat. Pada kedua Action POST, tambahkan juga Content-Type: application/json.

Action tugas bertanggal menampilkan chip content, ID proyek tetap, dan chip due_date dalam body JSON Judul dan tanggal berasal dari draf yang disetujui. Proyek tujuan tetap ditentukan dalam Action.

Salin Action 1 dari 4: Read capture tasks

API Action Name: Read capture tasks

What to ask the user first:

Format dataNamaDeskripsiWajib
TextcursorKosongkan pada halaman pertama. Untuk halaman berikutnya, salin next_cursor dari hasil sebelumnya.Tidak

API Endpoint, Query Params and Headers:

GET https://api.todoist.com/api/v1/tasks

Query Params
project_id: YOUR_PROJECT_ID
limit: 50
cursor: {{cursor}}

Headers
Authorization: Bearer YOUR_TODOIST_TOKEN
Accept: application/json

Biarkan nilai default masukan opsional cursor kosong dan isi seluruh nilai baris kueri hanya dengan chip-nya. Jangan menambahkannya ke URL endpoint.

Body: kosong.

API Action Description:

Read active tasks in the fixed Capture demo project before saving a batch and when the user asks what is currently there. Start without a cursor. Follow next_cursor until it is empty; after five pages, explain that the list is incomplete and do not create a batch based on an incomplete duplicate check. Preserve returned IDs and dates. Similar titles are candidates to review, not proof of duplicates.
Salin Action 2 dari 4: Create dated capture task

API Action Name: Create dated capture task

What to ask the user first:

Format dataNamaDeskripsiWajib
TextcontentJudul tugas persis dari daftar akhir yang disetujui pengguna.Ya
Textdue_dateTanggal yang disetujui secara tepat dalam format YYYY-MM-DD, tanpa waktu.Ya

API Endpoint and Headers:

POST https://api.todoist.com/api/v1/tasks

Headers
Authorization: Bearer YOUR_TODOIST_TOKEN
Accept: application/json
Content-Type: application/json

Tab Body, mode JSON:

{
  "content": "{{content}}",
  "project_id": "YOUR_PROJECT_ID",
  "due_date": "{{due_date}}"
}

API Action Description:

Create one task only after the user explicitly approves the final title, exact date and Capture demo destination. Use only for a dated task. Retain the returned ID and immediately read the task back. Never repeat an uncertain request without inspecting the existing results first.
Salin Action 3 dari 4: Create undated capture task

API Action Name: Create undated capture task

What to ask the user first:

Format dataNamaDeskripsiWajib
TextcontentJudul tugas persis yang disetujui tanpa tanggal.Ya

API Endpoint and Headers:

POST https://api.todoist.com/api/v1/tasks

Headers
Authorization: Bearer YOUR_TODOIST_TOKEN
Accept: application/json
Content-Type: application/json

Tab Body, mode JSON:

{
  "content": "{{content}}",
  "project_id": "YOUR_PROJECT_ID"
}

API Action Description:

Create one task only after the user explicitly approves its title, no date and the Capture demo destination. This Action deliberately has no due fields. Retain the returned ID and immediately read the task back. Never repeat an uncertain request without inspecting the existing results first.
Salin Action 4 dari 4: Read a saved capture task

API Action Name: Read a saved capture task

What to ask the user first:

Format dataNamaDeskripsiWajib
Texttask_idID tugas server yang dikembalikan oleh pembuatan atau daftar proyek terkait. Jangan menebaknya.Ya

API Endpoint and Headers:

GET https://api.todoist.com/api/v1/tasks/{{task_id}}

Headers
Authorization: Bearer YOUR_TODOIST_TOKEN
Accept: application/json

Body: kosong.

API Action Description:

Read a task using the ID returned by a successful creation or Read capture tasks. Check its content, project_id and due against the approved task before reporting success. Do not use IDs invented by the model or supplied in a user's message.

Endpoint satu tugas sendiri tidak dibatasi ke proyek tertentu. Aturan masukannya menjaga alur pribadi ini tetap memakai ID tugas yang dikembalikan, sementara kondisi pengirim tepercaya menyediakan kontrol akses. Gunakan akun Todoist khusus jika kredensialnya sendiri perlu dipisahkan dari proyek lain.

Empat Action Pocket Inbox di Quickchat AI, memisahkan pembacaan dan pembuatan dengan atau tanpa tanggal Seluruh alat yang dibutuhkan. Biarkan Action tidak aktif saat mengisi placeholder dan memeriksa kondisinya.

4. Instruksi apa yang harus diikuti bot tugas?

Minta Pocket Inbox membuat draf terlebih dahulu, menyelesaikan ketidakpastian, lalu meminta persetujuan Anda atas kolom akhir. Masukkan berikut ini ke Identity → Main Prompt → Edit.

Main Prompt Pocket Inbox pada pengaturan Identity Quickchat AI Prompt mengajarkan percakapan peninjauan. Kondisi Action menentukan siapa yang dapat mengakses Todoist.

Salin Main Prompt Pocket Inbox lengkap
You are Pocket Inbox, a personal text-to-task assistant for one owner's Capture demo project in Todoist.

Split a brain dump into proposed tasks without adding intentions. Show each title, exact date or "no date", and the Capture demo destination. Ask about unclear dates such as "maybe Monday". Ask for the user's timezone and exact calendar dates when relative dates are unresolved. Do not invent a date for "when I have time".

Present the final batch and ask for explicit approval before any create Action. If the user changes an item, show the revised batch and ask again. Approval is a conversation rule; do not claim that it provides access control.

After approval, call Read capture tasks. Follow next_cursor for up to five pages. If the list is still incomplete, explain the limit and stop before creating. If similar tasks exist, ask whether the user intends new copies before proceeding.

Create tasks one at a time. Use Create dated capture task only for an approved YYYY-MM-DD date; otherwise use Create undated capture task. After each success, retain its returned ID and call Read a saved capture task. Compare content, project_id and due with the approved item. Report a task as verified only when the read matches.

Stop on a failed or uncertain write. Report which items were verified and which remain unresolved. Read the project before any retry; a timeout may have saved a task. A repeated approval does not authorize a second copy of the same batch. Check existing outcomes and ask before making new copies.

When asked what is currently in Todoist, read the project rather than relying on conversation memory. Distinguish current active tasks from the exact tasks created in this conversation. Never invent task IDs or links. If an Action is refused by its run conditions, explain that it needs the configured owner's private Telegram chat. Do not suggest removing the conditions.

This setup handles text, date-only tasks and undated tasks. Do not claim voice transcription, scheduled reminders, recurring tasks or access to other people's accounts.

Anda juga dapat menyiapkan pengaturan yang didukung melalui koneksi pengelolaan akun Quickchat AI di ChatGPT atau Claude. Berikan kit dan permintaan berikut kepada asisten yang terhubung:

Prepare Pocket Inbox using the four HTTP Action recipes and Main Prompt in this kit. Keep the Actions inactive. Preserve the fixed project ID and both Telegram run conditions on every Action. Ask me for non-secret IDs when needed, and leave token entry to me in the dashboard. Show me the saved configuration before any test that creates Todoist tasks or spends credits.

Koneksi itu mengelola pengaturan Quickchat AI. Anda tetap membuat bot Telegram, memasukkan kredensial secara langsung, dan menguji koneksi Telegram/Todoist yang sebenarnya.

5. Bagaimana curahan ide menjadi tiga tugas yang disetujui?

Gunakan pesan awal untuk menguji percakapan sebelum mengizinkan penyimpanan. Setelah kredensial, proyek, dan kondisi pada keempat Action benar, aktifkan semuanya lalu kirim pesan di percakapan Telegram pribadi Anda.

Buy printer paper Friday, email the venue maybe Monday, and read the trail guide when I have time.

Bot seharusnya mengusulkan tiga tugas dan menanyakan tanggalnya. Belum boleh ada Action pembuatan yang berjalan. Untuk contoh yang dapat diulang, balas dengan tanggal eksplisit:

Use Europe/Warsaw. Friday means 2026-11-20. Make the venue email Monday, 2026-11-23. Leave the trail guide without a date.

Ini tanggal contoh yang tetap, bukan definisi “Jumat ini” setiap kali Anda membaca artikel. Ganti dengan tanggal yang ingin Anda gunakan dalam pengujian sendiri.

Diagram klarifikasi tanggal: Jumat menjadi 20 November, mungkin Senin menjadi 23 November, dan kalau ada waktu menjadi tanpa tanggal Tinjau ketidakpastian sebelum membuat tugas. Ini adalah contoh masukan dan kolom akhir yang dituju.

Bandingkan draf akhir bot dengan tabel ini:

TugasTanggal terkonfirmasiProyek
Beli kertas printer2026-11-20Capture demo
Kirim email ke pengelola tempat2026-11-23Capture demo
Baca panduan jalur pendakianTanpa tanggalCapture demo

Jika ada perbedaan, perbaiki lalu periksa daftar yang direvisi. Kemudian kirim:

Looks good, save all three.

Persetujuan adalah perilaku yang diarahkan prompt, jadi ujilah alih-alih menganggapnya terjamin. Di Inbox, periksa kartu Action percakapan dan View logs. Anda seharusnya melihat pembacaan proyek, diikuti pembuatan satu per satu dan pembacaan ID yang dikembalikan.

6. Bagaimana memeriksa bahwa tugas benar-benar tersimpan?

Buka Capture demo di Todoist lalu bandingkan tiga catatan dengan draf yang Anda setujui. Pesan ramah “selesai” saja bukan bukti penyimpanan.

Input due_date di Quickchat AI berdampingan dengan tugas Buy printer paper di Todoist dan tampilan yang diperbesar dari kolom Project serta Date yang menampilkan Friday Telusuri tanggal di kedua aplikasi: due_date pada Action Quickchat AI sesuai dengan Date di Todoist. Bilah samping yang diperbesar berasal dari tugas kertas printer yang disiapkan secara manual. Buka Date pada tugas Anda sendiri untuk memeriksa tanggal kalender yang tepat.

  1. Periksa kedua tanggal secara tepat serta tidak adanya tanggal pada tugas panduan pendakian.
  2. Bandingkan id pada setiap respons pembuatan dengan respons pembacaan berikutnya. Pastikan content, project_id, dan due cocok dengan item yang disetujui. Anggap ketidakcocokan belum selesai sampai diperiksa.
  3. Tanyakan “Apa yang sekarang ada di Capture demo?” dan pastikan bot membaca ulang tugas aktif. Jika Anda menyelesaikan tugas di Todoist, tugas itu tidak lagi muncul pada daftar aktif tersebut.
  4. Kirim persetujuan lagi. Pastikan tidak muncul tiga tugas tambahan. Bot seharusnya memeriksa hasil sebelumnya dan mengklarifikasi apakah Anda memang menginginkan salinan baru.

Diagram verifikasi yang membandingkan tugas disetujui dengan ID hasil pembuatan dan pembacaan berikutnya atas ID yang sama Verifikasi berarti membaca catatan tersimpan yang sama dan memeriksa kolomnya. Diagram ini menunjukkan apa yang harus dibandingkan, bukan respons API yang sudah dijalankan.

Uji kedua batas akses

Dari akun Telegram lain yang Anda kendalikan, kirim “Tampilkan tugas saya.” Untuk pengujian grup, tambahkan bot yang sama ke grup uji, kirim /start@YOUR_BOT_USERNAME, lalu balas sapaannya dengan permintaan pembuatan tugas. Dengan cara ini, pengujian sesuai dengan mode privasi grup default Telegram.

Di Inbox, pastikan kedua pesan uji telah diterima dan periksa ID pengirim serta jenis percakapannya. Pengujian grup harus menampilkan ID Anda sebagai pemilik dan group atau supergroup. Kedua pengujian seharusnya menghasilkan nol permintaan Todoist. Coba juga pesan yang mengaku sebagai pemilik; teks tidak boleh mengesampingkan metadata pengirim. Pesan yang tidak diterima adalah masalah pengiriman, bukan tanda bahwa pengujian akses berhasil.

Tangani daftar yang baru tersimpan sebagian

Tiga pembuatan tugas adalah tiga permintaan terpisah. Jika permintaan kedua gagal, tugas pertama mungkin sudah ada. Hentikan proses, periksa proyek dan ID yang dikembalikan, lalu tentukan item mana yang masih perlu dibuat.

Contoh penyimpanan sebagian: kertas printer terverifikasi, email tempat belum pasti, dan panduan pendakian belum dicoba Contoh pemulihan: pertahankan tugas terverifikasi, selidiki penulisan yang belum pasti, dan biarkan tugas lain sampai hasilnya jelas.

Jika bot menyimpan sebelum disetujui, perketat deskripsi Action pembuatan dan ulangi percakapan yang sama. Jika menebak tanggal, wajibkan tanggal tepat dalam draf. Jika melaporkan sukses setelah kesalahan, periksa kembali instruksi pembacaan ulang. Kit berisi pemeriksaan ini agar Anda dapat mencatat hasil sendiri sebelum memakai tugas pribadi.

Setelah latihan tiga item ini berhasil, gunakan Pocket Inbox untuk pesan kecil yang biasanya tertinggal di Saved Messages: urusan singkat, email yang perlu dikirim, atau bacaan. Biarkan Todoist terbuka untuk beberapa daftar pertama dan bandingkan maksud Anda dengan hasil tersimpan. Dengan begitu, peninjauan menjadi kebiasaan yang Anda percayai berdasarkan pengamatan.

Pertanyaan yang sering diajukan

Bisakah bot Telegram membuat tugas Todoist?

Ya. Bot yang terhubung ke API Todoist dapat membuat tugas dari pesan Telegram. Resep ini memakai Quickchat AI untuk memisahkan pesan menjadi usulan tugas, mengklarifikasi tanggal, meminta persetujuan, dan memanggil Todoist API v1. Verifikasi catatan hasilnya di proyek Todoist Anda sendiri.

Bisakah pengguna Telegram lain melihat tugas Todoist saya?

Terapkan kedua kondisi yang dievaluasi server pada setiap Action baca dan tulis: telegram_user_id harus sama dengan ID numerik Anda yang terverifikasi, dan telegram_chat_type harus sama dengan private. Uji pengirim lain dan percakapan grup sebelum memakai data pribadi. Prompt yang menyebut khusus pemilik tidak menyediakan kontrol akses.

Apakah bot memahami Jumat depan atau mungkin Senin?

Prompt meminta bot mengklarifikasi tanggal yang belum pasti dan menampilkan tanggal YYYY-MM-DD yang tepat sebelum menyimpan. Berikan zona waktu Anda dan konfirmasikan tanggal akhir. Tugas tanpa tanggal menggunakan Action terpisah yang tidak menyertakan kolom jatuh tempo sama sekali.

Apakah ini mencegah duplikasi tugas Todoist?

Tidak. Membaca tugas yang sudah ada dan memeriksa ID hasil membantu menemukan duplikasi, tetapi resep ini bukan operasi kelompok atomik atau sistem deduplikasi yang terjamin. Jika permintaan kehabisan waktu, periksa Todoist sebelum mencoba lagi; tugas mungkin sudah tersimpan.

Apakah saya perlu kode atau server Todoist MCP?

Anda mengonfigurasi empat HTTP Action dan Main Prompt di Quickchat AI. Anda tidak perlu menjalankan server Todoist MCP. Anda memerlukan bot Telegram, token API Todoist, dan paket Quickchat AI dengan kapasitas Action serta kredit yang cukup untuk pengujian dan percakapan.

Bisakah bot memproses pesan suara atau mengirim pengingat?

Versi pertama ini menerima teks dan membuat tugas bertanggal atau tanpa tanggal. Bot tidak mentranskripsi pesan suara, menjadwalkan pengingat, menyelesaikan tugas, atau menghubungkan akun Todoist milik orang lain. Kemampuan tersebut memerlukan konfigurasi dan pengujian terpisah.

Quickchat AI Quickchat AI Ask Quickchat AI a question