Cara membangun agen WhatsApp dengan OpenAI Agents SDK

OpenAI Agents SDK adalah framework open source milik OpenAI untuk membangun agen: model dengan instruksi, alat yang boleh dipanggilnya, handoff ke agen lain, dan guardrail pada input dan outputnya, semuanya berjalan dalam siklus sampai tugas selesai. Ini cara yang bagus untuk membangun agen. Namun dengan sendirinya ia tidak memberi Anda nomor WhatsApp, inbox tim, pesan template, atau cara bagi petugas untuk mengambil alih. Dengan Agent Harness MonoChat, Anda memilih OpenAI Agents SDK sebagai AI Harness, meletakkan node AI Agent dalam alur, menghubungkan WhatsApp, lalu menguji, dan MonoChat mengurus sisanya.

Panduan ini membahas apa yang diberikan SDK, tiga cara memakai agen OpenAI di MonoChat, penyiapan langkah demi langkah, dan detail khusus WhatsApp yang menentukan apakah pelanggan memercayai agen.

Apa yang diberikan OpenAI Agents SDK

SDK ini dibangun di sekitar beberapa gagasan inti:

• Agen: model ditambah instruksi yang menjelaskan tugasnya.
• Alat: fungsi yang dapat dipanggil agen, seperti “cari pesanan” atau “periksa slot waktu”, ditambah server MCP.
• Handoff: satu agen menyerahkan tugas ke agen lain yang berspesialisasi di bidang itu, misalnya dari agen dukungan umum ke agen pengembalian.
• Guardrail: pemeriksaan yang berjalan berdampingan dengan agen untuk menghentikan input atau output yang tidak Anda inginkan.
• Sesi dan tracing: memori lintas giliran dan catatan tentang apa yang dilakukan agen, langkah demi langkah.

Bersama-sama, itulah agent harness: siklus yang memungkinkan model bertindak, memeriksa hasil kerjanya, dan melanjutkan, bukan menjawab sekali. Untuk pesan pelanggan, inilah perbedaan antara menjelaskan kebijakan pengembalian Anda dan benar-benar membuat pengembaliannya.

Apa yang ditambahkan WhatsApp pada masalahnya

Membangun agen hanyalah separuh pekerjaan. Menempatkannya di hadapan pelanggan di WhatsApp berarti menangani:

• WhatsApp Business Platform. Koneksi API resmi, bisnis terverifikasi, dan nomor yang disetujui.
• Jendela 24 jam. Balasan bebas diizinkan dalam 24 jam setelah pesan terakhir pelanggan; setelah itu Anda memerlukan template yang disetujui.
• Kebijakan. Sejak 15 Januari 2026, WhatsApp melarang asisten AI serbaguna di platform. Agen yang melayani pelanggan Anda sendiri diizinkan, dan jalur yang jelas ke petugas diharapkan saat balasan bersifat otomatis.
• Petugas. Sebagian percakapan harus diteruskan ke petugas, dengan riwayat utuh, di dalam alat yang sudah digunakan tim Anda.
• Kanal lain. Pelanggan yang menulis di Instagram, Messenger, atau situs web Anda mengharapkan jawaban yang sama.

MonoChat menangani semua ini di sekitar agen, sehingga pekerjaan Anda tetap fokus pada agennya.

Tiga cara memakai agen OpenAI di MonoChat

Opsi	Tempat berjalan	Yang Anda perlukan
OpenAI Agents SDK	Di dalam MonoChat	Tidak ada tambahan; memakai model AI Anda
OpenAI Agents API (dihosting oleh OpenAI)	Cloud OpenAI	API key OpenAI Anda
Custom (layanan Agents SDK Anda sendiri)	Server Anda sendiri	URL endpoint dan shared secret

Mulailah dengan harness OpenAI Agents SDK jika Anda menginginkan agen bergaya OpenAI tanpa men-deploy apa pun. Pilih OpenAI Agents API jika agen Anda sudah berada di platform terkelola OpenAI. Pilih Custom jika developer Anda telah menulis agen sendiri dengan SDK, lengkap dengan alat, handoff, dan pengujiannya, dan ingin terus menjalankan kode tersebut; lihat cara menghubungkan agen AI Anda sendiri ke WhatsApp.

Langkah demi langkah: agen OpenAI Agents SDK di WhatsApp

1. Tambahkan AI Harness

Tambahkan AI Harness di MonoChat dan pilih OpenAI Agents SDK sebagai penyedia. SDK ini berjalan di dalam MonoChat dan memakai model AI yang sudah Anda siapkan, sehingga tidak ada key atau server tambahan untuk langkah ini.

2. Tambahkan node AI Agent ke alur

Di alur yang menerima percakapan WhatsApp Anda, tambahkan node AI Agent dan pilih harness-nya. Tulis instruksi agen: siapa yang dilayaninya, apa yang dapat dilakukannya, apa yang tidak boleh dilakukannya, dan kapan ia menyerahkan.

3. Pilih model utama, fallback, dan cepat

Setiap node AI Agent memiliki tiga peran model:

• Model utama bernalar dan menulis balasan.
• Model fallback mengambil alih setelah batas lunak atau kegagalan.
• Model cepat menangani pekerjaan latar belakang.

Tambahkan batas anggaran per proses agar satu percakapan yang tidak biasa tidak menghasilkan tagihan besar. Tidak yakin cara memilih fallback? Baca mengapa agen AI yang berhadapan dengan pelanggan membutuhkan model fallback.

4. Hubungkan alat Anda

Berikan agen alat yang sesuai dengan permintaan Anda yang paling sering:

• AI function tools untuk panggilan ke API Anda sendiri dengan input terstruktur.
• Integrasi MCP untuk alat dari sistem yang kompatibel dengan MCP.
• Basis pengetahuan AI untuk jawaban yang berlandaskan dokumen dan kebijakan Anda.
• Fungsi kustom untuk logika yang berjalan di dalam percakapan.

Tiga alat yang baik mengalahkan lima belas alat yang setengah teruji. Tambahkan lebih banyak setelah Anda melihat percakapan nyata.

5. Hubungkan WhatsApp (dan semua yang lain)

Hubungkan nomor WhatsApp Business Anda melalui MonoChat, Meta Business Partner resmi. Alur yang sama dapat berjalan di Instagram, Messenger, TikTok, Telegram, web chat, SMS, dan suara, sehingga satu agen mencakup setiap kanal.

6. Uji dengan pesan nyata

Gunakan percakapan bulan lalu sebagai set pengujian Anda. Sertakan yang sulit: pelanggan yang marah, pertanyaan yang samar, beberapa permintaan dalam satu pesan, pelanggan yang langsung meminta petugas. Periksa pemanggilan alat, nada, dan serah terima. Lalu luncurkan.

Pola yang berhasil di WhatsApp

Satu pertanyaan per pesan. Agen yang dibuat untuk chat di web cenderung menjawab dengan daftar panjang. Di ponsel, pesan singkat dan satu pertanyaan yang jelas sekali waktu mendapatkan balasan yang lebih baik dari pelanggan.

Konfirmasi sebelum tindakan yang tidak dapat dibatalkan. Biarkan agen mengusulkan, dan pelanggan mengonfirmasi, sebelum pembatalan, pengembalian dana, atau perubahan reservasi.

Spesialis lewat handoff, petugas lewat inbox. Handoff pada SDK sangat baik untuk perutean antaragen (penjualan, dukungan, pengembalian). Serah terima ke petugas ada di inbox tim bersama MonoChat, tempat percakapan tiba dengan riwayat lengkapnya.

Instruksi yang menyebut batasan. “Pengembalian dana hingga €50 boleh Anda setujui; di atas itu, serahkan ke tim penagihan.” Angka yang eksplisit mengalahkan aturan yang samar.

Tetap seputar bisnis Anda. Agen yang membantu pelanggan Anda diizinkan di WhatsApp. Agen yang menjawab apa saja berisiko melanggar aturan WhatsApp 2026; panduan kebijakan chatbot AI WhatsApp kami menjelaskan di mana batasnya.

Biaya

Tiga hal bertambah: paket MonoChat Anda, penggunaan model AI, dan biaya pesan WhatsApp dari Meta. Sejak 1 Oktober 2026, Meta menagih balasan layanan setelah 1.000 pertama per nomor bisnis setiap bulan; lihat panduan harga WhatsApp API kami.

Dari sisi AI, MonoChat tidak menambahkan markup saat Anda memakai key penyedia sendiri. Anggaran per proses, model cepat yang lebih murah untuk pekerjaan latar belakang, dan fallback yang andal menjaga tagihan tetap dapat diprediksi.

Tidak terkunci

Agent Harness memungkinkan Anda memilih framework, bukan hanya model. Jika nanti Anda ingin mencoba Claude Agent SDK, Pi, Claude Managed Agents, atau framework Anda sendiri, tambahkan AI Harness lain dan arahkan node AI Agent ke sana. Kanal, alat, dan serah terima Anda tetap seperti semula. Bandingkan semua penyedia di halaman Agent Harness.