Konnektorlar haqida

TelegramWhatsAppMessengerInstagramDiscordKakaoTalk

Konnektorlar tashqi xabar platformasidan hodisa oladi, matn yoki qo‘llab-quvvatlanadigan audioni standart shaklga keltiradi, xuddi shu sayt agentini ishga tushiradi va kanalga mos javob qaytaradi. Har bir tashqi foydalanuvchining kanalga xos suhbat tarixi Suhbatlarda ko‘rinadi.

Yangi kanal ulash Operate yoki Scale talab qiladi. Launch’da mavjud ulanishlar ishlashda davom etadi.

Imkoniyatlar jadvali#

“Kiruvchi ovoz” qo‘llab-quvvatlanadigan ovoz/audio xabari yuklab olinib, matnga aylantirilishini bildiradi. “Chiquvchi ovoz” uchun ishlaydigan nutq provayderi va konnektordagi Ovoz bilan javob berish tanlovi kerak. Rasm va joylashuv kabi qo‘llab-quvvatlanmaydigan biriktirmalar agent ko‘rsatmasi sifatida talqin qilinmasdan eʼtiborsiz qoldiriladi.

Ulashdan oldin#

1. Kerakli sayt agentini boshqaruv panelida sinang. Ochiq havola va sahifalar ishlashi uchun nashr qilish tavsiya etiladi; qoralama konnektor ham javob bera oladi.
2. Sozlamalar → AI provayder kalitlarida ishlaydigan model kalitini sozlang. Ovozni sinashdan oldin nutq kalitlarini sozlang. Provayder kalitlariga qarang.
3. Tashqi provayderda alohida ilova, bot, raqam yoki kanal yarating. Boshqa ishlab chiqarish integratsiyasiga tegishli hisob maʼlumotini qayta ishlatmang.
4. Deployment ochiq HTTPS konnektor asosiy URLʼiga ega ekanini tekshiring. Xavfsiz development tunnelisiz provayder webhooki localhostga yetkazolmaydi.
5. Saytning Konnektorlar sahifasini ochib, kanalni tanlang.

Saqlashda Make Agent Fast yuborilgan hisob maʼlumotini tekshirish uchun provayderni chaqiradi. “Ulangan” yorlig‘i hisob maʼlumoti tekshiruvi va avtomatik sozlash tugaganini bildiradi; u Meta, Discord yoki Kakao konsolidagi qo‘lda bajariladigan bosqich yakunlanganini isbotlamaydi.

Hisob maʼlumotlarini boshqarish#

Konnektor formasi provayder hisob maʼlumotini faqat autentifikatsiya qilingan panel yoki serverdagi Public API orqali qabul qiladi. Sirlar saqlanganda shifrlanadi va konnektor ro‘yxati javobida qaytarilmaydi. Quyidagilarni parol kabi saqlang:

• Telegram bot tokeni
• Meta access tokenlari va app secret
• Discord bot tokeni
• Kakao REST API kaliti va bot siri

Ularni brauzer JavaScripti, skrinshot, yordam bileti yoki manba kodiga qo‘ymang. Webhook URL va Meta verify token mos provayder konsoliga ko‘chirish uchun mo‘ljallangan sozlama qiymatidir; ular provayder hisob maʼlumoti o‘rnini bosmaydi.

API orqali ulash#

Serverda saqlanadigan, connectors:write ruxsatli MAF API kalitidan foydalaning. Kanalga xos credentials obyekti faqat yozish uchun. Javob ochiq sirlarni tashlab, qo‘lda provayder sozlamasi uchun kerakli webhook URLʼini qaytaradi.

curl -X POST "https://makeagent.fast/api/v1/sites/$SITE_ID/connectors" \
  -H "Authorization: Bearer $MAF_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: connector-telegram-v1" \
  -d '{
    "channel": "telegram",
    "credentials": { "bot_token": "'$TELEGRAM_BOT_TOKEN'" },
    "config": { "reply_with_voice": false }
  }'

Xuddi shu kanalni saqlash routing tokenini saqlagan holda uning hisob maʼlumoti/sozlamasini almashtiradi. Ishlab chiqarish integratsiyasi qoidalari uchun API autentifikatsiyasi, Ruxsatlar va xatolar va API maʼlumotnomasidan foydalaning.

Sinash va kuzatish#

Provayder sinov foydalanuvchisi va agent bilimiga bog‘liq haqiqiy savoldan foydalaning. Quyidagilarning barchasini tekshiring:

• Provayder webhook endpointini qabul qiladi yoki tekshiradi.
• Xabar agentga yetadi va kutilgan javobni oladi.
• Konnektor kartasidagi Oxirgi xabar yangilanadi.
• Suhbat to‘g‘ri kanal bilan Suhbatlarda ko‘rinadi.
• Ommaviy ishga tushirishdan oldin provayder review/development-mode cheklovi tushunilgan.
• Kanal qo‘llasa, ovoz matndan alohida sinalgan.

Konnektor kartasi oxirgi provayder yoki yetkazish xatosini ko‘rsatadi. Provayder paneli ham yetkazish logini saqlaydi; faqat bir tomon so‘rovni ko‘rsatsa, vaqt va event identifikatorini solishtiring.

O‘chirish, yangilash yoki olib tashlash#

O‘chirish konnektor yozuvini saqlagan holda qayta ishlashni to‘xtatadi. Telegram webhooki o‘chirishda olib tashlanadi va yoqishda qayta ro‘yxatdan o‘tadi; konsolda sozlangan provayder obunalari qoladi va kerak bo‘lsa provayder tomonida ham to‘xtatilishi kerak. Olib tashlash Make Agent Fast konnektorini o‘chiradi va provayder tomonni imkon qadar tozalaydi, ammo tashqi ilovani o‘chirmaydi, hisob maʼlumotini bekor qilmaydi yoki tarixiy suhbatni yo‘q qilmaydi.

Yangilashda yangi provayder tokenini yarating, konnektorni yangilang, sinang va keyin eski tokenni bekor qiling. Hisob maʼlumoti oshkor bo‘lsa, avval provayderda bekor qiling va davrni xavfsizlik hodisasi deb ko‘ring.

Odatiy xatolar#

Aniq provayder maydonlari va konsol ketma-ketligi uchun mos kanal qo‘llanmasi bilan davom eting.