İçeriğe geç
HelloDesk Dokümantasyon

WhatsApp Business hesabını bağlama

Bu rehber, otelinizin WhatsApp Business numarasını HelloDesk’e bağlamayı anlatır. Bağlantı tamamlandığında misafirlerinizin WhatsApp’tan yazdığı mesajları yapay zeka asistanınız karşılar, gerektiğinde ekibinize devreder.

Başlamadan önce Meta’dan almanız gerekenler

Bölüm başlığı “Başlamadan önce Meta’dan almanız gerekenler”

HelloDesk, WhatsApp’a Meta’nın resmi Cloud API’si üzerinden bağlanır. Bu yüzden önce Meta tarafında bir kurulum gerekir:

Bilgi Nereden alınır Not
Erişim anahtarı (Access Token) Meta Business → System Users → kalıcı token üretin whatsapp_business_management ve whatsapp_business_messaging izinleri gerekir
Uygulama sırrı (App Secret) Meta App Dashboard → App Settings → Basic Gelen webhook imzalarını doğrulamak için kullanılır
WABA ID Meta Business Suite → WhatsApp Manager → API Setup WhatsApp Business Account kimliğidir
Kayıtlı bir telefon numarası Aynı WABA altında tanımlı olmalı Numaranın kendisi değil, Meta’daki phone_number_id değeri kullanılır

Verify Token’ı Meta’dan almazsınız — onu siz belirlersiniz. Tahmin edilmesi zor bir metin seçin (örneğin bir parola üreticiden); aynı metni hem HelloDesk’e hem Meta’ya gireceksiniz.

Sihirbazla bağlama (önerilen)

Bölüm başlığı “Sihirbazla bağlama (önerilen)”

Kanallar → WhatsApp sayfasını açın ve sağ üstteki “Sihirbazla bağla” düğmesine tıklayın. Sihirbaz dört adımdan oluşur.

1. Kimlik Bilgileri

Bölüm başlığı “1. Kimlik Bilgileri”

Meta’dan aldığınız değerleri girin:

  • Görünen ad — isteğe bağlı, hesabı listede tanımanız için (örn. “Grand Hotel Meta Uygulaması”)
  • Graph API sürümü — hazır olarak v20.0 gelir, değiştirmenize genelde gerek yoktur
  • WhatsApp Business Account ID (WABA ID) — zorunlu
  • Erişim anahtarı — zorunlu
  • Uygulama sırrı — zorunlu
  • Webhook doğrulama anahtarı — zorunlu, kendi belirlediğiniz gizli metin

Dördü de dolmadan “Numaraları keşfet” düğmesi aktifleşmez.

2. Keşfet

Bölüm başlığı “2. Keşfet”

HelloDesk, girdiğiniz token ile Meta’ya bağlanır ve WABA’nız altındaki telefon numaralarını listeler. Bu adımda hiçbir şey kaydedilmez, sadece doğrulama yapılır.

Bu adımda hata alırsanız:

Hata Anlamı Çözüm
HTTP 401 Token geçersiz veya süresi dolmuş Yeni bir kalıcı token üretin
HTTP 400 WABA ID yanlış veya token’ın yetkisi yok WABA ID’yi kontrol edin, token izinlerini gözden geçirin
“Bu WABA altında telefon numarası bulunamadı” WABA’da kayıtlı numara yok Meta’da numarayı WABA’ya ekleyip doğrulayın

3. Seç

Bölüm başlığı “3. Seç”

Keşfedilen numaralardan birini seçin. Tek numara varsa otomatik seçilir.

  • Görünen numara — Meta’dan gelen numarayla dolu gelir, misafire görünen numaradır
  • Ajan — mesajları karşılayacak yapay zeka asistanı
  • Tesis için varsayılan — açık gelir
  • Aktif — açık gelir

“Kaydet ve devam et” dediğinizde hesap ve numara kaydedilir.

Numara başka bir yerde zaten tanımlıysa “Bu WhatsApp numarası zaten atanmış” hatası alırsınız — aynı phone_number_id iki yere bağlanamaz.

4. Webhook

Bölüm başlığı “4. Webhook”

Son adımda iki değer üretilir. Bunları Meta’ya yapıştırmadan gelen mesajlar HelloDesk’e ulaşmaz:

  1. Callback URL — şu biçimdedir: 
    https://<api-adresiniz>/api/whatsapp/webhook?hotel_id=<otel-kimliğiniz>
    Sondaki ?hotel_id=... kısmı URL’nin parçasıdır, kesmeyin.
  2. Verify Token — 1. adımda girdiğiniz metnin aynısı.

Meta App Dashboard’da WhatsApp → Configuration sayfasını açın, bu iki değeri ilgili alanlara yapıştırın ve doğrulayın. Ardından messages webhook alanına abone olun.

Doğrulama sırasında Meta, token’ı HelloDesk’e sorar. Değerler birebir aynı değilse Meta “Verification failed” hatası gösterir; iki tarafta da boşluk/karakter farkı olmadığından emin olun.

Elle bağlama

Bölüm başlığı “Elle bağlama”

Sihirbaz yerine hesabı elle de ekleyebilirsiniz. Alanlar aynıdır: hesap için Görünen ad, Graph API sürümü, WABA ID, Erişim anahtarı, Uygulama sırrı, Webhook doğrulama anahtarı, Aktif. Numara için Hesap, Ajan, phone_number_id, Görünen numara, Tesis için varsayılan, Aktif.

Hesabı ekledikten sonra satırdaki “Anahtarı doğrula” düğmesiyle token’ın geçerli olduğunu test edebilirsiniz. Satırda ayrıca son sağlıklı kontrol zamanı veya son hata mesajı gösterilir.

Şablon mesajlar ve 24 saat kuralı

Bölüm başlığı “Şablon mesajlar ve 24 saat kuralı”

WhatsApp’ta misafire ne zaman serbest metin yazabileceğinizi Meta belirler:

  • Misafir size yazdığı anda 24 saatlik servis penceresi açılır. Bu süre içinde ekibiniz serbestçe cevap yazabilir.
  • Pencere kapandıktan sonra serbest metin gönderilemez; HelloDesk bu denemeyi engeller ve sizi şablon kullanmaya yönlendirir.
  • Yeniden iletişim kurmak için Meta onaylı bir şablon mesajı göndermeniz gerekir.

Şablon oluşturma

Bölüm başlığı “Şablon oluşturma”

Mesaj Şablonları bölümünden bir hesap seçin. Liste her açılışta Meta ile otomatik senkronize olur — ayrı bir yenileme düğmesine gerek yoktur.

Yeni şablon için: Şablon adı, Dil (varsayılan en), Kategori (varsayılan MARKETING) ve Bileşenler (JSON) alanlarını doldurup “Şablon oluştur” deyin. Şablonun onay durumu (PENDING, APPROVED, REJECTED gibi) Meta tarafından belirlenir ve satırda rozet olarak görünür. Yalnızca APPROVED olan şablonlar gönderilebilir.

“Test gönder” ile bir alıcı numara ve gönderen numara seçip şablonu deneyebilirsiniz.

Varsayılan şablon

Bölüm başlığı “Varsayılan şablon”

Her numara satırında bir varsayılan şablon seçebilirsiniz. Proaktif bir mesaj gönderilirken şablon adı belirtilmezse bu şablon kullanılır. Varsayılan şablon tanımlı değilse ve şablon adı da verilmezse gönderim hata verir.

Bağlantıyı doğrulama

Bölüm başlığı “Bağlantıyı doğrulama”

Kurulum bittikten sonra kendi telefonunuzdan otelin WhatsApp numarasına bir mesaj atın. Beklenen sonuç:

  1. Asistan birkaç saniye içinde yanıt verir.
  2. Mesaj Gelen Kutusu → Konuşmalar ekranında WhatsApp kanalı altında görünür.

Yanıt gelmiyorsa Sorun giderme sayfasındaki WhatsApp bölümüne bakın.