Yardım merkezine dön

Feishu'yu Elisi Agent'a bağlama

Feishu botunu Elisi Agent'a bağlayın

Kurulumdan sonra Feishu'da şirket botunuzla özel sohbet edebilir ve Elisi Agent'tan görevleri, listeleri ve diğer öğeleri kaydetmesini veya aramasını isteyebilirsiniz.

Başlamadan önce

Şunlara ihtiyacınız var:

  • Bir Elisi hesabı.
  • Kurumunuz için özel Feishu uygulaması oluşturma ve yayımlama izni.
  • Gerekirse şirket yöneticisinin uygulama izinleri için onayı.

1. Feishu uygulaması oluşturun

  1. Feishu Açık Platformu açın ve geliştirici konsoluna gidin.
  2. Özel kurumsal uygulama oluşturun.
  3. Uygulama yetenekleri ekle bölümünde Bot seçeneğini etkinleştirin.
  4. İzinler bölümüne şunları ekleyin:
    • Kullanıcıların bota gönderdiği özel mesajları okuma.
    • Uygulama olarak mesaj gönderme.
    • Botu grup sohbetlerinde kullanmak için botun etiketlendiği mesajları alma izni.

App ID ve App Secret değerlerini kaydedin.

2. Botu Elisi'ye bağlayın

  1. Elisi'de Ayarları açın.
  2. Elisi AI altında Feishu / Lark Bot seçeneğini belirleyin.
  3. Platform olarak Feishu seçin. Uluslararası Lark hizmetini kullanıyorsanız Lark seçin.
  4. İsteğe bağlı bot adı, App ID, App Secret ve Feishu konsolunda görünen Verification Token değerini girin.
  5. Botu bağla seçeneğini belirleyin.

Doğrulamadan sonra Elisi şunları gösterir:

  • Etkinlik callback URL'si.
  • Hesabı bağlamak için tek kullanımlık komut.

App Secret yalnızca bir kez gösterilir. Elisi bunu şifreli olarak saklar ve Agent'a göndermez.

3. Etkinlik callback'lerini yapılandırın

Feishu Açık Platformu'na dönün:

  1. Etkinlikler ve callback'ler veya Etkinlik aboneliklerini açın.

  2. Etkinlikleri geliştirici sunucusuna gönder seçeneğini belirleyin.

  3. Elisi'deki Etkinlik callback URL değerini kopyalayıp istek URL'si olarak yapıştırın.

  4. Encrypt Key alanını boş bırakın.

  5. URL'yi kaydedin ve Feishu'nun doğrulama onayını bekleyin.

  6. Etkinlik ekle seçeneğini belirleyip şunu ekleyin:

    Mesajları al (im.message.receive_v1)

URL doğrulaması tek başına yeterli değildir; im.message.receive_v1 etkinliğini de eklemelisiniz.

4. Uygulamayı yayımlayın ve yükleyin

  1. Feishu Açık Platformu'nda yeni bir sürüm oluşturun.
  2. Eklenen izinlerin ve mesaj etkinliğinin bu sürüme dahil olduğunu doğrulayın.
  3. İncelemeye gönderip yayımlayın. Gerekirse önce yönetici onayını alın.
  4. Uygulamayı şirkete yükleyin ve Feishu hesabınızın kullanılabilir kullanıcı kapsamına dahil olduğundan emin olun.

İzinleri veya etkinlik aboneliklerini değiştirdikten sonra bunların uygulanması için yeni bir sürüm yayımlayın.

5. Elisi hesabınızı bağlayın

Yapılandırma ve yayımlama 15 dakikadan uzun sürebilir. Uygulama yayımlandıktan sonra Elisi'ye dönün:

  1. Bot kartında Yeni bağlantı kodu oluştur seçeneğini belirleyin.

  2. Tek kullanımlık komutun tamamını kopyalayın, örneğin:

    /elisi-bind AbCdEf123

  3. 15 dakika içinde botla bire bir sohbet açıp komutu gönderin.

  4. Başarı mesajından sonra Elisi'ye dönüp durumu yenileyin.

Durum Bağlantı bekleniyor yerine Bağlandı olduğunda kurulum tamamlanır. İlk bağlantı bir grup sohbetinde değil, bire bir sohbette yapılmalıdır.

6. Botu kullanın

  • Bire bir sohbet: Botla doğrudan metin paylaşın.
  • Grup sohbeti: Bağlı bir kullanıcı mesajda bottan bahsetmelidir.
  • Bağlantıyı kesme: Elisi'deki bot kartında Bağlantıyı kes seçeneğini belirleyin.

Mevcut sürüm metin mesajlarını destekler. Encrypt Key ile şifrelenmiş callback'ler, ekler, etkileşimli kartlar veya bir Elisi hesabını birden fazla kişiyle paylaşma desteklenmez.

Sorun giderme

Sorun Kontrol edilecekler
Callback URL doğrulanmıyor veya challenge dönmüyor URL'nin tamamını ve Verification Token eşleşmesini kontrol edin. Encrypt Key değerini temizleyip yeniden kaydedin.
URL doğrulanıyor ama bot özel sohbette yanıt vermiyor im.message.receive_v1 eklendi mi kontrol edin. Etkinlik ve izin ekledikten sonra en son sürümü yeniden yayımlayın, onaylatın ve yükleyin.
Elisi hâlâ “Bağlantı bekleniyor” diyor Yeni kod oluşturun ve 15 dakika içinde bire bir sohbette komutun tamamını gönderin. Eski kodların süresi dolar.
Hesap bağlandı ama bot yanıt vermiyor Uygulama olarak mesaj gönderme izninin onaylandığını ve son sürümde bulunduğunu kontrol edin.
Bot grupta yanıt vermiyor Önce bire bir sohbette bağlantı kurun. Ardından bağlı kullanıcı grupta bottan bahsetsin.
Bot bulunamıyor veya özel mesaj gönderilemiyor Uygulamanın yüklendiğini ve hesabınızın kullanılabilir kullanıcı kapsamında olduğunu kontrol edin.

Sorun sürerse Feishu Açık Platformu'ndaki Etkinlik gönderim kayıtları bölümünde im.message.receive_v1 olup olmadığını kontrol edin. Kayıt yoksa etkinlik, izinler, yayımlanan sürüm veya uygulama kapsamı henüz etkin olmayabilir.