Akun dan integrasi

Hubungkan sistem eksternal atau asisten

Buat kunci Pro atau Agency dengan cakupan terbatas, publikasikan konten terbaru, atau hubungkan asisten.

Sebelum memulai

Webhook menerima pemberitahuan pesan masuk dari layanan WhatsApp. Pengaturan servernya merupakan tanggung jawab operator integrasi. Pengguna panel tidak perlu mengubah pengaturan server. MCP memungkinkan asisten meminta alat akun.

Langkah yang perlu dilakukan

Untuk pesan masuk, buka Pengaturan dan temukan URL Webhook (untuk server WhatsApp).
Pilih Salin untuk memperoleh alamat persis untuk instalasi akun Anda.
Minta operator mengonfigurasi kejadian masuk pada perangkat yang dituju dengan alamat tersebut.
Atur pesan percobaan masuk dari nomor milik Anda setelah operator menyatakan siap.
Periksa hasil yang diharapkan, seperti balasan otomatis yang cocok atau pesan grup yang baru tercatat ketika Log aktif.
Untuk koneksi asisten, masuk melalui layar otorisasi yang dibuka klien MCP Anda.
Periksa nama aplikasi dan akun sebelum menyetujui akses.
Untuk integrasi pengiriman keluar, buka Pengaturan → Integrasi eksternal. Buat kunci bernama untuk satu akun yang terhubung dan grup yang dipilih secara eksplisit. Segera simpan kunci; kunci hanya ditampilkan sekali. Salin URL dasar API.
Contoh: Atur Abacus.AI agar menghasilkan konten baru pada masing-masing dari delapan waktu publikasi harian di America/Sao_Paulo. Kirim setiap publikasi ke tiga grup yang diizinkan dengan Idempotency-Key baru. Gunakan kembali kunci tersebut hanya untuk mencoba ulang permintaan yang identik.
Hilangkan scheduled_at untuk langsung masuk antrean, atau gunakan stempel waktu absolut dengan -03:00 atau Z (UTC), maksimal 30 hari ke depan. Pemroses memeriksa setiap menit; scheduled_at adalah waktu paling awal pemrosesan dapat dimulai, tanpa jaminan pengantaran pada detik yang tepat.
Periksa status tugas dan hasil tiap grup sebelum mencoba ulang. Batalkan hanya pengiriman yang belum dikirimkan. Cabut kunci yang bocor di Pengaturan, lalu buat dan simpan penggantinya; tugas lama tidak dilanjutkan dengan kunci baru.

Contoh penggunaan

Permintaan dengan penanda pengganti; ganti ID dan pilih tanggal mendatang sebelum mengirim. Permintaan ini memublikasikan pesan sungguhan. curl '<API_BASE_URL>/v1/groups' -H 'Authorization: Bearer <ZAPBOT_API_KEY>' curl -X POST '<API_BASE_URL>/v1/jobs' -H 'Authorization: Bearer <ZAPBOT_API_KEY>' -H 'Idempotency-Key: publication-2026-10-16-0900' -H 'Content-Type: application/json' --data '{"type":"text","group_ids":["<GROUP_JID_1>","<GROUP_JID_2>","<GROUP_JID_3>"],"text":"Updated publication","scheduled_at":"2026-10-16T09:00:00-03:00"}' curl -X POST '<API_BASE_URL>/v1/jobs' -H 'Authorization: Bearer <ZAPBOT_API_KEY>' -H 'Idempotency-Key: publication-2026-10-16-1200' -F 'payload={"type":"image","group_ids":["<GROUP_JID_1>","<GROUP_JID_2>","<GROUP_JID_3>"],"caption":"Updated caption"}' -F 'image=@publication.png;type=image/png' curl '<API_BASE_URL>/v1/jobs/<JOB_ID>' -H 'Authorization: Bearer <ZAPBOT_API_KEY>' curl -X DELETE '<API_BASE_URL>/v1/jobs/<JOB_ID>' -H 'Authorization: Bearer <ZAPBOT_API_KEY>'

Cara memeriksa hasil

Penerimaan tugas dan hasil diterima per grup mengonfirmasi penerimaan oleh gerbang. Keduanya tidak mengonfirmasi pengantaran atau pembacaan. Tugas terjadwal dapat diblokir jika akses, kunci, akun, atau izin grup berubah.

Hal yang perlu diketahui

Asisten dapat membaca catatan yang tersedia dan mengirim teks ketika diminta. Baca panduan alat asisten sebelum meminta pengiriman.
Gunakan panel untuk pengeditan yang tidak tersedia melalui MCP.
Akses API termasuk dalam paket Pro dan Agency bulanan atau tahunan. Starter perlu ditingkatkan. Kunci hanya mengizinkan akun dan grup yang dipilih; mengganti akun WhatsApp akan memblokir pengiriman. Jangan pernah membagikan kredensial server.
Teks mendukung 4.096 karakter; keterangan gambar 1.024. Unggah JPEG, PNG, atau WebP hingga 5 MiB melalui kolom multipart payload dan image. URL gambar jarak jauh tidak diterima.
Tugas baru mengembalikan HTTP 202. Percobaan ulang yang identik dengan Idempotency-Key yang sama mengembalikan tugas asli dengan HTTP 200; konten berbeda dengan kunci yang sama mengembalikan 409. Batas waktu yang habis setelah pengiriman dimulai dapat berstatus belum dikonfirmasi; jangan otomatis mengirim ulang dengan kunci lain.

Masalah umum

Yang terlihat: Tidak ada balasan atau catatan baru setelah percobaan.
Tindakan yang perlu dilakukan: Periksa koneksi perangkat dan aturan terkait atau pengaturan Log, lalu minta operator memeriksa konfigurasi kejadian masuk.
Hasil yang diharapkan: Fitur yang dikonfigurasi dengan benar dapat memproses kejadian baru yang cocok.

Yang terlihat: Asisten tidak dapat memperoleh otorisasi atau menunjukkan akun lain.
Tindakan yang perlu dilakukan: Kembali ke halaman masuk dan pilih akun yang dituju; laporkan kesalahan otorisasi berulang kepada operator.
Hasil yang diharapkan: Layar otorisasi dan catatan yang dikembalikan milik akun yang dituju.

Bantuan lebih lanjut

Beri operator fitur dan kesalahan yang terlihat. Jangan sertakan kredensial server dalam percakapan asisten.

Buka fitur ini