Akaun dan integrasi
Hubungkan sistem luaran atau pembantu
Cipta kunci berskop Pro atau Agency, terbitkan kandungan baharu atau hubungkan pembantu.
Sebelum bermula
Webhook menerima pemberitahuan mesej masuk daripada perkhidmatan WhatsApp. Persediaan pelayannya ialah tanggungjawab pengendali integrasi. Pengguna panel tidak perlu mengubah tetapan pelayan. MCP membolehkan pembantu meminta alat akaun.
Langkah yang perlu dilakukan
- Untuk mesej masuk, buka Tetapan dan cari URL webhook (untuk pelayan WhatsApp).
- Pilih Salin untuk mendapatkan alamat tepat bagi pemasangan akaun anda.
- Minta pengendali mengkonfigurasi peristiwa masuk untuk peranti yang dimaksudkan dengan alamat itu.
- Atur mesej ujian masuk daripada nombor sendiri selepas pengendali mengesahkan persediaan sedia.
- Semak hasil yang dijangka, seperti balasan automatik sepadan atau mesej kumpulan baharu direkodkan apabila Log aktif.
- Untuk sambungan pembantu, log masuk melalui paparan kebenaran yang dibuka oleh klien MCP anda.
- Semak aplikasi yang dinamakan dan akaun sebelum meluluskan akses.
- Untuk integrasi penghantaran, buka Tetapan → Integrasi luaran. Cipta kunci bernama untuk satu akaun yang disambungkan dan kumpulan yang dipilih secara khusus. Simpan kunci segera; kunci hanya dipaparkan sekali. Salin URL asas API.
- Contoh: Tetapkan Abacus.AI untuk menjana kandungan baharu pada setiap satu daripada lapan waktu penerbitan harian dalam America/Sao_Paulo. Hantar setiap penerbitan ke tiga kumpulan yang dibenarkan dengan Idempotency-Key baharu. Gunakan semula kunci hanya untuk mencuba semula permintaan yang sama sepenuhnya.
- Abaikan scheduled_at untuk memasukkan ke dalam baris gilir serta-merta, atau gunakan cap masa mutlak dengan -03:00 atau Z (UTC), sehingga 30 hari ke hadapan. Pemproses menyemak setiap minit; scheduled_at ialah waktu paling awal yang layak, tanpa jaminan penghantaran pada saat yang tepat.
- Semak status tugas dan hasil setiap kumpulan sebelum mencuba semula. Batalkan hanya penghantaran yang belum dihantar keluar. Batalkan kunci yang terjejas dalam Tetapan, kemudian cipta dan simpan pengganti; tugas lama tidak disambung dengan kunci baharu.
Contoh penggunaan
Permintaan dengan pemegang tempat; gantikan ID dan pilih tarikh akan datang sebelum menghantar. Permintaan ini menerbitkan mesej sebenar. 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 menyemak hasil
Penerimaan tugas dan hasil kumpulan yang diterima mengesahkan penerimaan oleh gerbang. Ini tidak mengesahkan penghantaran atau pembacaan. Tugas berjadual boleh disekat jika akses, kunci, akaun atau kebenaran kumpulan berubah.
Perkara yang perlu diketahui
- Pembantu boleh membaca rekod tersedia dan menghantar teks apabila diminta. Semak panduan alat pembantu sebelum meminta penghantaran.
- Gunakan panel untuk tindakan penyuntingan yang tidak tersedia melalui MCP.
- Akses API disertakan dalam pelan Pro dan Agency bulanan atau tahunan. Starter memerlukan naik taraf. Kunci hanya membenarkan akaun dan kumpulan yang dipilih; menggantikan akaun WhatsApp menyekat penghantaran. Jangan kongsi kelayakan pelayan.
- Teks menyokong 4,096 aksara; kapsyen 1,024. Muat naik JPEG, PNG atau WebP sehingga 5 MiB sebagai medan multipart payload dan image. URL imej jauh tidak diterima.
- Tugas baharu mengembalikan HTTP 202. Percubaan semula yang sama dengan Idempotency-Key mengembalikan tugas asal dengan HTTP 200; kandungan berbeza dengan kunci yang sama mengembalikan 409. Tamat masa selepas penghantaran dimulakan boleh menghasilkan status belum disahkan; jangan hantar semula secara automatik dengan kunci lain.
Masalah biasa
- Perkara yang anda lihat
- Tiada balasan atau rekod baharu muncul selepas ujian.
- Tindakan yang perlu diambil
- Semak sambungan peranti dan peraturan berkaitan atau tetapan Log, kemudian minta pengendali mengesahkan konfigurasi peristiwa masuk.
- Hasil yang dijangka
- Ciri yang dikonfigurasi dengan betul dapat memproses peristiwa sepadan yang baharu.
- Perkara yang anda lihat
- Pembantu tidak dapat memperoleh kebenaran atau menunjukkan akaun lain.
- Tindakan yang perlu diambil
- Kembali ke log masuk dan pilih akaun yang dimaksudkan; laporkan ralat kebenaran berulang kepada pengendali.
- Hasil yang dijangka
- Paparan kebenaran dan rekod yang dikembalikan milik akaun yang dimaksudkan.
Dapatkan bantuan lanjut
Berikan ciri dan ralat yang kelihatan kepada pengendali. Jangan sertakan bukti kelayakan pelayan dalam perbualan dengan pembantu.