Skip to main content
DokümanlarRehberlerWhatsApp

WhatsApp İşletme API'si

Müşterilerle sohbet etmek, yapay zekanın sizin yerinize yanıt vermesini sağlamak ve toplu mesaj göndermek için WhatsApp numaranızı BeeCastly'ye bağlayın. Bir QR kodu tarayarak veya resmi Meta WhatsApp Cloud API üzerinden bağlanabilirsiniz.

Ön Koşullar

Bir BeeCastly hesabı (ücretsiz paket yeterli)
Bir Meta Business hesabı (business.facebook.com)
Cloud API yöntemi için: bir Meta Business hesabı (business.facebook.com) ve Meta'ya kaydedilecek bir telefon numarası

Bağlanmanın iki yolu

QR kodu tarayın

Zaten kullandığınız numarayı, WhatsApp Business uygulaması numarası dahil, tıpkı WhatsApp Web gibi bağlayın. Ücretsizdir ve Meta onayı gerektirmez. Yanıtlar ve otomatik yanıtlar için en iyisidir. Toplu mesajlar için kullanmayın: WhatsApp numarayı yasaklayabilir.

WhatsApp Cloud API (Meta)

Meta'nın resmi yolu. Bir Meta Business hesabı ve onaylı mesaj şablonları gerektirir. Toplu mesajlar ve kampanyalar için kullanılacak yöntem budur.

Kurulum Rehberi

1BeeCastly'de WhatsApp'ı Bağlayın

Entegrasyonlar → Kanallar → WhatsApp bölümüne gidin.
QR kodu: WhatsApp QR seçeneğini seçin. Telefonunuzda WhatsApp'ı açın → Bağlı cihazlar → Cihaz bağla ve kodu tarayın. Telefonunuz normal şekilde çalışmaya devam eder.
Cloud API: WhatsApp Cloud API (Meta) seçeneğini seçin ve Facebook ile bağlan düğmesine tıklayın. Meta Business hesabınızı ve telefon numaranızı seçin. Elle yapmayı tercih ederseniz, Adım Adım Sihirbaz sizden Meta App ID, WhatsApp Business Account ID, Phone Number ID ve erişim belirtecini ister.

2Mesaj Şablonları Oluşturun

Cloud API'de, serbest metni yalnızca müşterinin son mesajından sonraki 24 saat içinde gönderebilirsiniz. Bu sürenin dışında Meta'nın onayladığı bir şablona ihtiyacınız vardır.
Kampanyalar → Şablonlar bölümüne gidin ve bir şablon oluşturun.
Bir kategori seçin: Pazarlama, Hizmet veya Kimlik Doğrulama.
İsimler ve diğer ayrıntılar için {{1}} ve {{2}} gibi değişkenler ekleyin.
Gönderin. Meta inceler ve durum BeeCastly'de güncellenir.

3Toplu Gönderim Kampanyası Gönderin

Kampanyalar → Toplu Gönderimler → Oluştur bölümüne gidin.
Kanal olarak WhatsApp'ı seçin.
Onaylı şablonunuzu ve hedef kitlenizi (kişiler, etiketler veya segmentler) seçin.
Şablon değişkenlerini kişi alanlarıyla (ad, telefon, özel alanlar) eşleştirin.
Mesajı önizleyin, ardından Şimdi Gönder veya Zamanla düğmesine tıklayın.

4Görüşmeleri Yönetin

Gelen WhatsApp mesajları Mesajlar → WhatsApp bölümüne (ve Tüm Mesajlar bölümüne) düşer.
Gelen kutusundan yanıt verin, sık gönderdiğiniz yanıtlar için Hızlı Yanıtlar'ı kullanın ve sohbetleri ekip üyelerine atayın.
Sohbet botunuzun sık sorulan sorulara Bilgi Bankanızdan yanıt vermesi için yapay zeka yanıtlarını açın ve gerektiğinde bir kişiye devredin.

5Daha fazla WhatsApp aracı

Mesajlar → Status Studio: WhatsApp durumları paylaşın.
Mesajlar → wa.me Bağlantısı: web siteniz ve afişleriniz için tıkla-sohbet bağlantısı veya QR kodu oluşturun.
Entegrasyonlar → Kanallar → WhatsApp: işletme profilinizi ve ürün kataloğunuzu düzenleyin (Cloud API).

En İyi Uygulamalar

Kalite puanınızı yüksek tutun

İstenmeyen mesajlardan kaçınarak mesaj kalite puanınızı YÜKSEK tutun. Kullanıcılar sizi engellerse veya mesajlarınızı şikâyet ederse Meta gönderim limitlerinizi kısıtlayabilir.

Açık izin alın

Pazarlama mesajları göndermeden önce, örneğin bir form, web sitesi sohbeti veya yüz yüze, açık izin alın.

Yapay zeka otomatik yanıtı akıllıca kullanın

Yapay zeka yanıtları, Bilgi Bankanızda fiyatlarınız, saatleriniz ve politikalarınız olduğunda en iyi sonucu verir. Müşterilerin bir kişiye ulaşabilmesi için her zaman bir yol bırakın.

Önemli: 24 saatlik süre (Cloud API)

WhatsApp Cloud API'de serbest metni yalnızca müşterinin son mesajından sonraki 24 saat içinde gönderebilirsiniz. Bu sürenin dışında onaylı bir şablon kullanmanız gerekir.

API Examples

Send a WhatsApp message from your own software with an API key. See the Messages API for details.

bash
curl -X POST https://beecastly.com/api/v1/messages/send \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"channel":"WHATSAPP","to":"+919876543210","content":"Hello from BeeCastly!"}'
javascript·send-message.js
const response = await fetch('https://beecastly.com/api/v1/messages/send', {
  method: 'POST',
  headers: {
    'x-api-key': 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    channel: 'WHATSAPP',
    to: '+919876543210',
    content: 'Hello from BeeCastly!',
  }),
});

const data = await response.json(); // { success: true, data: { messageId, status: "queued" } }

Troubleshooting

Template not approved

If your template is rejected by Meta, check that it follows WhatsApp's guidelines: no promotional content in utility templates, proper formatting, and clear call-to-action buttons.

Messages not delivering

QR method: check that your phone is online and still shows BeeCastly under Linked devices. Cloud API: check that the customer has opted in and that your number's status is healthy in Meta Business Manager.

Rate limits

Meta limits how many people a new Cloud API number can message per day, and the limit grows as you send good-quality messages. Start with small broadcasts and schedule larger ones in Campaigns → Broadcasts.

Frequently Asked Questions

Can I use my WhatsApp Business App number?
Yes. With the QR method you link the number you already use, the same way WhatsApp Web works, and you keep using the app on your phone. For the Cloud API, you connect a number through Meta's sign-up steps.
Do I need Meta approval?
Not for the QR method. The Cloud API needs a Meta Business account, and Meta must approve your message templates before you can use them.
Which method should I use for broadcasts?
The Cloud API. Sending bulk messages over the QR method can get your number banned by WhatsApp, so use QR for replies and auto-replies to people who message you.
WhatsApp Guide - BeeCastly Documentation | BeeCastly