KakaoTalk

Barcha konnektorlarXabarlarKakaoTalk

Sozlash roʻyxati#

Make Agent Fastʼdagi KakaoTalk kartasi shu roʻyxatni sizning qiymatlaringiz bilan toʻldirilgan holda koʻrsatadi, shuning uchun koʻpchilik ishni oʻsha yerdan bajaradi. Quyida belgilangan ikki maydondan tashqari barcha qadamlar Kakao konsolida bajariladi.

1. Kakao i Open Builderʼda bot yarating. Kanal javob beradigan barcha ssenariy bloklari shu botda turadi; oʻzgartira oladigan bot allaqachon boʻlsa, bu qadamni tashlab keting.
2. Skill qoʻshing va uning URLʼini konnektorning Skill URL qiymatiga tenglashtiring, soʻng Bot sirini tashuvchi X-Kakao-Bot-Secret maxsus soʻrov sarlavhasini qoʻshing. Kakao skill soʻrovlarini imzolamaydi, shuning uchun soʻrov aynan sizning botingizdan kelganini faqat shu sarlavha isbotlaydi.
3. Fallback blokini skillʼga ulang — shunda ssenariylar tushunmagan har bir savol agentga yetadi. Biror nomli ssenariy blokiga ham agent javob bersin desangiz, uni oʻsha skillʼga ulang.
4. Shu blokning callback opsiyasini yoqing. Kakao besh soniyadan uzoq davom etgan skill javobini tashlab yuboradi; callback yoqilganda Make Agent Fast darhol kutish xabarini qaytaradi va tayyor javobni userRequest.callbackUrl manziliga yuboradi. Bu bir martalik URLʼni biz bir daqiqa davomida amal qiladi deb hisoblaymiz.
5. KakaoTalk Channelʼni botga ulang, soʻng oʻsha kanal IDʼsini Make Agent Fast konnektorining Channel ID maydoniga kiriting.
6. Botni deploy qiling. Open Builderʼdagi oʻzgarishlar faqat deploydan keyin mijozlarga yetadi va keyingi har bir skill yoki blok oʻzgarishi yana deploy talab qiladi.

Sahifaning qolgan qismi shu olti qadamning batafsil bayoni.

Kakao resurslarini tayyorlash#

Integratsiyaga egalik qiladigan Kakao Developers ilovasi, KakaoTalk Channel va Kakao i Open Builder botini yarating yoki tanlang. Skill va bloklar uchun Kakaoʼning rasmiy Open Builder hujjatlarini ko‘rib chiqing.

Quyidagi qiymatlarni oling yoki yarating:

Kakao skill chaqiruvlari platforma imzosini bermagani uchun joylashtirilgan Make Agent Fast muhitlarida Bot siri majburiy. Yuqori entropiyali noyob qiymat yarating va REST API kalitini sir sifatida qayta ishlatmang.

Konnektorni saqlash#

Saytning Konnektorlar sahifasini oching, KakaoTalk Channelni tanlang, uchala qiymatni kiriting va Ulashni bosing. Kakao ruxsatlari imkon berganda Make Agent Fast REST API kalitini tekshiradi va saqlangandan so‘ng konnektorning noyob Webhook URL manzilini ko‘rsatadi.

Make Agent Fast siz uchun Open Builder skill yaratolmaydi yoki uni blokka ulay olmaydi; qolgan ish Kakao konsolida bajariladi.

Open Builder skillʼini sozlash#

1. Kakao i Open Builder ichida kerakli bot uchun skill yarating.
2. Skill URLʼiga konnektordan nusxalangan Webhook URLni kiriting.
3. Qiymati aynan Bot siriga teng bo‘lgan X-Kakao-Bot-Secret nomli maxsus so‘rov sarlavhasini qo‘shing.
4. Skillʼni agentni chaqirishi kerak bo‘lgan fallback yoki ssenariy blokiga ulang.
5. Sekin javoblar Kakaoʼning besh soniyalik skill chegarasidan omon chiqishi uchun shu blokning callback opsiyasini yoqing.
6. Kakao jarayoniga muvofiq bot sozlamasini saqlang va deploy/nashr qiling.

HTTP qoidalari bo‘yicha sarlavha katta-kichik harfga bog‘liq emas, ammo sir qiymati aynan mos bo‘lishi kerak. Webhook URLʼini bilgan, lekin sirni bilmagan foydalanuvchi ruxsatsiz javob olishi kerak.

Imkoniyatlarni sinash#

Avval Open Builder sinov vositasidan, keyin ulangan KakaoTalk Channelʼdan foydalaning. Haqiqiy koreyscha yoki qo‘llab-quvvatlanadigan boshqa tildagi matnli savol yuboring va ichki javob, Oxirgi xabar hamda Suhbatlardagi yozuvni tekshiring.

Konnektor kartasi quyidagi soʻrov tanasini nusxalab beradi; xuddi shu tanani Skill URL manziliga curl bilan ham yuborish mumkin. Unda callbackUrl yoʻq, shuning uchun javob ichki tarzda qaytadi — avval sinash uchun eng oddiy yoʻl.

{
  "intent": {
    "id": "5a56ec0cf65e53002d34e0f4",
    "name": "Fallback block"
  },
  "userRequest": {
    "timezone": "Asia/Seoul",
    "utterance": "What are your opening hours?",
    "lang": "kr",
    "user": {
      "id": "kakao-test-user",
      "type": "botUserKey",
      "properties": {
        "plusfriendUserKey": "kakao-test-user"
      }
    },
    "block": {
      "id": "5a56ec0cf65e53002d34e0f4",
      "name": "Fallback block"
    }
  },
  "bot": {
    "id": "5a56ec0cf65e53002d34e0f2",
    "name": "Your bot"
  },
  "action": {
    "id": "5a56ec0cf65e53002d34e0f6",
    "name": "Make Agent Fast skill",
    "params": {},
    "detailParams": {},
    "clientExtra": {}
  }
}

Hammasi joyida boʻlsa, skill besh soniyalik chegara ichida bitta simpleText natijasi bilan javob beradi:

{
  "version": "2.0",
  "template": {
    "outputs": [
      {
        "simpleText": {
          "text": "We are open 9:00–18:00 on weekdays."
        }
      }
    ]
  }
}

Blokning callback opsiyasi yoqilgach, Open Builder soʻrovga userRequest.callbackUrlni qoʻshadi. Shunda Make Agent Fast avval kutish xabari bilan javob beradi va tayyor javobni oʻsha bir martalik URLʼga POST qiladi:

{
  "version": "2.0",
  "useCallback": true,
  "data": {
    "text": "One moment — I am looking that up."
  }
}

Joriy skill shartnomasi faqat matn bilan ishlaydi. Agent javobi Kakao skillResponse 2.0 talqinidagi bitta simpleText natijasi boʻlib, Kakao matn cheklovidan pastroq hajmda kesiladi va ichki tarzda yoki callback URL orqali yetkaziladi. Ovoz, fayl, rasm va alohida chiquvchi audio qo‘llab-quvvatlanmaydi.

Sirni yangilash yoki ulanishni uzish#

Bot sirini yangilash uchun konnektor va Open Builder maxsus sarlavhasini bir vaqtda o‘zgartirib, darhol sinang. Mos kelmaslik barcha kiruvchi so‘rovlarni to‘xtatadi. Eski kalitni bekor qilishdan oldin REST API kalitini Kakao Developers va Make Agent Fastʼda yangilang.

Konnektorni o‘chirish yoki olib tashlash Open Builder skill yoki blokini o‘chirmaydi. Integratsiyani butunlay tugatayotganda provayderdagi shu obyektlarni olib tashlang yoki uzing.

Muammolarni hal qilish#

REST API kaliti yoki Bot sirini mijoz kodi yoxud ochiq hujjatda ko‘rsatmang.