Faqs

FAQ related APIs

답변 선택

post

이 Method는 유저가 특정 FAQ를 조회하는 것을 시뮬레이션할 때 사용합니다.

Authorizations
API-KEYstringRequired

Your API key for authentication

Header parameters
AGENT-EMAILstringOptional

Optional: Email of the agent to use for this request

USER-EMAILstringOptional

Optional: Email address to associate with the user

OWN-USER-IDstringOptional

Optional: User ID to identify or create a user

Body
idstringOptional

선택하고 싶은 FAQ의 ID

hashIdstringOptional

Q&A 검색 반환 결과의 ID

Responses
200

FAQ 선택 완료

application/json
post
/webapi/faq/select_answer

Q&A에서 검색

post

이 API를 사용하면 Q&A 지식베이스에서 가장 관련성 높은 질문과 답변 쌍을 찾을 수 있습니다.

Authorizations
API-KEYstringRequired

Your API key for authentication

Header parameters
AGENT-EMAILstringOptional

Optional: Email of the agent to use for this request

USER-EMAILstringOptional

Optional: Email address to associate with the user

OWN-USER-IDstringOptional

Optional: User ID to identify or create a user

Body
autoRegisterCandidatesbooleanOptional

기본 값은 true입니다. 이 옵션이 false로 설정되면, 주어진 쿼리에 대한 답변이 없을 때 쿼리를 자동으로 후보에게 등록하지 않습니다.

hashtagsOperatorstring · enumOptional

AND 또는 OR.
모든 결과에 모든 해시태그가 포함되기를 원하면 AND를 선택해 주세요.
모든 결과에 적어도 하나의 해시태그가 포함되기를 원하면 OR을 선택해 주세요.

Possible values:
hashtagsstring[]Optional

표시하고 싶은 모든 해시태그의 배열.

maxResultsintegerOptional

반환할 최대 결과 수.

querystringOptional

쿼리 문자열입니다.

formatstring · enumOptional

텍스트인지 html인지 여부. 텍스트인 경우 반환 값은 일반 텍스트입니다. html인 경우 html로 반환됩니다. 답변에 다른 폰트 크기와 색상이 있는 스타일이 적용된 html이 포함된 경우 html을 사용할 수 있습니다. 단순히 텍스트로 답변을 얻고 싶다면 텍스트를 사용할 수 있습니다. 기본값은 html입니다.

Possible values:
Responses
200

API는 Q&A 데이터베이스에서 가장 관련성 있는 질문과 답변을 찾을 것입니다.

application/json
post
/webapi/faq
200

API는 Q&A 데이터베이스에서 가장 관련성 있는 질문과 답변을 찾을 것입니다.

단일 질문 및 답변 가져오기

get

단일 Q&A의 모든 세부 정보를 가져오는 방법입니다.

Authorizations
API-KEYstringRequired

Your API key for authentication

Query parameters
idstringRequired

The id of the FAQ you are looking for.

formatstring · enumOptional

The format of the answer value for this FAQ. Default is HTML.

Possible values:
Header parameters
AGENT-EMAILstringOptional

Optional: Email of the agent to use for this request

USER-EMAILstringOptional

Optional: Email address to associate with the user

OWN-USER-IDstringOptional

Optional: User ID to identify or create a user

Responses
200

FAQ 세부정보를 성공적으로 검색했습니다.

application/json
get
/webapi/single_faq

Q&A 가져오기

get

이 API를 사용하여 지식베이스에서 Q&A를 가져올 수 있습니다.

Authorizations
API-KEYstringRequired

Your API key for authentication

Query parameters
offsetintegerOptional

Offset allows you to specify the ranking number of the first item on the page.

Default: 0
limitintegerOptional

Limit allows you to set the number of objects returned on one page. The maximum and the default value is 1000.

Default: 1000
formatstring · enumOptional

If your answers contain styled html, such as different font size or color, you can use html to get answers in html format. If you simply want to get answers as a text, you can use the text.

Default: htmlPossible values:
Header parameters
AGENT-EMAILstringOptional

Optional: Email of the agent to use for this request

USER-EMAILstringOptional

Optional: Email address to associate with the user

OWN-USER-IDstringOptional

Optional: User ID to identify or create a user

Responses
200

FAQ를 성공적으로 가져왔습니다.

application/json
get
/webapi/faqs
200

FAQ를 성공적으로 가져왔습니다.

Q&A 검색

post

이 API를 사용하여 지식베이스에서 Q&A를 검색하고 필터링할 수 있습니다.

Authorizations
API-KEYstringRequired

Your API key for authentication

Header parameters
AGENT-EMAILstringOptional

Optional: Email of the agent to use for this request

USER-EMAILstringOptional

Optional: Email address to associate with the user

OWN-USER-IDstringOptional

Optional: User ID to identify or create a user

Body
searchTermstringOptional

목록을 필터링하기 위한 키워드 검색 쿼리입니다. 연산자를 사용하여 고급 검색을 실행할 수 있습니다. "TERM1 TERM2"는 AND, "TERM1 OR TERM2"는 OR, "TERM"은 정확히 일치하는 검색에 사용됩니다.

isUsedbooleanOptional

True일 경우, 활성화된 Q&A만 나열되고, False일 경우, 비활성화된 Q&A만 표시됩니다.

hashtagsstring[]Optional

목록을 필터링하기 위한 해시태그. 여러 개의 해시태그를 추가할 수 있습니다.

hashtagsOperatorstring · enumOptional

해시태그가 "and"이면, 여러 개의 해시태그 필터는 AND 논리로 작동합니다. "or"이면, OR 논리로 작동합니다.

Possible values:
createdByAgentbooleanOptional

True인 경우, 목록에는 에이전트가 작성한 Q&A만 포함됩니다. False인 경우, 다른 Q&A만 포함됩니다. createdByAgent, answeredByMrc, autoGenerated, editedByAgent 필터는 상호 배타적이며, 두 개 이상의 필터가 사용되면 OR 논리가 적용됩니다.

answeredByMrcbooleanOptional

True인 경우, 목록에는 업로드된 문서에서 자동으로 추출된 답변인 Q&A만 포함됩니다. False인 경우, 다른 Q&A만 포함됩니다.

autoGeneratedbooleanOptional

True이면 목록에는 자동 생성된 Q&A만 포함됩니다. False이면 다른 Q&A만 포함됩니다.

editedByAgentbooleanOptional

True일 경우, 목록에는 등록 후 어떤 에이전트에 의해 편집된 Q&A만 포함됩니다. False일 경우, 다른 Q&A만 포함됩니다.

formatstring · enumOptional

답변에 다양한 글꼴 크기나 색상과 같은 스타일이 있는 HTML이 포함되어 있다면, HTML 형식을 사용하여 답변을 받을 수 있습니다. 단순히 텍스트로 답변을 받고 싶다면, 텍스트를 사용할 수 있습니다. 기본값은 HTML입니다.

Possible values:
offsetintegerOptional

Offset은 페이지에서 첫 번째 항목의 순위 번호를 지정할 수 있게 합니다.

limitintegerOptional

제한은 한 페이지에 반환되는 객체 수를 설정할 수 있게 해줍니다. 최대값과 기본값은 1000입니다.

Responses
200

FAQ 검색 성공

application/json
post
/webapi/faqs
200

FAQ 검색 성공

Q&A 추가

post

이 API를 사용하여 새로운 Q&A를 추가하거나 기존 Q&A를 업데이트할 수 있습니다.

Authorizations
API-KEYstringRequired

Your API key for authentication

Header parameters
AGENT-EMAILstringOptional

Optional: Email of the agent to use for this request

USER-EMAILstringOptional

Optional: Email address to associate with the user

OWN-USER-IDstringOptional

Optional: User ID to identify or create a user

Body
questionstringOptional

Q&A의 질문 부분.

similarQuestionsstring[]Optional

같은 답을 가지고 있는 유사한 질문들.

answerstringOptional

Q&A의 답변 부분. 데이터베이스에 동일한 질문이 존재하는 경우, 해당 답변이 기존 답변을 대체합니다.

hashtagsstring[]Optional

Q&A에 해시태그 추가됨.

statusstring · enumOptional

켜짐 또는 꺼짐. 켜짐으로 설정하면, 등록된 Q&A가 Q&A 검색에 활성화됩니다.

Possible values:
memostringOptional

에이전트와 공유할 Q&A에 대한 메모.

target_folder_idstringOptional
allowOtherAgentsViewbooleanOptional
allowOtherUsersViewbooleanOptional
Responses
200

FAQ 생성이 완료되었습니다.

application/json
post
/webapi/register_faq
200

FAQ 생성이 완료되었습니다.

Q&A 업데이트

put

이 API를 사용하여 기존 Q&A를 업데이트할 수 있습니다.

Authorizations
API-KEYstringRequired

Your API key for authentication

Header parameters
AGENT-EMAILstringOptional

Optional: Email of the agent to use for this request

USER-EMAILstringOptional

Optional: Email address to associate with the user

OWN-USER-IDstringOptional

Optional: User ID to identify or create a user

Body
idstringOptional

업데이트할 Q&A의 ID.

questionstringOptional

Q&A의 질문 부분.

similar_questionsstring[]Optional

같은 답을 가진 유사한 질문들.

answerstringOptional

Q&A의 답변 부분.

hashtagsstring[]Optional

Q&A에 해시태그 추가됨.

statusstring · enumOptional

켜짐 또는 꺼짐. 켜짐으로 설정하면 Q&A 검색에 Q&A가 활성화됩니다.

Possible values:
target_folder_idstringOptional
allowOtherAgentsViewbooleanOptional
allowOtherUsersViewbooleanOptional
Responses
200

FAQ가 성공적으로 업데이트되었습니다.

application/json
put
/webapi/register_faq
200

FAQ가 성공적으로 업데이트되었습니다.

Q&A 삭제

post

이 API를 사용하여 Q&A를 삭제할 수 있습니다.

Authorizations
API-KEYstringRequired

Your API key for authentication

Header parameters
AGENT-EMAILstringOptional

Optional: Email of the agent to use for this request

USER-EMAILstringOptional

Optional: Email address to associate with the user

OWN-USER-IDstringOptional

Optional: User ID to identify or create a user

Body
idstringOptional

삭제하려는 Q&A의 ID.

Responses
200

자주 묻는 질문이 성공적으로 삭제되었습니다.

application/json
post
/webapi/delete_faq

Q&A 업로드

post

이 API를 사용하여 tsv, csv, xlsx 및 zip 형식으로 여러 Q&A를 업로드할 수 있습니다.

Authorizations
API-KEYstringRequired

Your API key for authentication

Header parameters
AGENT-EMAILstringOptional

Optional: Email of the agent to use for this request

USER-EMAILstringOptional

Optional: Email address to associate with the user

OWN-USER-IDstringOptional

Optional: User ID to identify or create a user

Body
filestring · binaryOptional

로컬 Q&A 파일 위치입니다. xlsx, tsv, csv, zip 파일이 지원됩니다.

Responses
200

FAQ 파일 업로드 성공

application/json
post
/webapi/upload_faq_file

Q&A Feedback

post

This API lets you give or cancel feedback given to a Q&A pair for a search query.

Authorizations
API-KEYstringRequired

Your API key for authentication

Header parameters
AGENT-EMAILstringOptional

Optional: Email of the agent to use for this request

USER-EMAILstringOptional

Optional: Email address to associate with the user

OWN-USER-IDstringOptional

Optional: User ID to identify or create a user

Body
querystringRequired

The query you want to give or cancel feedback for, toward the Q&A.

idstringRequired

The ID for the Q&A you want to give or cancel feedback for the query. It is created whenever a Q&A search happens and bound to the query and the Q&A pair. It can be retrieved using the Q&A API above.

isPositiveboolean | nullableRequired

When the value is true, positive feedback is given to the Q&A for the query. When it's false, negative feedback is given. When it's null, it cancels the feedback.

Responses
200

Feedback submitted successfully

application/json
post
/webapi/faq_feedback
200

Feedback submitted successfully

Q&A 질의 기록

get

REST API와 Alli 대시보드를 통해 수행된 과거 Q&A 검색 결과를 반환합니다.

Authorizations
API-KEYstringRequired

Your API key for authentication

Query parameters
limitintegerOptional

가장 이른 날짜는 (날짜는 YYYY-MM-DD 형식이어야 합니다)입니다.

offsetintegerOptional

DESC(최신 쿼리가 먼저 오는 것을 의미) 또는 ASC(가장 초기의 쿼리가 먼저 오는 것을 의미)일 수 있습니다.

endDatestringOptional

쿼리에 나타났어야 할 용어

startDatestringOptional

The earliest date from which you want to get history (dates should be in the form YYYY-MM-DD)

orderstringOptional

Can either be DESC (meaning latest queries come first), or ASC (meaning earliest queries come first)

searchTermstringOptional

The term that should have appeared in the query

Header parameters
AGENT-EMAILstringOptional

Optional: Email of the agent to use for this request

USER-EMAILstringOptional

Optional: Email address to associate with the user

OWN-USER-IDstringOptional

Optional: User ID to identify or create a user

Responses
200

성공적인 대응

application/json
get
/webapi/faq_histories
200

성공적인 대응

질문과 답변 후보들

get

이 API를 사용하여 멤버의 미답변 질문 목록을 얻을 수 있습니다. 미답변 질문 목록은 Alli 내에서 '후보'로 명명됩니다.

Authorizations
API-KEYstringRequired

Your API key for authentication

Query parameters
hashtagsstring[]Optional

후보의 상태를 확인하십시오. 이 값은 ALL, ACTIVE, ARCHIVED 중 하나일 수 있습니다.

searchTermstringOptional

Offset은 페이지의 첫 번째 항목의 순위 번호를 지정할 수 있게 해줍니다.

orderstringOptional

제한은 한 페이지에 반환되는 객체 수를 설정할 수 있습니다. 최대값은 100입니다.

statestringOptional

Status of the candidates to see. It can be ALL or ACTIVE or ARCHIVED.

offsetintegerOptional

offset allows you to specify the ranking number of the first item on the page.

limitintegerOptional

limit allows you to set the number of objects returned on one page. The maximum value is 100.

Header parameters
AGENT-EMAILstringOptional

Optional: Email of the agent to use for this request

USER-EMAILstringOptional

Optional: Email address to associate with the user

OWN-USER-IDstringOptional

Optional: User ID to identify or create a user

Responses
200

성공적인 답변

application/json
get
/webapi/faq_candidates
200

성공적인 답변

일일 FAQ 수

get

지정된 날짜 범위 내에서 FAQ의 Q&A 일일 트렌드.

Authorizations
API-KEYstringRequired

Your API key for authentication

Header parameters
AGENT-EMAILstringOptional

Optional: Email of the agent to use for this request

USER-EMAILstringOptional

Optional: Email address to associate with the user

OWN-USER-IDstringOptional

Optional: User ID to identify or create a user

Body
startDatestringOptional

YYYY-MM-DD 형식의 조회할 날짜 범위의 시작.

endDatestringOptional

YYYY-MM-DD 형식으로 조회할 날짜 범위의 끝.

Responses
200

성공적으로 일일 FAQ 수를 검색했습니다.

application/json
get
/webapi/faq_daily_count
200

성공적으로 일일 FAQ 수를 검색했습니다.

일일 FAQ 분석

get

가장 자주 묻는 Q&A에 대한 분석 정보.

Authorizations
API-KEYstringRequired

Your API key for authentication

Header parameters
AGENT-EMAILstringOptional

Optional: Email of the agent to use for this request

USER-EMAILstringOptional

Optional: Email address to associate with the user

OWN-USER-IDstringOptional

Optional: User ID to identify or create a user

Body
topNintegerOptional

가장 자주 묻는 질문과 답변의 상위 N개. N의 최대값은 20입니다. N으로 1, 5, 10 또는 20을 사용해 주세요.

startDatestringOptional

YYYY-MM-DD 형식의 조회할 날짜 범위의 시작.

endDatestringOptional

YYYY-MM-DD 형식으로 조회할 날짜 범위의 종료일.

Responses
200

FAQ 분석을 성공적으로 가져왔습니다.

application/json
get
/webapi/faq_daily_analytics
200

FAQ 분석을 성공적으로 가져왔습니다.

Q&A 후보들

post

시스템에 새로운 Q&A 후보를 등록합니다.

Authorizations
API-KEYstringRequired

Your API key for authentication

Header parameters
AGENT-EMAILstringOptional

Optional: Email of the agent to use for this request

USER-EMAILstringOptional

Optional: Email address to associate with the user

OWN-USER-IDstringOptional

Optional: User ID to identify or create a user

Body
queriesstring[]Required

등록하고자 하는 모든 쿼리 목록

Responses
200

후보 등록 완료

application/json
post
/webapi/add_faq_candidates
200

후보 등록 완료

Last updated

Was this helpful?