Hesap ve entegrasyonlar

Harici bir sistem veya asistan bağlama

Pro veya Agency ile sınırlı yetkili bir anahtar oluşturun, yeni içerikler yayımlayın veya bir asistan bağlayın.

Başlamadan önce

Webhook, WhatsApp hizmetinden gelen mesaj bildirimlerini alır. Sunucu kurulumu entegrasyon operatörünün sorumluluğudur. Panel kullanıcılarının sunucu ayarlarını değiştirmesi gerekmez. MCP, asistanın hesap araçlarını istemesini sağlar.

Yapılacaklar

Gelen mesajlar için Ayarlar’ı açın ve Webhook URL’si alanını bulun.
Hesabınızın kurulumuna ait tam adresi almak için Kopyala’yı seçin.
Operatörden bu adresle amaçlanan cihaz için gelen olayları yapılandırmasını isteyin.
Operatör hazır olduğunu doğruladıktan sonra kendi numaranızdan gelen deneme mesajı düzenleyin.
Eşleşen otomatik yanıt veya Günlük etkinken yeni kaydedilen grup mesajı gibi beklediğiniz sonucu kontrol edin.
Asistan bağlantısı için MCP istemcinizin açtığı yetkilendirme ekranından giriş yapın.
Erişimi onaylamadan önce belirtilen uygulamayı ve hesabı inceleyin.
Giden gönderim entegrasyonu için Ayarlar → Harici entegrasyonlar bölümünü açın. Bağlı bir hesap ve açıkça seçilmiş gruplar için adlandırılmış bir anahtar oluşturun. Anahtarı hemen kaydedin; yalnızca bir kez gösterilir. API temel URL’sini kopyalayın.
Örnek: Abacus.AI’ı America/Sao_Paulo saat dilimindeki günlük sekiz yayın saatinin her birinde yeni içerik üretecek şekilde yapılandırın. Her yayını yeni bir Idempotency-Key ile izin verilen üç gruba gönderin. Anahtarı yalnızca aynı isteği değişiklik yapmadan yeniden denemek için kullanın.
Hemen kuyruğa almak için scheduled_at alanını atlayın veya en fazla 30 gün sonrası için -03:00 ya da Z (UTC) içeren mutlak bir zaman damgası kullanın. İşleyici her dakika kontrol eder; scheduled_at işleme alınabilecek en erken zamandır, tam o saniyede teslim garantisi vermez.
Yeniden denemeden önce iş durumunu ve grup bazındaki sonuçları kontrol edin. Yalnızca henüz başlatılmamış gönderimleri iptal edin. Ele geçirilmiş bir anahtarı Ayarlar’dan iptal edin, ardından yenisini oluşturup kaydedin; eski işler yeni anahtarla devam etmez.

Uygulamalı örnek

Yer tutuculu istekler; göndermeden önce kimlikleri değiştirin ve gelecekte bir tarih seçin. Bu istekler gerçek mesajlar yayımlar. 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>'

İşe yaradığını nasıl kontrol edebilirsiniz?

İşin kabulü ve grup bazındaki kabul sonuçları, ağ geçidinin kabulünü doğrular. Teslimi veya okunmayı doğrulamaz. Erişim, anahtar, hesap ya da grup izinleri değişirse zamanlanmış işler engellenebilir.

Bilmeniz gerekenler

Asistanlar sunulan kayıtları okuyabilir ve istendiğinde metin gönderebilir. Gönderim istemeden önce asistan araçları kılavuzunu inceleyin.
MCP üzerinden bulunmayan düzenleme işlemleri için paneli kullanın.
API erişimi aylık veya yıllık Pro ve Agency planlarına dahildir. Starter için üst plana geçmek gerekir. Anahtarlar yalnızca seçilen hesap ve gruplara izin verir; WhatsApp hesabını değiştirmek gönderimi engeller. Sunucu kimlik bilgilerini asla paylaşmayın.
Metinler 4.096, açıklamalar 1.024 karakter destekler. En fazla 5 MiB boyutunda JPEG, PNG veya WebP dosyalarını multipart payload ve image alanlarıyla yükleyin. Uzak görsel URL’leri kabul edilmez.
Yeni bir iş HTTP 202 döndürür. Aynı Idempotency-Key ile yapılan özdeş bir yeniden deneme, özgün işi HTTP 200 ile döndürür; aynı anahtarla farklı içerik 409 döndürür. Gönderim başladıktan sonraki zaman aşımı sonucu doğrulanmamış bırakabilir; başka bir anahtarla otomatik olarak yeniden göndermeyin.

Sık karşılaşılan sorunlar

Gördüğünüz durum: Denemeden sonra yanıt veya yeni kayıt görünmüyor.
Yapılacak işlem: Cihaz bağlantısını ve ilgili kuralı veya Günlük ayarını kontrol edin; ardından operatörden gelen olay yapılandırmasını doğrulamasını isteyin.
Beklenen sonuç: Doğru yapılandırılmış özellik yeni eşleşen olayı işleyebilir.

Gördüğünüz durum: Asistan yetkilendirilemiyor veya başka hesabı gösteriyor.
Yapılacak işlem: Girişe dönüp amaçlanan hesabı seçin; tekrarlanan yetkilendirme hatalarını operatöre bildirin.
Beklenen sonuç: Yetkilendirme ekranı ve dönen kayıtlar amaçlanan hesaba aittir.

Daha fazla yardım alın

Operatöre özelliği ve görünür hatayı bildirin. Sunucu kimlik bilgilerini asistan sohbetlerine koymayın.

Bu özelliği aç