봇 구성 문제 해결
적용 대상: SDK v4
봇은 응답할 수 없거나, 오류를 throw하거나, 한 채널에서 작업하지만 다른 채널에서는 작업하지 않는 등 다양한 유형의 오류를 생성할 수 있습니다. 봇 문제 해결의 첫 번째 단계는 웹 채팅 테스트하는 것입니다. 이렇게 하면 문제가 봇(봇이 채널에서 작동하지 않음) 또는 특정 채널(봇은 일부 채널에서 작동하지만 다른 채널에서는 작동하지 않음)과 관련이 있는지 확인할 수 있습니다.
웹 채팅에서 테스트
- Azure Portal에서 봇 리소스를 엽니다.
- 웹 채팅 창에서 테스트를 엽니다.
- 봇에 메시지를 보냅니다.
봇이 예상 출력에 응답하지 않으면 웹 채팅 봇으로 이동해도 작동하지 않습니다. 그렇지 않으면 웹 채팅 작동하지만 다른 채널에서는 작동하지 않는 봇으로 이동합니다.
웹 채팅 봇이 작동하지 않음
봇이 작동하지 않는 데는 여러 가지 이유가 있을 수 있습니다. 대부분의 경우 봇 애플리케이션이 다운되어 메시지를 받을 수 없거나 봇이 메시지를 수신하지만 응답하지 못합니다. 가능한 원인은 다음과 같습니다.
- 봇이 다운되어 연결할 수 없습니다.
- 봇의 작동이 중단됩니다.
- 봇의 엔드포인트가 잘못되었습니다.
- 봇이 메시지를 성공적으로 수신했지만 응답할 수 없습니다.
봇이 실행 중인지 확인하려면 다음을 수행합니다.
- 개요 창을 엽니다.
- 메시징 엔드포인트를 복사하여 브라우저에 붙여넣습니다.
엔드포인트가 HTTP 오류 404 또는 405를 반환하는 경우 이는 봇에 연결할 수 있고 봇이 메시지에 응답할 수 있음을 의미합니다. 시간 제한 문제를 조사하려면 HTTP 5xx 오류 문서와 함께 시간 초과 또는 실패를 참조하세요.
엔드포인트에서 "이 사이트에 연결할 수 없음" 또는 "이 페이지에 연결할 수 없음" 오류를 반환한다면 봇이 다운되었고 봇을 다시 배포해야 한다는 의미입니다.
봇은 웹 채팅 작동하지만 다른 채널에서는 작동하지 않습니다.
웹 채팅에서 봇이 예상대로 작동하지 않고 다른 채널에서 실패할 경우 가능한 이유는 다음과 같습니다.
채널 구성 문제
봇의 사용자 이름 및 암호와 같은 채널 구성 매개 변수가 잘못 설정되었거나 외부에서 변경되었을 수 있습니다. 예를 들어 봇은 특정 페이지에 대한 Facebook 채널로 구성되었고 나중에 페이지가 삭제되었습니다. 가장 간단한 해결 방법은 채널을 제거하고 채널 구성을 다시 실행하는 것입니다.
지원되는 채널 목록 및 각 채널 구성 방법에 대한 지침은 봇을 채널에 커넥트 채널 목록을 참조하세요.
채널별 동작
일부 기능의 구현 방식은 채널마다 다를 수 있습니다. 예를 들어 모든 채널이 적응형 카드를 지원하지는 않습니다. 대부분의 채널은 작업(단추)을 지원하지만 채널별 방식으로 렌더링됩니다. 일부 메시지 유형이 다른 채널에서 작동하는 방식에 차이가 있는 경우 채널 참조 문서를 참조하세요.
다음은 개별 채널에 도움이 될 수 있는 링크입니다.
채널 중단
경우에 따라 일부 채널에서 서비스가 중단될 수 있습니다. 일반적으로 이러한 중단은 오래 지속되지 않습니다. 그러나 중단이 의심되는 경우 채널의 웹 사이트 또는 소셜 미디어를 참조하세요.
채널이 중단되었는지 확인하는 또 다른 방법은 테스트 봇(예: 간단한 Echo Bot)을 만들고 채널을 추가하는 것입니다. 테스트 봇이 일부 채널에서 작동하지만 다른 채널에서는 작동하지 않는 경우 문제는 프로덕션 봇에 없습니다.
추가 정보
해당 섹션의 봇 및 기타 디버깅 문서를 디버그하는 방법을 참조하세요.