Botpress v12 및 Smooch를 사용하여 WhatsApp 챗봇을 쉽게 구축하는 방법
챗봇은 비즈니스에 매우 유용한 도구가 될 수 있으며, 이 게시물에서는 직접 구축하는 데 필요한 모든 단계를 제공합니다. Botpress v12 및 Smooch (현재는 Zendesk의 선샤인 대화로 알려짐)를 사용하여 WhatsApp에 연결하고 다양한 질문에 응답하는 간단한 Q&A 봇을 구축하는 방법을 보여 드리겠습니다.
봇 구축 전
시작하기 전에 몇 가지 서비스를 설정하고 구성해야 하는데 , 이를 위해서는 비즈니스 이메일과 하드 드라이브에 최소 64GB의 공간이 필요합니다.
다운로드 Botpress
Botpress v12 문서 페이지로 이동하여 원하는 버전의 Botpress 을 다운로드합니다.
스무치에서 계정 만들기
Botpress v12가 다운로드되는 동안 스무치/선샤인 대화 가입 페이지로 이동합니다. 가입 절차를 완료한 후에는 앱을 생성하고 이름을 지정해야 합니다.
이쯤 되면 Botpress 다운로드가 완료되었을 것입니다. '바이너리' 옵션으로 다운로드한 경우, 다운로드 내용을 원하는 디렉터리에 압축을 풀기만 하면 됩니다.
응록 다운로드
세 번째로 사용할 서비스는 여기에서 다운로드할 수 있는 Ngrok입니다. Ngrok은 로컬 컴퓨터에서 실행 중인 Botpress 서버를 웹에 공유하는 데 사용할 무료 서비스입니다. 사이트의 안내에 따라 다운로드하여 설치합니다. 이제 챗봇을 만들 준비가 되었습니다.
Smooch의 API 키로 Botpress 설정하기
챗봇을 시작하려면 먼저 Botpress v12의 압축을 푼 폴더를 열고 'bp' 파일을 실행해야 합니다. 그러면 챗봇이 시작되며 일부 모듈을 다운로드해야 합니다. 이 과정은 다소 시간이 걸리지만 한 번만 실행하면 이후 실행할 때마다 더 편리하게 사용할 수 있습니다.
Botpress 앱이 설정되는 동안 스무치에서 앱으로 다시 이동하여 설정을 선택합니다. 봇 이름 지정, 사진, 메시지 옵션, 앱 ID 및 API 키를 지정할 수 있는 옵션이 표시됩니다. API 키가 표시되면 새 API 키를 생성해야 합니다.
봇 생성 및 구성
Botpress v12 설정은 스무치에서 API 키를 생성할 때까지 완료되어야 합니다. 이 시점에서 콘솔에 Botpress 스튜디오를 열 수 있는 위치가 표시될 것입니다(저희의 경우 localhost:3000 ). 콘솔에 제공된 URL로 이동하여 관리자 계정에 가입합니다.
Botpress 을 처음 실행하는 것이므로 워크스페이스에 봇이 없는 것을 볼 수 있습니다. 봇을 만드는 옵션을 선택하고 이름을 지정합니다. 그러면 봇 ID 필드가 자동으로 채워집니다. 다음으로 봇 템플릿을 선택합니다(예: ' Botpress 기본 사항 배우기' 옵션).
이제 워크스페이스에 봇이 생겼음을 확인할 수 있습니다! 봇을 선택해 계속 진행하세요(이름을 클릭). 스튜디오 왼쪽에 세로로 뻗어 있는 막대가 시선을 끌 것입니다. 여기에 표시되는 옵션은 봇을 개발하는 동안 가장 많이 사용하는 옵션입니다. 여기서는 코드 편집기 옵션으로 시작하여 스튜디오에서 일련의 디렉터리를 열고 다음 단계로 넘어가겠습니다.
코드 편집기의 구성 아래에 두 개의 폴더가 표시됩니다. 지금은 현재 봇에 집중하세요.
구성에서 bot.config.json을 선택하고 '메시징'으로 스크롤합니다. 여기에서 'channels' 개체를 추가할 수 있으며, 여기에는 'smooch' 개체가 포함됩니다. Smooch에서 'enabled'라는 부울 값을 생성하고 참 값을 지정합니다. 그런 다음 'keyId' 및 'secret' 문자열( )을 생성해야 하며, 이 문자열은 각각 스무치 앱에서 생성한 API 키에서 ID와 비밀을 가져옵니다.
이 작업이 완료되면 bot.config.json을 저장하고 구성 아래의 글로벌 폴더로 이동하여 botpress.config.json을 엽니다. 빈 문자열로 설정된 'externalUrl'을 찾습니다. 이것은 매우 간단한 서비스이므로 사이트의 지침에 따라 봇이 실행될 포트를 Ngrok에 노출하기만 하면 됩니다. 그런 다음 돌아와서 HTTPS URL을 externalUrl 문자열에 붙여넣습니다.
파일을 저장하고 서버를 재시작한 다음 봇을 다시 엽니다. 오른쪽 하단의 '지금 훈련하기'를 클릭합니다. '지금 훈련'이 있던 자리에 '준비됨'이 표시될 것입니다.
봇과 대화하기
Smooch 앱으로 돌아가면 웹훅이 자동으로 구성된 것을 확인할 수 있습니다. 연동으로 돌아가서 WhatsApp을 선택한 다음 연결합니다. 이제 연동 모드를 선택합니다 . 이 가이드에서는 '샌드박스'가 잘 작동합니다.
'샌드박스 활성화'를 선택하고 안내에 따라 WhatsApp에서 지정한 번호로 메시지를 보내세요. WhatsApp용 Smooch 샌드박스가 성공적으로 연결되면 메시지를 받게 됩니다. 추가 메시지는 생성한 웹훅으로 전달됩니다.
이제 봇과 대화할 수 있습니다!
봇이 응답하도록 하기
이제 빈 봇이 생겼고 연동이 제대로 작동한다는 메시지를 받았으니, 우리가 무언가를 말한 후 봇의 초기 응답부터 시작해 보겠습니다.
이렇게 하려면 Botpress 스튜디오에서 왼쪽 사이드바 메뉴의 네 번째 옵션인 Q&A로 이동합니다. 도구 모음에서 더하기 기호를 탭하여 질문을 추가하라는 메시지가 표시되면 이 메시지에 따라 질문을 추가합니다. 그러면 질문과 답변 모두에 대한 텍스트를 입력할 수 있는 화면이 나타납니다. 이 경우 질문을 '가장 좋아하는 과일은 무엇인가요?"로 설정했습니다. 답변은 '제가 가장 좋아하는 과일은 대부분의 사람들이 야채로 착각하는 토마토입니다!'입니다. 이 과정을 몇 번 반복하여 매번 새로운 질문과 답변을 제공할 수 있습니다.
모든 새 질문의 오른쪽 상단에 불완전하다고 표시되어 있는 것을 확인할 수 있습니다. 이 위에 마우스를 가져가면 Q&A에서 정확히 일치하는 항목만 사용한다는 메시지가 표시됩니다. 이는 봇의 머신 러닝을 활성화하고 돕기 위해 다양한 질문 방식을 추가해야 하기 때문입니다. Q&A에 질문에 대한 여러 가지 변형을 추가할 수 있으며, 많이 추가할수록 좋습니다.
마지막으로 봇과 대화를 나누고 몇 가지 간단한 질문을 한 다음 답변을 받을 수 있습니다. 직접 만든 질문 중 하나를 봇에게 물어보고 답변을 받으면 됩니다. 매우 간단한 연동이므로 이 봇에 대해 구성된 매개 변수를 벗어난 부적절한 질문이나 메시지는 무시됩니다.
결론
이 가이드에서는 Botpress v12로 챗봇을 성공적으로 만드는 데 필요한 서비스에 가입하는 방법을 다루었습니다. 여기에는 스무치, 응록, Botpress 자체가 포함되었습니다. 서비스를 구성하고, 함께 통합하고, 봇과 대화해 보았습니다. 봇과 대화하면서 다양한 입력을 처리하는 방식을 확인했고, 부적절하거나 구체적이지 않은 입력에 어떻게 반응하는지 주목했습니다. API를 호출하고 플로우로 작업하는 보다 강력한 봇을 구축하고자 한다면 화성 탐사선 사진 촬영 챗봇 예시를 살펴보는 것이 좋습니다. WhatsApp을 넘어 다른 채널과 챗봇을 통합하고 싶다면 YouTube의 Botpress v12 채널 통합 재생목록을 확인하세요. 행복한 봇 만들기! :robot:
단계별 요약
이 가이드 전문을 읽어보시길 권장하지만, 주요 단계에 대한 대략적인 요약은 다음과 같습니다:
1. 준비
- https://v12 에서 botpress 다운로드 botpress.com/
- app.smooch.io에서 가입하기
- 스무치에서 앱을 만들고 이름을 지정하세요.
- Botpress 다운로드 내용을 원하는 디렉터리에 압축을 풉니다.
- https://ngrok.com/ 에서 응록을 다운로드하고 사이트의 설치 지침에 따라 설치하세요.
2. 시작
- 폴더 열기 Botpress 폴더가 다음 위치로 추출되었습니다.
- "bp" 파일 실행
- 적절한 모듈이 다운로드될 때까지 기다려주세요.
3. 생성
- API 키 생성
- Botpress 설정이 완료될 때까지 기다립니다.
- 콘솔에서 Botpress 스튜디오를 열 위치를 알려줍니다(예: 제 경우에는 localhost:3000).
- 콘솔에 제공된 URL로 이동합니다.
- 관리자 계정으로 가입하기
- 봇 옵션 만들기 및 이름 지정
- 봇 템플릿 선택(예: "빈 봇")
- 이제 워크스페이스에 봇이 생깁니다.
- 이름을 클릭하여 봇을 클릭합니다.
- 코드 편집기 옵션으로 이동
4. 4. 구성
- 코드 편집기의 구성에서 현재 봇 폴더를 찾습니다.
- 구성에서 bot.config.json을 선택하고 '메시징'으로 스크롤합니다.
- "채널" 객체 추가("스무치" 객체가 포함됨)
- 스무치에서 "enabled"라는 부울 값을 생성하고 참 값을 지정합니다.
- 문자열 "keyId" 및 "secret"를 생성합니다(앞서 Smooch에서 생성한 API 키에서 ID와 비밀을 가져옵니다).
- bot.config.json 저장
- 구성으로 이동
- botpress.config.json 열기
- 'externalUrl'을 찾습니다(빈 문자열로 설정됨).
- 파일 저장
- 서버 다시 시작
- 봇 다시 열기
- "지금 기차"를 클릭하세요.
- "준비됨"이 "지금 기차"를 대체합니다.
- 스무치로 돌아가서 자동으로 구성된 웹훅을 확인합니다.
- 통합으로 이동
- WhatsApp을 선택하고 연결
- 통합 모드 선택(예: "샌드박스" 사용)
- '샌드박스 활성화'를 선택하고 지침에 따라 WhatsApp에서 지정된 번호로 메시지를 보내세요.
- 메시지 수신 여부 확인
- 추가 메시지는 웹훅으로 전달됩니다.
- 이제 봇과 대화할 수 있습니다!
5. 봇과 대화하기
- 봇에게 질문하기
- 답변 읽기
- "틀린" 질문을 하면 응답하지 않으므로 주의하세요.
공유하세요:
AI에 대한 최신 정보를 확인하세요. chatbots