Platform API 호출하기
Platform API 호출하기
만든 Botpress 에이전트를 외부 앱이나 서비스에서 호출해야 할 때는 Botpress Cloud API를 써요. Botpress의 Platform API는 클라우드 상의 에이전트와의 상호작용을 표준 REST 방식으로 다루는 진입점이에요.
언제 쓰나요
웹사이트나 모바일 앱, 백엔드 서비스에서 에이전트와 메시지를 주고받아야 할 때 Platform API를 호출해요. Botpress가 제공하는 Webchat 위젯을 쓰지 않고 자체 UI에서 대화를 구현하려는 경우에 특히 유용해요.
- 메시지 송수신: 사용자 메시지를 보내고 에이전트 응답을 받아요.
- 대화 관리: 세션과 대화 상태를 관리해요.
- 인테그레이션 자동화: 채널·도구 연결을 코드로 제어해요.
인증
Botpress Cloud API는 봇·에이전트별로 발급되는 토큰으로 인증을 처리해요. API 레퍼런스에서 각 엔드포인트의 인증 방식과 요청 형식을 확인한 다음, 발급받은 토큰을 헤더에 넣어 호출하면 돼요.
요청 형식과 응답 스키마는 Botpress의 공식 API 레퍼런스 문서에서 엔드포인트별로 정리되어 있어요. 웹훅이나 상호작용 API를 조합하면 실시간 메시지 흐름도 구현할 수 있고요.
다른 요소와 함께 쓰기
Platform API는 Webchat, Integrations, Botpress Desk와 함께 사용해서 완결된 서비스를 만들 수 있어요. 웹챗으로 프런트를 만들고, API로 백엔드 연동을 하고, 필요한 상황에서는 데스크로 사람 개입을 받는 구조를 짤 수 있죠.
더 알아보기
- 에이전트 만드는 법은 «Studio로 에이전트 만들기»와 «ADK로 에이전트 만들기»를 보세요.
- 채널·도구 연결은 «통합으로 연결하기»에서 다뤄요.