Dia ERP Whatsapp Entegrasyonu
1- İşletme Portfolyosu Oluşturma
https://business.facebook.com/business/loginpage/ bağlantısı ile giriş sayfası açılır. Facebook ile Giriş Yap butonuna tıklanır ve en az 1 saat önce oluşturulmuş Facebook hesabı bilgileri ile giriş yapılır.
İşletme portfolyosu oluşturmak için ekrandaki bilgiler doldurulur ve Gönder butonuna tıklanır ve E-Posta adresine gelen bağlantı doğrulanır.
2- Developers Hesabı Oluşturma
https://developers.facebook.com/async/registration/ bağlantısı ile giriş sayfası açılır. Developers hesabı oluşturmak için; işletme portfolyosu oluşturma sırasında kullanılan Facebook hesabı bilgileri ile giriş yapılır.
Açılan sayfadaki bilgiler doldurulduktan sonra Complete Registration butonuna tıklanır.
3- App Oluşturma
https://developers.facebook.com/apps/ sayfasında Create App butonuna tıklanır ve app oluşturmak için gerekli bilgiler doldurulur.
Business Portfolio alanından oluşturulan İşletme Portfolyosu seçilir ve Create App butonu aracılığıyla app oluşturma işlemi gerçekleştirilir.
4- App Kurulum
https://developers.facebook.com/apps/ sayfasında oluşturulan app gözükecektir. Oluşturulan app’e tıklanır ve ilgili app arayüzü açılır.
Açılan sayfadaki yan menüde Whatsapp -> API Setup ile API Setup sayfası açılır ve oluşturulan işletme portfolyosu seçili şekilde Continue butonuna tıklanır ve ilgili bilgiler doldurulur.
5- İşletme Hesabı Doğrulama
App arayüzündeyken yan menüdeki App settings -> Basic ile app bilgilerinin olduğu sayfa açılır. Açılan sayfadaki Verifications alanındaki Start Verification butonuna tıklanır.
Açılan sayfada İşletme Doğrulaması altındaki Doğrulamayı Başlat butonuna tıklanır.
İlgili ekranda Başla butonuna tıklanır ve gerekli işletme bilgileri doldurularak işletme doğrulaması talebi oluşturulur. Talep, Meta tarafından onaylandıktan sonra işleme devam edilebilir.
6- Telefon Numarası Ekleme
Kurulum sonrasında API SETUP sayfasından Add phone number butonuna tıklanarak telefon numarası eklenir.
https://business.facebook.com/latest/settings/whatsapp_account bağlantısı ile WhatsApp Hesapları sayfası açılır. Açılan sayfada ilgili hesap için ödeme bilgisi girilir.
7- DİA’ya WhatsApp Entegrasyon Tanımı Ekleme
https://developers.facebook.com/apps/ bağlantısı ile oluşturulan app içerisine giriş yapılır ve açılan sayfadaki yan menüde Whatsapp -> API Setup ile API Setup ekranı görüntülenir. İlgili ekranın sol üstünde App ID, orta alanda ise Access Token, Phone number ID ve WhatsApp Business Account ID bilgileri bulunur.
Yan menüde App settings -> Basic sayfası açılır. Açılan sayfada Show butonu ile facebook hesap doğrulaması yapılarak App secret bilgisi görüntülenir.
DİA içerisinde [SİS3900] ile WhatsApp Entegrasyon Tanımı Listesi ekranı görüntülenir. Ekle butonu aracılığıyla [SİS3901] WhatsApp Entegrasyon Tanım Ekle sayfası açılır ve gerekli bilgiler META’dan alınarak doldurulur. Sonrasında WhatsApp Entegrasyon bilgisi kaydedilir. META’dan alınan access tokenın geçerlilik süresi 1 saattir. Bu tokenın süresi DİA’ya kaydedildikten sonra 60 güne uzatılır ve 60 günde bir buradaki tokenın META’dan alınarak yenilenmesi gerekmektedir. META, güvenlik nedeni ile bu işlemi zorunlu kılmaktadır.
Kaydedilen WhatsApp Entegrasyon Tanımı değiştir/incele ile açıldığında ilgili entegrasyona ait kalan erişim süresi bilgileri META’dan sorgulanarak [SİS3901] ekranında görüntülenmektedir.
8- Mesaj Şablonu Oluşturma
https://business.facebook.com/latest/whatsapp_manager/message_templates adresi ile Mesaj Şablonları sayfası açılır. İlgili sayfaya app arayüzündeyken yan menüden WhatsApp -> Quickstart ile açılan sayfadaki Message templates butonu aracılığıyla da erişilebilir.
Şablon oluştur butonuna tıklanarak şablon oluşturma sayfası açılır.
Metin mesajı için; şablon içerisinde tanımlanan değişkenlere süreç içerisinden metin setlemek mümkündür. Metin mesajı şablonlarında {{1}}, {{2}}, {{3}} … şeklinde 10 adet değişken kullanılabilir.
Dosya mesajı için; başlık bilgisi Belge seçilmelidir. Bu şablon kullanıldığı durumda sistem başlıktaki belge alanına süreç içerisinden gönderilen dosyayı yükleyecektir. Dosya ile birlikte aynı zamanda metin mesajı da gönderilebilir, metin alanında 1 adet değişken kullanılabilmektedir.
Gerekli tüm bilgiler doldurulduktan sonra Değerlendirmeye Gönder butonuna basılır. Şablon onaylanmadan önce Meta tarafında değerlendirme sürecinden geçecektir. Değerlendirme süreci zaman alabilmektedir. İlgili şablon, değerlendirme süreci tamamlandıktan ve şablon durumu aktif olduktan sonra mesajlarda kullanılabilecektir.
9- Webhook Callback URL Tanımı
İlk olarak DİA İstemci içerisinde başlatma türü Webhook olan bir süreç oluşturulur. Oluşturulan bu sürecin Callback URL ve Token alanlarına veri girişi yapılır.
Buraya girilen değerlerin ne olduğunun bir önemi bulunmamakla beraber META’daki konfigürasyon alanında girilecek değerler ile eşleşmesi gerekmektedir.
Örneğin Callback URL alanına “whdestek”, Token alanına ise “token312” yazdığımızı varsayarak ilerleyelim.
https://developers.facebook.com/apps/ bağlantısı ile oluşturulan app içerisine giriş yapılır ve açılan sayfadaki yan menüde Whatsapp -> Configuration ile Configuration ekranı görüntülenir. İlgili ekranın Webhook kısmındaki Callback URL alanına “https://sunucuismi.ws.dia.com.tr/flw/webhook/whdestek” (sunucuismi = entegrasyon yapılacak sunucu); token alanına ise token312 girişi yapılır. Verify and ave butonuna basarak Callback URL Tanımı yapılır.
Callback URL tanımı yaptıktan sonra aynı sayfanın alt bölümündeki messages aracına ‘subscribe’ olunur.
Artık “https://sunucuismi.ws.dia.com.tr/flw/webhook/whdestek” adresinin Callback URL olarak tanımlandığı app içerisinde kayıtlı telefon numarasına WhatsApp üzerinden gelen her yeni mesajda, “sunucuismi” sunucusunda başlatma türü Webhook ve Callback URL’i whdestek olan süreç çalışacaktır.
Webhook ile gelen veri süreç içerisinde [WHDATA] değişkeni ile kullanılabilmektedir. Gelen data içerisinde mesajı kimin gönderdiği, mesajın içeriği ve zamanı gibi çeşitli bilgilere ulaşılmaktadır.
İlgili telefon numarasına bir dosya mesajı geldiği durumda [WHDATA] içerisinde gelen dosyanın media id bilgisi bulunmaktadır. Bu id bilgisi ile WhatsApp aracının “Medya Getir” aksiyonu kullanılabilir ve ilgili dosya byte tipinde alınarak sonuç değişkenine yazılabilir.
