Ana içeriğe geç

WhatsApp Meta Entegrasyonu

Müşterilerinizin her gün kullandıkları mesajlaşma platformu olan WhatsApp'ı kullanarak otomasyon süreçlerinizle etkileşime girmelerini ve anında yanıt almalarını kolaylaştırmak için Automind Agentflow, Meta'nın Business API'si aracılığıyla WhatsApp ile sorunsuz entegrasyon sağlar. Bu, müşterilerin doğrudan WhatsApp içinde otomasyon ajanınızla sohbet başlatmalarını mümkün kılar.

Automind Agentflow platformu, güçlü mesajlaşma yetenekleri ve kurumsal sınıf özellikler sunan Meta'nın doğrudan entegrasyonu aracılığıyla WhatsApp entegrasyonu sağlar.

Önemli: Hoş geldin akışı kullanıcının bot ile ilk sohbetinde tetiklenecektir; sohbeti başlatan ilk kullanıcı mesajı normal şekilde işlenecektir.

Ön Koşullar​

Automind Agentflow'u Meta aracılığıyla WhatsApp ile entegre etmeden önce, aşağıdakilere sahip olduğunuzdan emin olun:

  • Oluşturulmuş ve yayınlanmış bir Automind Agentflow botu
  • Uygun izinlere sahip bir Meta Developer hesabı
  • Bir WhatsApp Business hesabı
  • Şirket içi dağıtımlar için, gerekli mesajlaşma uç noktalarına/uç noktalarından erişim sağlandığından emin olun:
YönUç Nokta
Gidengraph.facebook.com
GelenAutomind Agentflow domain'iniz

Adım 1: Meta Developer Uygulaması Oluşturma​

Not: Meta UI'ı kullandığınız sürüme bağlı olarak biraz farklı görünebilir.

İpucu: WhatsApp için yapılandırılmış bir Meta uygulamanız zaten varsa, bu adımı atlayın ve Adım 2'ye gidin.

Yeni Meta Uygulaması Oluşturma​

  1. Meta for Developers'a Erişim

  2. Uygulama Oluşturmaya Başlama

    • Araç çubuğunda My Apps'a tıklayın
    • Your Apps sayfası görünecektir
    • Create App düğmesine tıklayın

  3. Uygulama Detaylarını Yapılandırma

    • Create an app sihirbazı görünecektir
    • App name ve iletişim e-posta adresinizi girin
    • Bu e-posta Meta tarafından uygulamanız hakkında sizinle iletişim kurmak için kullanılacaktır

  4. Uygulama Yapılandırmasını Seçme

    • Devam etmek için Next'e tıklayın
    • Kullanım durumu olarak Other'ı seçin ve Next'e tıklayın
    • Uygulama türü olarak Business'ı seçin ve Next'e tıklayın

  5. Uygulama Oluşturmayı Tamamlama

    • Açılır menüden Business portfolio'nuzu seçin
    • Oluşturmayı tamamlamak için Create app'a tıklayın

  6. Güvenlik Doğrulama

    • Güvenlik nedenleriyle istendiğinde şifrenizi yeniden girin
    • Kimliğinizi doğrulamak için Submit'e tıklayın

WhatsApp Entegrasyonunu Yapılandırma​

  1. WhatsApp Ürününü Ekleme

    • Uygulama kontrol panelinizde WhatsApp ürününü bulun
    • WhatsApp yapılandırmasını başlatmak için Set up'a tıklayın
    • WhatsApp Quickstart sayfası görünecektir

  2. İlk Erişim Token'ı Oluşturma

    • Mesaj göndermeyi test etmek için Start using the API'ye tıklayın
    • Generate access token düğmesine tıklayın
    • WhatsApp hesabınızı yönetmek için uygulamaya erişim vermek üzere ekrandaki talimatları izleyin

  3. Mesaj Fonksiyonunu Test Etme

    • From alanında test telefon numaranızı seçin
    • To alanına alıcı telefon numarasını girin
    • Numaranın doğru olduğundan emin olun çünkü test alıcılarınız listesine eklenecektir
    • Entegrasyonu test etmek için Send message'a tıklayın

Not: Üretim için hazır olduğunuzda, kullanıcılara mesaj göndermek için kayıtlı işletme telefon numaranızı kullanmanız gerekecektir.

Not: Test telefon numaraları 5 alıcıyla sınırlıdır. Üretim telefon numaralarının bu sınırlaması yoktur.

Adım 2: Uygulamanız İçin Kalıcı Token Oluşturma​

Kalıcı bir erişim token'ı oluşturmak için Business Manager'da uygun izinlere sahip bir sistem kullanıcısı oluşturmanız gerekir.

Sistem Kullanıcısı Oluşturma​

  1. Business Settings'e Erişim

  2. Yeni Sistem Kullanıcısı Ekleme

    • System users sayfasında Add düğmesine tıklayın
    • Sistem kullanıcısı için açıklayıcı bir ad girin
    • System user role açılır menüsünden Admin'i seçin
    • Create system user'a tıklayın

Varlık Atama ve Token Oluşturma​

  1. Uygulama Varlıklarını Atama

    • Sağ üst köşedeki eylemler simgesine (üç nokta) tıklayın
    • Assign assets'i seçin
    • Meta uygulamanızı seçin ve Full Control izinleri verin

  2. WhatsApp Hesabını Atama

    • WhatsApp accounts sekmesine tıklayın
    • WhatsApp Business hesabınızı seçin
    • WhatsApp hesabını yönetmek için kullanıcıya Full Control izinleri verin
    • Assign assets'e tıklayın

  3. Kalıcı Token Oluşturma

    • Varlık atamalarını kaydetmek için Done'a tıklayın
    • Sağ üst köşedeki Generate token düğmesine tıklayın

  4. Token Ayarlarını Yapılandırma

    • Açılır menüden uygulamanızı seçin ve Next'e tıklayın
    • Token sona erme için Never'ı seçin ve Next'e tıklayın
    • İki WhatsApp iznini seçin:
      • WhatsApp Business Management
      • WhatsApp Business Messaging
    • Generate Token'a tıklayın

  5. Erişim Token'ını Kaydetme

    • Oluşturulan kalıcı erişim token'ını kopyalayın
    • Automind Agentflow yapılandırması için ihtiyacınız olacağından güvenli bir şekilde saklayın
    • İşlemi tamamlamak için Done'a tıklayın

Önemli: Token'ı yalnızca bir kez görüntüleyebilirsiniz. Her yeni sistem kullanıcısı için yeni oluşturulan bir token gerekir.

Adım 3: Automind Agentflow'da WhatsApp Kanalı Oluşturma​

Kanal Ayarlarını Yapılandırma​

  1. Kanal Oluşturma Erişimi

    • Automind Agentflow Portal'ınıza giriş yapın
    • Kenar çubuğu menüsünden Channels'a gidin
    • Yeni kanal oluşturmaya başlamak için Yeni düğmesine tıklayın

  2. Temel Bilgileri Yapılandırma

    • WhatsApp kanalınız için açıklayıcı bir Ad girin
    • Kanalın amacını açıklayan bir Açıklama sağlayın
    • Açılır menüden Ajanınızı seçin
    • Platform açılır menüsünden WhatsApp'ı seçin
    • Devam etmek için İleri'ye tıklayın

  3. WhatsApp Özel Ayarlarını Yapılandırma

    • Gizli WhatsApp Erişim Anahtarı: Meta uygulama secret'ınızı girin
      • Bunu almak için: Meta for Developers'a gidin
      • Uygulamanızı seçin ve Basic Settings'e gidin
      • App secret'ın yanındaki Show'a tıklayın
      • İstendiğinde Facebook şifrenizi girin
      • Gösterilen App secret'ı kopyalayın
    • Telefon Numarası Kimliği: WhatsApp Business telefon numaranızın kimliğini bu alana girin
    • Erişim Anahtarı: Adım 2'de oluşturulan kalıcı token'ı girin
    • API Versiyonu: Meta uygulamanızın API sürümünü girin (format: v##.#, örn., v15.0)
    • Devam etmek için İleri'ye tıklayın

  4. Kanal Kurulumunu Tamamlama

    • Webhook yapılandırması için son sayfada görüntülenen Çağırma URL'sini kopyalayın
    • Kurulumu tamamlamak için Kanal Oluştur'a tıklayın
    • Kanal oluşturulacak ve etkinleştirilecektir

Mevcut Bağlam Parametreleri​

Başarılı kanal etkinleştirmesinden sonra, Automind Agentflow bu kullanıcı bağlam parametrelerini sağlar:

  • [[ChatUser]].ChannelId = "meta-whatsapp"
  • [[ChatUser]].UserId - Kullanıcının telefon numarasını saklar
  • [[ChatUser]].ChannelBotIdentifier - Mesajların geldiği bot numarasını saklar
  • [[HelpdeskClient]].PhoneNumber - Canlı sohbet oturumları için kullanıcının telefon numarasını saklar
  1. Yapılandırmayı Kaydetme
    • WhatsApp kanal yapılandırmasını kaydetmek için Save & Close'a tıklayın

Adım 4: Webhook'ları Etkinleştirme​

Webhook'lar, Automind Agentflow'unuzda WhatsApp kullanıcılarından mesaj ve etkinlik almak için gereklidir.

Webhook Ayarlarını Yapılandırma​

  1. WhatsApp Yapılandırmasına Erişim

  2. Webhook URL ve Token'ını Ayarlama

    • Webhook bölümünde:
      • Callback URL: Adım 3'ten Automind Agentflow Callback URL'yi girin
      • Verify Token: Adım 3'te oluşturulan Webhook Verify Token'ı girin
    • Verify and save'e tıklayın

  3. Webhook Etkinliklerine Abone Olma

    • Doğrulamadan sonra webhook alanları görünecektir
    • Aşağıdaki temel etkinliklere abone olun:
      • messages - Kullanıcı mesajlarını alma
      • message_template_status_update - Mesaj şablonu durumunu takip etme

Entegrasyonu Tamamlama​

Webhook yapılandırması tamamlandığında, Automind Agentflow'unuzun Meta aracılığıyla WhatsApp entegrasyonu kullanıma hazırdır.

Not: Meta uygulaması yayınlanana kadar Development Mode'da kalır. API işlevselliği, uygulama herkese açık hale gelene kadar yalnızca yöneticiler, geliştiriciler ve test kullanıcıları için çalışır.

Sonraki Adımlar:

  • Meta uygulamanızı inceleme için gönderin
  • Başarılı inceleme sonrasında uygulamayı üretim kullanımı için herkese açık hale getirin

Adım 5: Birden Fazla Telefon Numarasını İlişkilendirme (İsteğe Bağlı)​

Not: Birden fazla telefon numarası desteği Automind Agentflow v8.3 veya üstünü gerektirir.

Kuruluşunuzun aynı otomasyon ajanıyla birden fazla WhatsApp numarası çalıştırması gerekiyorsa:

  1. Ek Numaralar Ekleme

    • WhatsApp Manager'a gidin
    • WhatsApp hesabınızın limitlerini artırın
    • Gerektiğinde yeni telefon numaraları ekleyin

  2. Numaraya Özel İş Akışlarını Yapılandırma

    • Her telefon numarası farklı sohbet akışlarına sahip olabilir
    • Sohbetleri uygun şekilde yönlendirmek için [[ChatUser]].ChannelBotIdentifier kullanın

Telefon numarası limitleri hakkında ayrıntılı bilgi için Meta'nın Telefon Numarası Limitleri belgelerine bakın.

Adım 6: Automind Agentflow'unuzu Kullanmaya Başlama​

Ajana Erişim​

  1. Doğrudan Test

    • Automind Agentflow Portal'da Bot Settings > Channels'a gidin
    • Doğrudan sohbet açmak için WhatsApp kanal simgesine tıklayın
    • Otomasyon iş akışlarınızı test etmeye başlayın

  2. Kullanıcı Etkileşimi

    • Kullanıcılar WhatsApp Business numaranızı bulabilir
    • Doğrudan WhatsApp'ta sohbet başlatabilirler
    • Ajan yapılandırılmış otomasyon iş akışlarına göre yanıt verecektir

Sohbet Yönetimi​

  • Otomatik Hoş Geldin: Kullanıcılar sohbet başlattığında, Hoş Geldin akışı otomatik olarak tetiklenir
  • Birden Fazla Numara: Birden fazla telefon numarası kullanıyorsanız, her biri benzersiz sohbet ID'leri oluşturur
  • Bağlam Korunması: Kullanıcı bağlamı ve sohbet geçmişi etkileşimler boyunca korunur

Not: Kullanıcılar aynı bot ile ilişkili birden fazla telefon numarasına mesaj gönderdiğinde, her numara için farklı sohbet ID'leri oluşturulur, böylece uygun sohbet takibi sağlanır.

Sesli Mesaj Desteği​

Automind Agentflow, Microsoft Cognitive Services ve ElevenLabs entegrasyonu aracılığıyla sesli mesaj işlemeyi destekler.

Sesli Mesajlar Nasıl Çalışır​

  1. Ses Alma

    • Kullanıcılar WhatsApp aracılığıyla sesli mesaj gönderdiğinde:
      • Ses, yapılandırılmış konuşma hizmetleri kullanılarak işlenir
      • Dil tanıma, kullanıcının dil ayarını ([[ChatUser]].Language) kullanır
      • Mesaj türü sohbet geçmişinde 'Audio Recording' olarak kaydedilir

  2. Sesi İşleme

    • Sesli mesajlar Microsoft Cognitive Services veya ElevenLabs kullanılarak metne dönüştürülür
    • Dönüştürülen metin bir sonraki otomasyon adımını tahmin etmek için kullanılır
    • İşleme, Azure Speech Service'te mevcut tüm dilleri destekler

  3. Yanıt Verme

    • Varsayılan olarak ajan sesli mesajlara metin ile yanıt verir
    • İsteğe bağlı olarak, gelişmiş kullanıcı deneyimi için sesli yanıtları yapılandırabilirsiniz

Sesli Mesaj Desteğini Etkinleştirme​

Automind Agentflow v8.10 ve üstü için:

  1. Konuşma Sağlayıcısını Yapılandırma

    • Kanal yapılandırmasında Support voice messages'ı etkinleştirin
    • Konuşma sağlayıcısını seçin (Azure veya ElevenLabs)
    • Gerekli API kimlik bilgilerini girin:
      • Azure: Speech API anahtarı ve bölge
      • ElevenLabs: API anahtarı

  2. Sesli Yanıtları Yapılandırma (İsteğe Bağlı)

    • Sesli yanıtları etkinleştirmek için Reply with voice messages'ı açın
    • Dil ve ses kombinasyonları ekleyin:
      • Açılır menüden bot dilini seçin
      • İnsana benzer sinirsel veya standart ses seçin
      • Her yapılandırmayı kaydedin

  3. Kaydet ve Yayınla

    • Sesli yapılandırma ayarlarını kaydedin
    • Henüz yayınlanmadıysa kanalı yayınlayın
    • Bot yapılandırmasını kaydedin

Not: ElevenLabs konuşma sağlayıcısı Automind Agentflow v9.0 ve üstünde mevcuttur.

Özellikler ve Yetenekler​

WhatsApp'taki Automind Agentflow'unuz şunları destekler:

  • Zengin Mesajlaşma: Metin, resim, belge ve sesli mesajlar
  • Etkileşimli Öğeler: Hızlı yanıtlar, düğmeler ve yapılandırılmış yanıtlar
  • Dosya İşleme: Belge paylaşımı ve işleme yetenekleri
  • Ses İşleme: Konuşmadan metne ve metinden konuşmaya işlevsellik
  • Çoklu Numara Desteği: Aynı ajanla birden fazla telefon numarası
  • Bağlam Farkındalığı: Kullanıcı bilgileri ve sohbet geçmişi
  • Otomatik İş Akışları: Sohbet aracılığıyla karmaşık otomasyon süreçlerini yürütme

Sorun Giderme​

Yaygın Sorunlar​

  1. Webhook Doğrulaması Başarısız

    • Callback URL'nin Meta yapılandırmasına doğru girildiğini doğrulayın
    • Doğrulama token'ının tam olarak eşleştiğinden emin olun
    • Automind Agentflow örneğinizin Meta'nın sunucularından erişilebilir olduğunu kontrol edin

  2. Mesajlar Alınmıyor

    • Webhook etkinliklerinin düzgün şekilde abone olduğunu onaylayın
    • WhatsApp kanalının Automind Agentflow'da yayınlandığını doğrulayın
    • Kalıcı token'ın uygun izinlere sahip olduğunu kontrol edin

  3. Token Sona Erme Sorunları

    • Token sona ermesi için "Never" seçtiğinizden emin olun
    • Sistem kullanıcısının hem uygulama hem de WhatsApp hesabı üzerinde tam kontrole sahip olduğunu doğrulayın
    • Gerekirse token'ı yeniden oluşturun

  4. Birden Fazla Telefon Numarası Çakışmaları

    • Automind Agentflow'da telefon numarası doğrulamasını etkinleştirin
    • Her numaranın WhatsApp Manager'da düzgün şekilde yapılandırıldığından emin olun
    • [[ChatUser]].ChannelBotIdentifier'ın doğru kullanıldığını doğrulayın

En İyi Uygulamalar​

  • Test: İnceleme için göndermeden önce geliştirme modunda kapsamlı test yapın
  • Uyumluluk: Kullanım durumunuzun WhatsApp Business politikalarına uygun olduğundan emin olun
  • Kullanıcı Deneyimi: Açık sohbet akışları ve yardımcı yanıtlar tasarlayın
  • İzleme: Sohbet günlüklerini ve kullanıcı geri bildirimlerini düzenli olarak kontrol edin
  • Güvenlik: API token'larını ve secret'ları güvenli tutun ve düzenli olarak değiştirin