Yapay Zeka Destekli bir WhatsApp Chatbot Oluşturmak: Adım Adım Kılavuz

Yayınlanan: 2024-03-22
AI/ML 9 dakika 4
22 Mart 2024

Özet:

Node.js ve OpenAI'nin yeteneklerinden yararlanarak, adım adım yapay zeka destekli bir WhatsApp sohbet robotu oluşturmayı öğrenin. Bu kılavuz, bir Meta işletme hesabı oluşturmaktan WhatsApp API ve OpenAI'yi entegre etmeye kadar, işletmelerin müşteri etkileşimlerini kolaylaştırmasına ve otomatik iletişimde yeni olanakların kilidini açmasına yardımcı olur.

Günümüzün dijital çağında, müşteri etkileşimlerini geliştirmek için yapay zekanın (AI) gücünden yararlanmak, pazarda önde olmaya çalışan işletmeler için çok önemlidir. Dünya çapında en yaygın kullanılan mesajlaşma platformlarından biri olan WhatsApp, işletmelerin hedef kitleleriyle etkili bir şekilde etkileşim kurması için önemli bir fırsat sunuyor. Yapay zeka destekli WhatsApp sohbet robotlarının dünyasına girin. Bu sanal asistanlar müşteri hizmetlerinde devrim yaratıyor, 24 saat destek sağlıyor ve iletişim süreçlerini kolaylaştırıyor.

İster yeni gelişen bir girişim olun ister köklü bir kuruluş olun, gelişim adımlarında gezinmek doğru yaklaşımla daha kolay hale getirilebilir. Bu kapsamlı kılavuzda, WhatsApp Business API'yi Node.js uygulamanıza entegre etmek için gerekli temel ilkeleri, adım adım prosedürleri ve önemli hususları inceleyeceğiz. OpenAI'nin doğal dil işleme yeteneklerinin gücünden yararlanarak hedef kitlenizde yankı uyandıran kusursuz bir kullanıcı deneyimi yaratacağız.

WhatsApp Business hesabınızın kurulumundan OpenAI'nin API'sini Node.js kodunuzla entegre etmeye kadar, süreci aydınlatırken ve kendi yapay zeka odaklı çözümünüzü oluşturmanız için sizi güçlendirirken takip edin. Yapay zeka destekli sohbet aracılarının diyarına yapılan bu dönüştürücü yolculuk, tek başınıza yapmanız gereken bir yolculuk değil. Bir AI Chatbot Geliştirme Şirketi , yol boyunca paha biçilmez bilgiler ve uzmanlık sağlayarak güvenilir ortağınız olarak hizmet verebilir. Bu heyecan verici yolculuğa birlikte çıkalım.

1. Adım: Meta (Facebook) İşletme Hesabını ve Uygulamasını Ayarlama

  1. Öncelikle bir Meta işletme hesabı oluşturun (buraya tıklayın).

Ayrıntıları doldurun ve Gönder'e tıklayın.

2. Yeni bir Meta (Facebook) Uygulaması oluşturun (buraya tıklayın).

  • Meta (Facebook) Geliştirici Hesabınıza (giriş yapın).

Giriş yaptıktan sonra “Uygulamalarım”a tıklayın

uygulamama tıkla

3. Şimdi “uygulama oluştur”a tıklayın

4. “Diğer”i seçin ve “ileri”ye tıklayın.

5. Uygulama Türünü seçin: “İşletme” ve “İleri”ye tıklayın.

6. Uygulama ayrıntılarını sağlayın ve "Uygulama Oluştur"a tıklayın

Adım 2: WhatsApp Entegrasyonu için Meta (Facebook) Uygulamasını Ayarlama

1. WhatsApp'ı Meta (Facebook) Uygulamanıza ekleyin.

  • "Geliştirici Kontrol Paneli"nde uygulamanızı seçin.
  • Uygulamanızın kontrol paneli sekmesinde "Uygulamanıza ürün ekleyin" seçeneğini bulun.
  • Kurulum için “WhatsApp”ı seçin.
  • Meta (Facebook) İşletme Hesabınızı seçin
  • Kenar çubuğundan Uygulama ayarları > Temel'e gidin
  • Değişiklikleri Kaydet.
  • Uygulama Modunu Canlı olarak ayarlayın

3. Adım: WhatsApp Jetonu Oluşturun

Kalıcı bir WhatsApp Erişim Jetonu elde etmek için 1 ila 3 adımı izleyin:

1. Bir “Sistem Kullanıcısı” oluşturun:

  • Meta Business Suite'i ziyaret edin.
  • Sol üstteki açılır menüden işletme hesabınızı bulun ve Ayarlar (dişli) simgesini tıklayın.
  • İşletme Ayarları'nı tıklayın.
  • Kullanıcılar > Sistem kullanıcıları'na gidin.
  • Bir Yönetici sistemi kullanıcısı ekleyin.

2. Varlıkları Ekleyin.

  • Sistem kullanıcısını oluşturduktan sonra Varlık Ekle seçeneğine tıklayın.
  • Uygulamalar > “Uygulama adınız” seçeneğine gidin.
  • Uygulamanızı seçin ve uygulamayı yönetmek için tam kontrol verin.

3. Sistem Kullanıcı Erişim Belirteçlerini oluşturun.

  • Sistem kullanıcısı üzerinde Yeni Belirteç Oluştur düğmesine tıklayın.

Belirteci kullanacak uygulamayı seçin ve belirtecin son kullanma tarihini hiçbir zaman olarak ayarlayın.

  • “Whatsapp_business_messaging” ve “whatsapp_business_management” izinlerini seçin.
  • Belirteci oluşturun.
  • Erişim belirtecini kopyalayın ve güvenli bir şekilde saklayın.

4. WhatsApp için yeni bir İşletme Numarası ekleyin

  • WhatsApp sohbet robotunuz için kendi işletme numaranızı kullanabilir veya verilen test numarasını kullanabilirsiniz.
  • WhatsApp Geliştirici Kontrol Panelinde kenar çubuğundan WhatsApp > API Kurulumu'na gidin.
  • "5. Adım: Telefon Numarası Ekleme" adımına ilerleyin ve Telefon numarası ekle'yi tıklayın.
  • Aşağıdaki formda gerekli ayrıntıları sağlayın.
  • Alınan kodu kullanarak numaranızı doğrulayın.
  • Başarıyla eklendikten sonra API Kurulumunun 1. Adımında telefon numaranızı seçin.

5. Ödeme Yöntemi Ekleyin

  • WhatsApp aracılığıyla mesaj göndermek için geçerli bir ödeme yöntemine ihtiyacınız vardır. Ayrıntılar için burayı ziyaret edin.
  • İşletme telefon numaranızı ekledikten sonra, "Geçerli ödeme yöntemi eksik" uyarısını gidermek için "Ödeme yöntemi ekle"yi tıklayın.
  • WhatsApp hesap ayarlarınıza yönlendirileceksiniz. “Ödeme Yöntemleri” > “İşletme ödeme yöntemi ekle”yi tıklayın ve kart bilgilerinizi eklemek için talimatları izleyin.

6. WhatsApp için yeni İşletme Numaranızı test edin

  • WhatsApp Geliştirici Kontrol Paneline dönün, API Kurulumuna gidin
  • Bir test "Kime" numarası girin.
  • Başarılı mesaj teslimini doğrulamak için “Mesaj gönder”e tıklayın.

4. Adım: WhatsApp API Webhook ayarlarını yapılandırın

1. WhatsApp Webhook Geri Aramasını doğrulayın.

  • WhatsApp Geliştirici Kontrol Panelinde Yapılandırma'ya gidin.
  • Webhook'un altında düzenle'yi tıklayın
  • Şimdi WhatsApp'a canlı bir webhook URL'si ve belirteci sağlamamız gerekiyor. Canlı URL, uygulamanızın URL'sidir ve belirteç de sizin tarafınızdan oluşturulur. Aşağıdaki resimde Node.js uygulamam Ngrok üzerinde çalıştığı için Ngrok URL'mi ekledim ve belirteç olarak UUID kullandım.
  • Doğrulama sürecinde WhatsApp, hub belirtecini doğrulamak için geri arama URL'sine bir GET isteği gönderir. Next.js'de (Node.js çerçevesi) yazılan aşağıdaki kod, bu doğrulama sürecini yönetir. Doğrulama yalnızca kodunuz aşağıda gösterildiği gibi yanıt olarak 200 durum kodu gönderirse başarılı olacaktır.
eşzamansız dışa aktarma işlevi GET(req: NextRequest) {

let hubMode = req.nextUrl.searchParams.get("hub.mode");

let hubChallenge = req.nextUrl.searchParams.get("hub.challenge");

let hubToken = req.nextUrl.searchParams.get("hub.verify_token");

//veritabanındaki tokenı bul

eğer (

hubMode === "abone ol" &&

hubToken === "<.env'den VEYA veritabanından gelen değer>"

) {

console.log("başarıyla doğrulandı");

yeni Yanıt döndür (hubChallenge);

}

return new Response("Geçersiz Kimlik Bilgileri", { durum: 400 });

}

  • “Mesajlar” alanını bulun ve kutuyu işaretleyerek bu alana abone olun.
  • Artık aynı WhatsApp işletme hesabından aldığımız WhatsApp Erişim jetonuna ve Facebook uygulama sırrına ihtiyacımız var.
  • Aşağıdaki resimde Facebook uygulamasının salgılandığını görüyorsunuz

ayrıca aşağıdaki vurgulanan verileri saklamamız gerekiyor

Kodumuzda erişim belirteci, uygulama sırrı, test numarası, telefon numarası kimliği ve işletme hesabı kimliği gibi çeşitli tanımlayıcılara ihtiyacımız var. Bu tanımlayıcılar kimden mesaj aldığımızı ve kime mesaj göndermemiz gerektiğini belirlememize yardımcı olur.

Adım 5: API aracılığıyla mesaj gönderme ve alma

  • Sağlanan TypeScript kodunda, mesaj göndermek ve almak için WhatsApp API'sini başarıyla entegre ettik. Ayrıca hedefim doğrultusunda, gelen mesajlara yanıt vermek için OpenAI'yi ve özel olarak eğitilmiş bir yapay zeka modelini de dahil ettim.
  • WhatsApp'a sağlanan geri arama URL'si hem GET hem de POST istekleri için kullanılır. İşletme numarasına bir mesaj gönderildiğinde, WhatsApp bu geri arama URL'sini tetikler ve mesajı kullanıcı ayrıntılarıyla birlikte gönderir. Aşağıdaki kod bu mesajı okur ve uygulanan mantığa göre yanıt verir.
  • POST işlevi, gelen POST isteklerini işleyen eşzamansız bir işlevdir. Öncelikle gelen isteği JSON'a ayrıştırır ve kullanıcının gönderdiği mesajı WhatsApp'tan çıkarır. Mesaj tanımsız veya boş ise 200 statüsünde bir yanıt döndürür ve daha fazla ilerlemez.
  • İşlev daha sonra istekten iş telefon numarasını ve gönderenin telefon numarasını alır.
  • İşlev daha sonra kullanıcıya WhatsApp aracılığıyla bir mesaj göndermek için bir POST isteği hazırlar. İsteğin URL'sini oluşturur, gönderilecek mesajı tanımlar ve yöntem, başlıklar ve gövde dahil olmak üzere istek seçeneklerini ayarlar.
  • İşlev daha sonra fetch işlevini kullanarak isteği gönderir. İstek başarılı olursa 200 statüsünde bir yanıt döndürür. Herhangi bir noktada bir hata oluşursa konsola kaydedilir.
  • getResponseNumber işlevi, gönderenin telefon numarasını gelen istekten çıkaran bir yardımcı işlevdir.
  • Bu kod, bir Node.js uygulamasının WhatsApp Business API ile nasıl entegre edileceğine ve mesajların otomatik olarak gönderilip alınmasına olanak tanıyan temel bir örnek sağlar.

// Kullanıcı bota soru sorduğunda ve ayrıca kullanıcıya yanıt verdiğinde WhatsApp bu gönderi isteğini tetikleyecektir

eşzamansız işlevi dışa aktar POST(req: NextRequest) {

let res: any = wait req.json();

izin verWhatsapp'tan soru =

res?.giriş?.[0]?.değişiklikler?.[0]?.değer?.mesajlar?.[0]?.metin?.gövde; // whatsapp'tan soru alındı

eğer (

soruWhatsapp'tan == tanımsız ||

soruFromWhatsapp.trim().uzunluk <= 0

) {

//eğer istek sadece durumla ilgiliyse daha fazla ilerlemeyin

// NextResponse.json'u döndür({ message: "received" });

return new Response("alındı", { durum: 200 });

}

//yanıttan telefon numarası kimliğini alın. bu telefon numarası iş numarasıdır

const telefonNumberId =

res?.giriş?.[0]?.değişiklikler?.[0]?.değer?.metadata["telefon_numarası_id"];

//bu yöntem mesajın alındığı telefon numarasını döndürecektir

const yanıtNumber = getResponseNumber(res);

// kullanıcı kimliğini veritabanından alıyoruz

denemek {

const sürümü = "v18.0";

//limitlere ulaşılıp ulaşılmadığını kontrol ediyoruz

const telefonNumarası;

const alıcıPhoneNumber = "+" + ResponseNumber;

// const erişimToken = proses.env.WHATSAPPTOKEN

const erişimToken = "facebook'tan aldığınız jeton";

denemek {

//--------------- Bu kod telegrama mesaj göndermek içindir

const url = `https://graph.facebook.com/${version}/${phoneNumberId}/messages`;

// İstek gövdesinde gönderilecek verileri tanımlayın

sabit veri = {

mesajlaşma_ürün: "whatsapp",

alıcı_türü: "bireysel",

alıcıya: `${recipientPhoneNumber}`,

Metin yaz",

metin: {

önizleme_url: yanlış,

body: "Merhaba, ben bir chatbot'um, şu anda meşgulüm, yakında sana geri döneceğim.",

},

};

// Getirme isteği için seçenekleri tanımlayın

sabit seçenekler = {

yöntem: "POST",

başlıklar: {

"İçerik Türü": "uygulama/json",

Yetkilendirme: `Taşıyıcı ${accessToken}`,

},

gövde: JSON.stringify(veri),

};

// fetch kullanarak POST isteğini gerçekleştirin

denemek {

const yanıt = getirmeyi bekliyor(url, seçenekler);

if (!yanıt.ok) {

throw new Error(`HTTP hatası! Durum: ${response.status}`);

}

const veri = yanıt bekliyor.json();

// Verileri gerektiği gibi işleyin

} yakalamak (hata) {

// Hatayı gerektiği gibi ele alın

console.log(hata);

}

return new Response("alındı", { durum: 200 });

} yakalamak (hata) {

console.log("hata", hata);

}

} catch (hata: herhangi biri) {

console.log(hata);

//hatanın ele alınması durumunda veritabanındaki hata günlüğünü koruyun

}

}

const getResponseNumber = (res: herhangi biri) => {

dönüş res?.giriş?.[0]?.değişiklikler?.[0]?.değer?.kişiler[0]?.wa_id;

};

Çözüm

Bu kapsamlı kılavuzda, WhatsApp Business API'yi Node.js uygulamasıyla entegre etmenin inceliklerini anlattık. Web kancalarını ayarlamaktan gelen mesajları işlemeye ve özel yanıtlar göndermeye kadar erişim belirteçlerini, uygulama sırlarını, test numaralarını, telefon numarası kimliklerini ve işletme hesabı kimliklerini yönetme gibi temel adımları ele aldık.

Bu kusursuz entegrasyon, işletmelere yalnızca WhatsApp üzerinden iletişimi otomatikleştirme olanağı vermekle kalmıyor, aynı zamanda ister müşteri destek botları oluşturmak, pazarlama çabalarını otomatikleştirmek veya kişisel projeleri takip etmek olsun, sayısız olasılığın kilidini açıyor. Bu yolculuğa çıkarken bunun yalnızca bir temel olduğunu unutmayın. WhatsApp Business API, keşfedilmeyi ve uygulamanıza entegre edilmeyi bekleyen çok sayıda ek özellik sunar.

Yapay zeka sohbet robotu geliştirme çabalarınızı geliştirmeye devam ederken, bir uzmanın uzmanlığından yararlanmayı düşünün. AI Chatbot Geliştirme Şirketi . Onların içgörüleri ve desteği, ilerlemenizi hızlandırabilir ve chatbot çabalarınızın tam potansiyeline ulaşmasını sağlayabilir. Geliştirme yolculuğunuzda ilerledikçe kapsamlı ve doğru bilgiler için her zaman resmi WhatsApp Business API belgelerine bakın.