Rust언어로 카카오 챗봇 서버를 만들 때 좀 더 쉽게 JSON 메시지 응답을 만들 수 있게 도와줍니다.
SimpleText, SimpleImage, ListCard, Carousel, BasicCard, CommerceCard, ItemCard
JSON 데이터를 쉽게 만들 수 있도록 도와줍니다.
toml
[dependencies]
kakao-rs = "0.2.5"
Buttons: ShareButton (공유 버튼), LinkButton (링크 버튼), MsgButton (일반 메시지만), CallButton (전화 버튼)
Items: ListItem
예제) 유저 발화문 얻기: json.userRequest.utterance
```rust
pub fn test(kakao: Json
```rust extern crate kakao_rs;
use kakaors::components::basics::*; use kakaors::components::buttons::; use kakao_rs::components::cards::;
fn main() { let mut result = Template::new();
// 빠른 응답 result.addqr(QuickReply::new("오늘", "오늘 공지 보여줘")); result.addqr(QuickReply::new("어제", "어제 공지 보여줘"));
let mut list_card = ListCard::new("리스트 카드 제목!"); // 제목
listcard.addbutton(Button::Msg(MsgButton::new("그냥 텍스트 버튼")));
listcard.addbutton(Button::Link( LinkButton::new("link label").setlink("https://google.com"), )); listcard.addbutton(Button::Share( ShareButton::new("share label").setmsg("카톡에 보이는 메시지"), ));
listcard.additem( ListItem::new("title") .setdesc("description") .setlink("https://naver.com"), );
result.addoutput(listcard.build()); // moved list_card's ownership
println!( "Result: {}", serdejson::tostring_pretty(&result).expect("Failed") ); }
/* Result: { "template": { "outputs": [ { "listCard": { "buttons": [ { "label": "그냥 텍스트 버튼", "action": "message" }, { "label": "link label", "action": "webLink", "webLinkUrl": "https://google.com" }, { "label": "share label", "action": "share", "messageText": "카톡에 보이는 메시지" } ], "header": { "title": "리스트 카드 제목!" }, "items": [ { "title": "title", "description": "description", "link": { "web": "https://naver.com" } } ] } } ], "quickReplies": [ { "action": "message", "label": "오늘", "messageText": "오늘 공지 보여줘" }, { "action": "message", "label": "어제", "messageText": "어제 공지 보여줘" } ] }, "version": "2.0" } */ ```
Carousel에 Card를 추가할 때는 build_card()로 카드를 빌드하세요.
자세한 사용법은 tests 폴더를 참고하세요.
```rust use kakaors::components::basics::*; use kakaors::components::cards::*; use std::matches;
fn simpletexttest() { let mut result = Template::new(); result.add_qr(QuickReply::new( "빠른 응답", "빠른 응답 ㅋㅋ", ));
let simple_text = SimpleText::new("심플 텍스트 테스트");
result.add_output(simple_text.build());
let serialized = r#"{"template":{"outputs":[{"simpleText":{"text":"심플 텍스트 테스트"}}],"quickReplies":[{"action":"message","label":"빠른 응답","messageText":"빠른 응답 ㅋㅋ"}]},"version":"2.0"}"#;
assert_eq!(serialized, result.to_string());
}
fn multipleoutputstest() { let mut result = Template::new(); result.add_qr(QuickReply::new( "빠른 응답", "빠른 응답 ㅋㅋ", ));
let mut carousel = Carousel::new().set_type(BasicCard::id());
for i in 0..5 {
let basic_card = BasicCard::new()
.set_title(format!("{}번", i))
.set_thumbnail(
"http://k.kakaocdn.net/dn/APR96/btqqH7zLanY/kD5mIPX7TdD2NAxgP29cC0/1x1.jpg"
);
carousel.add_card(basic_card.build_card());
}
result.add_output(carousel.build());
let simple_text = SimpleText::new("심플 텍스트 테스트");
result.add_output(simple_text.build());
let serialized = r#"{"template":{"outputs":[{"carousel":{"type":"basicCard","items":[{"title":"0번","thumbnail":{"imageUrl":"http://k.kakaocdn.net/dn/APR96/btqqH7zLanY/kD5mIPX7TdD2NAxgP29cC0/1x1.jpg",}},{"title":"1번","thumbnail":{"imageUrl":"http://k.kakaocdn.net/dn/APR96/btqqH7zLanY/kD5mIPX7TdD2NAxgP29cC0/1x1.jpg"}},{"title":"2번","thumbnail":{"imageUrl":"http://k.kakaocdn.net/dn/APR96/btqqH7zLanY/kD5mIPX7TdD2NAxgP29cC0/1x1.jpg"}},{"title":"3번","thumbnail":{"imageUrl":"http://k.kakaocdn.net/dn/APR96/btqqH7zLanY/kD5mIPX7TdD2NAxgP29cC0/1x1.jpg"}},{"title":"4번","thumbnail":{"imageUrl":"http://k.kakaocdn.net/dn/APR96/btqqH7zLanY/kD5mIPX7TdD2NAxgP29cC0/1x1.jpg"}}]}},{"simpleText":{"text":"심플 텍스트 테스트"}}],"quickReplies":[{"action":"message","label":"빠른 응답","messageText":"빠른 응답 ㅋㅋ"}]},"version":"2.0"}"#;
// Carousel BasicCards 뒤 SimpleText 발화
assert_eq!(serialized, result.to_string());
} ```