챗봇 설정
섹션 제목: “챗봇 설정”성격, 대화 스타일, 시스템 프롬프트를 포함한 AI 에이전트의 전체 설정을 조회하고 수정합니다.
동작 설정은 대시보드 정체성 > AI 페르소나, 방문자에게 보이는 텍스트는 채널 > 내 웹사이트 > 텍스트 콘텐츠에 있습니다. 아래 필드 표에 각 설정의 정확한 위치를 안내합니다.
챗봇 설정 조회
섹션 제목: “챗봇 설정 조회”GET https://app.quickchat.ai/v1/api/chatbot_settings
curl https://app.quickchat.ai/v1/api/chatbot_settings \ -H 'Authorization: Bearer <API_TOKEN>'import requests
response = requests.get( url="https://app.quickchat.ai/v1/api/chatbot_settings", headers={"Authorization": "Bearer <API_TOKEN>"},)data = response.json()응답 200 OK
{ "personality": 0, "profession": "helpful_assistant", "creativity_level": 1, "greeting": "<p>Hello! How can I help you today?</p>", "greeting2": "", "header": "Support Assistant", "header2": "", "language_chosen": "en", "reply_length": 1, "one_word_description": "Support Agent", "short_description": "A helpful customer support assistant.", "ai_commands": ["Be polite", "Stay on topic"]}| 필드 | 설명 |
|---|---|
one_word_description 문자열 | AI 에이전트 이름. 대시보드: 정체성 > AI 페르소나 > 이름. API는 최대 200자, 앱 필드는 40자로 제한합니다. |
short_description 문자열 | 메인 프롬프트(시스템 프롬프트). 대시보드: 정체성 > AI 페르소나 > 메인 프롬프트. API는 모든 요금제에서 최대 25,000자이며 앱 편집기는 15,000자부터 시작하는 요금제 한도를 적용합니다. |
ai_commands 문자열 배열 | 항목마다 하나의 AI 동작 가이드라인. 대시보드: 정체성 > AI 페르소나 > 가이드라인. 최대 250개 항목, 항목당 5,000자, 전체 10,000자입니다. |
personality 정수(0–13) | AI 성격 프리셋. 대시보드: 정체성 > AI 페르소나 > 성격. 아래 표 참고 |
profession 문자열 | AI 직업/역할. 대시보드: 정체성 > AI 페르소나 > 역할(최대 200자). 아래 표 참고 |
creativity_level 정수(0–2) | 대시보드: 정체성 > AI 페르소나 > 창의성. 0 = 낮음, 1 = 보통, 2 = 높음 |
reply_length 정수(0–2) | 대시보드: 정체성 > AI 페르소나 > 답변 길이. 0 = 짧게, 1 = 보통, 2 = 더 길게 |
greeting 문자열 | 기본 환영 메시지(HTML). 대시보드: 채널 > 내 웹사이트 > 텍스트 콘텐츠 > 환영 메시지(최대 1,000자). Widget 설정의 welcome_message와 같은 필드입니다. |
greeting2 문자열 | 보조 환영 메시지(HTML). API로 사용할 수 있으며 대시보드에는 편집 필드가 없습니다. |
header 문자열 | 채팅 헤더 텍스트. 대시보드: 채널 > 내 웹사이트 > 텍스트 콘텐츠 > 헤더 텍스트(최대 200자) |
header2 문자열 | 보조 헤더 텍스트(최대 200자). API의 header2 또는 Widget 설정의 subtitle로 사용할 수 있으며 대시보드에는 편집 필드가 없습니다. |
language_chosen 문자열 | 쉼표로 구분한 언어 코드(예: "en,es,de"). 대시보드: 정체성 > AI 페르소나 > 언어(전체 최대 200자, 30개 언어를 넘는 코드는 제외됨) |
성격 값:
| 값 | 라벨 | 설명 |
|---|---|---|
| 0 | 클래식 | 전문성과 친근함의 균형을 갖춘 설정(기본값) |
| 1 | 유머러스한 | 말장난과 농담으로 즐거움을 주는 재치 있는 어조 |
| 2 | 격식 있는 | 비즈니스에 맞는 진지하고 간결한 사실 중심 정보 |
| 3 | 친근한 | 개인적이고 다가가기 쉬운 편안한 대화 |
| 4 | 톡톡 쏘는 | 자신감 있고 장난스러우며 유머가 있는 스타일 |
| 5 | 지적인 | 포괄적 이해를 위한 상세하고 정확한 정보 |
| 6 | 공감하는 | 감정을 배려하는 따뜻하고 공감하는 대화 |
| 7 | 대담한 | 강한 의견과 권고를 자신 있게 전달 |
| 9 | 열정적인 | 생동감 있고 활기찬 상호작용 |
| 10 | 신비로운 | 신비롭고 호기심을 유발하는 독특한 응답 |
| 11 | 영감을 주는 | 코치처럼 긍정적 사고와 목표 달성을 장려 |
| 12 | 모험적인 | 익숙한 범위를 벗어나 새 기회를 탐색하도록 장려 |
| 13 | 우아한 | 독특하고 고급스러운 브랜드에 맞는 세련된 경험 |
역할 값:
| 값 | 대시보드 라벨 | 설명 |
|---|---|---|
helpful_assistant | 일반 | 다양한 용도에 활용 가능. 대부분의 사용 사례에 권장 |
customer_support_representative | 지원 담당자 | 공감하며 단계별 해결책과 문제 해결 제공 |
shopping_assistant | 쇼핑 도우미 | 링크와 함께 제품을 적극적으로 추천 |
field_expert | 분야 전문가 | 확인 질문과 전문 지침을 제공하는 전문 컨설턴트 |
interviewer | 인터뷰어 | 답변 대신 질문. 설문, 인터뷰, 피드백 수집용 |
one_word_description, short_description, ai_commands는 지식 베이스 설정 엔드포인트에서도 사용할 수 있습니다. 공유되는 필드이므로 어느 쪽에서 수정해도 같은 데이터가 바뀝니다.
챗봇 설정 수정
섹션 제목: “챗봇 설정 수정”PATCH https://app.quickchat.ai/v1/api/chatbot_settings
요청 본문: 모든 필드는 선택 사항입니다. 수정할 필드만 포함하세요.
| 매개변수 | 설명 |
|---|---|
personality 정수(0–13) | AI 성격 프리셋 |
profession 문자열 | AI 직업/역할(최대 200자) |
creativity_level 정수(0–2) | 0 = 낮음, 1 = 보통, 2 = 높음 |
greeting 문자열 | 기본 환영 메시지(HTML, 최대 1,000자) |
greeting2 문자열 | 보조 환영 메시지 |
header 문자열 | 채팅 헤더 텍스트(최대 200자) |
header2 문자열 | 보조 헤더 텍스트(최대 200자) |
language_chosen 문자열 | 쉼표로 구분한 언어 코드(전체 최대 200자, 30개 언어를 넘는 코드는 제외됨) |
reply_length 정수(0–2) | 0 = 짧게, 1 = 보통, 2 = 더 길게 |
one_word_description 문자열 | AI 에이전트 이름. API 최대 200자, 앱 필드는 40자 제한. |
short_description 문자열 | AI 메인 프롬프트(시스템 프롬프트). API는 모든 요금제에서 최대 25,000자이며 앱 편집기는 15,000자부터 시작하는 요금제 한도를 적용합니다. 초과하면 422를 반환합니다. |
ai_commands 문자열 배열 | 항목마다 하나의 AI 가이드라인. 최대 250개 항목, 항목당 5,000자, 전체 10,000자입니다. 초과하면 422를 반환합니다. |
배열 항목 하나가 가이드라인 하나이며 보낸 그대로 저장됩니다. 세미콜론을 포함한 문장부호도 유지됩니다. 이전에는 저장 전에 ;를 제거했지만 이제 이를 피하려고 세미콜론을 삭제하거나 대체하지 않아도 됩니다.
가이드라인을 유지하려면 ai_commands를 생략하거나 null을 보내세요. 모두 지우려면 []를 보내세요.
curl -X PATCH https://app.quickchat.ai/v1/api/chatbot_settings \ -H 'Authorization: Bearer <API_TOKEN>' \ -H 'Content-Type: application/json' \ -d '{ "greeting": "<p>Welcome! Ask me anything.</p>", "creativity_level": 2}'import requests
response = requests.patch( url="https://app.quickchat.ai/v1/api/chatbot_settings", headers={"Authorization": "Bearer <API_TOKEN>"}, json={ "greeting": "<p>Welcome! Ask me anything.</p>", "creativity_level": 2, },)data = response.json()응답 200 OK: 수정된 챗봇 설정을 반환합니다(챗봇 설정 조회와 같은 스키마).