WhatsApp

GetMyBot, WhatsApp'ı WhatsApp Cloud API (Meta Graph API) üzerinden bağlar. Bağlantı sonrası bot, WhatsApp'tan gelen mesajları alır ve bunlara tepkilerinizi uygular; operatörler ise diyaloglarda yazışmayı yürütebilir. Çok kanallılığa genel bakış — Kanallar sayfasında.

WhatsApp kanalını bağlama

Bağlantı için Meta uygulamanızdan (WhatsApp Cloud API) beş kimlik bilgisi gerekir. Hepsi zorunludur:

  • Phone number ID — WhatsApp Business numarasının tanımlayıcısı.
  • WABA ID — WhatsApp Business Account tanımlayıcısı.
  • Access token — Meta uygulamasının erişim tokeni.
  • Verify token — kendinizin belirlediği rastgele bir dize. Meta'da webhook doğrulaması sırasında kullanılır (aşağıya bakın).
  • App secret — Meta uygulamasının sırrı. Gelen webhook'ların HMAC imzasını doğrulamak için gereklidir (X-Hub-Signature-256 başlığı).

Arayüzdeki adımlar:

  1. Botlar → «Kanal ekle» → WhatsApp'ı açın.
  2. Yukarıdaki beş alanı ve isterseniz kanal adını (isteğe bağlı) doldurun.
  3. «Doğrula» düğmesine basın — GetMyBot kimlik bilgilerini Meta üzerinden doğrular.
  4. «Bağla» düğmesine basın.

Meta'da webhook yapılandırması

Bağlantı sonrası kanalda {adres}/ch/{channelID} biçiminde bir Callback URL (arayüzde — webhook simgesi 🔗) belirir. Bunu Verify token'ınızla birlikte Meta uygulamasında belirtmeniz gerekir: WhatsApp → Configuration → Webhook.

Nasıl çalışır:

  1. Meta, Callback URL'ye bir doğrulama isteği gönderir ve iletilen verify_token'ı sizin Verify token'ınızla karşılaştırır. Eşleşince webhook onaylanmış sayılır.
  2. Ardından Meta bu adrese olayları gönderir (gelen mesajlar, teslim durumları, şablon moderasyon kararları).
  3. Her gelen istek X-Hub-Signature-256 başlığıyla imzalanır; GetMyBot imzayı App secret ile doğrular — bu kimlik bilgisinin bağlantı sırasında istenmesinin nedeni budur.

24 saatlik oturum penceresi

WhatsApp, bot inisiyatifiyle yazışmayı sınırlar: serbest mesajlar kullanıcıya yalnızca son gelen mesajından sonraki 24 saat içinde gönderilebilir. Kullanıcıdan gelen her yeni mesaj pencereyi yeniler.

24 saatlik pencerenin dışında serbest mesaj gönderilemez — kullanıcıya yeniden yazmanın (re-engage) tek yolu onaylanmış bir mesaj şablonudur. Bu nedenle şablonlar, WhatsApp'ta toplu gönderim ve hatırlatmalar için temel araçtır.

Mesaj şablonları

Şablon (message template), Meta ile önceden mutabık kalınan ve oturum penceresi dışında gönderilebilen bir mesajdır. Şablon yönetimi — GetMyBot arayüzünde.

Şablonlar nerede yönetilir

Botlar → WhatsApp kanalında «Mesaj şablonları» simgesi (📄) → «WhatsApp kanalı şablonları» diyaloğu. Diyalogda düğmeler:

  • «Şablon oluştur» — yeni bir şablon kurmak.
  • «Senkronize et» — şablon kataloğunu Meta'dan çekmek (durumları ve listeyi güncellemek).

Şablon kategorileri

  • MARKETING (Pazarlama) — kampanyalar, duyurular, toplu gönderimler.
  • UTILITY (Servis) — kullanıcı eylemlerine ilişkin bildirimler (sipariş durumları, hatırlatmalar).
  • AUTHENTICATION (Kimlik doğrulama) — onay kodları.

Şablon alanları

  • Ad — küçük Latin harfleri, rakamlar ve _, en fazla 512 karakter.
  • Dil — Meta yerel ayarı.
  • Kategori — yukarıdaki üçten biri.

Pazarlama ve Servis kategorileri için ek olarak:

  • Başlık — yok / metin / görsel / video / belge. Medya başlığı için örnek dosya yüklenir.
  • Gövde — zorunlu, en fazla 1024 karakter. Değişkenler {{1}}, {{2}}, … şeklinde, kesinlikle 1'den N'e sırayla, atlama olmadan gösterilir.
  • Altbilgi — en fazla 60 karakter.
  • Butonlar — en fazla 10: hızlı yanıt, bağlantı (en fazla 2), telefon (1), kod kopyalama (1).
  • Her {{n}} değişkeni için bir örnek değer belirtilmelidir — bu, moderasyon için Meta'nın gereksinimidir.

Kimlik doğrulama kategorisinde gövde bizzat Meta tarafından sabitlenir; şunlar yapılandırılır: kodun geçerlilik süresi (1–90 dakika), güvenlik önerisi ve kod kopyalama butonunun metni.

Moderasyon

«Oluştur» düğmesi şablonu hemen Meta moderasyonuna gönderir — ayrı bir «incelemeye gönder» adımı yoktur. Karar asenkron olarak (webhook aracılığıyla) gelir, şablon listesi otomatik yenilenir. Durumlar:

  • PENDING (İncelemede)
  • APPROVED (Onaylandı)
  • REJECTED (Reddedildi) — nedeni belirtilerek
  • ayrıca PAUSED, DISABLED, IN_APPEAL, PENDING_DELETION.

APPROVED, REJECTED, PAUSED durumlarındaki şablonlar düzenlenebilir. Ad ve dil değiştirilemez; onaylanmış şablonlarda kategori de kilitlidir.

Tepkide şablon kullanımı

Şablon gönderme, bir tepki eylemidir:

  1. Tepki oluşturucuda «Eylemler» → «Eylem ekle» → «WhatsApp şablonu gönder»'i açın.
  2. Eylem yalnızca botun şablon destekli bir WhatsApp kanalı bağlıysa kullanılabilir.
  3. Yalnızca onaylanmış (APPROVED) bir şablon seçilir.
  4. Parametreler doldurulur: gövdedeki {{n}} değişkenlerinin değerleri, metin başlığı, bağlantı üzerinden medya başlığı, URL butonlarının parametreleri. Parametrelerde değişken yer tutucuları kullanılabilir.

Gerçek gönderim kanalı, olayın kanalına göre belirlenir: olay WhatsApp'tan geldiyse şablon WhatsApp'a gider.

Diyaloglar ve ekler

Operatör, WhatsApp diyaloğunda yanıt verebilir ve ekler gönderebilir — görsel, video veya belge — 24 saatlik pencere dikkate alınarak (pencere dışında serbest yazışma kullanılamaz). Abonelerden gelen medya, proxy üzerinden çekilir ve diyalogda gösterilir.

Ücretlendirme

GetMyBot, WhatsApp görüşmelerini (conversations) kategorilere göre kaydeder — marketing / utility / authentication / service. Mevcut sürümde bu yalnızca gözlemlenebilirlik için bir kayıttır (record-only): görüşmeler için bakiye düşülmez.

Sonraki adımlar