시작하기

sem.chat API을(를) 사용하면 프로그래밍 방식으로 대화를 관리하고, 메시지를 보내고, 분석에 액세스할 수 있습니다. 모든 API 요청에는 API 키를 사용한 인증이 필요합니다.

기본 URL

https://api.sem.chat/v1

인증

모든 요청의 Authorization 헤더에 API 키를 포함하세요.

Authorization: Bearer your_api_key_here

대화

대화 나열

GET /대화

귀하의 계정에 대한 모든 대화 목록을 검색하십시오.

매개변수 유형 설명
한도 정수 반환할 결과 수(최대 100개)
오프셋 정수 건너뛸 결과 수
상태 문자열 상태별 필터링: 활성, 종료, 대기 중

대화를 나누세요

GET /대화/{id}

모든 메시지를 포함하여 특정 대화의 세부정보를 검색합니다.

대화 만들기

POST /대화

프로그래밍 방식으로 새로운 대화를 시작하세요.

메시지

메시지 보내기

POST /대화/{id}/messages

기존 대화에 메시지를 보냅니다.

// Example request body { "content": "Hello, how can I help you today?", "sender": "agent" }

웹훅

대화 이벤트에 대한 실시간 알림을 받도록 웹후크를 설정하세요.

이용 가능한 이벤트

이벤트 설명
대화.시작됨 새로운 대화가 시작되었습니다
메시지.수신 방문자로부터 새 메시지를 받았습니다.
대화가 종료되었습니다. 대화가 종료되었습니다.
납.포획 연락처 정보가 수집되었습니다

비율 제한

API 요청은 공정한 사용을 보장하기 위해 제한됩니다.

계획 비율 제한
재판 요청 100개/시간
프로 요청 1,000개/시간
비즈니스 요청 10,000개/시간