Azure CLI를 사용하여 채널에 봇 커넥트

아티클
10/09/2024

채널은 통신 애플리케이션과 봇 간의 연결입니다. Azure에 등록된 봇은 채널을 사용하여 사용자와 통신할 수 있도록 합니다. 이 문서의 명령은 다양한 채널에 봇을 연결합니다. 자세한 내용은 채널에 봇 커넥트 참조하세요.

사전 요구 사항

Azure Cloud Shell에서 Bash 환경을 사용합니다. 자세한 내용은 Azure Cloud Shell의 Bash에 대한 빠른 시작을 참조하세요.
CLI 참조 명령을 로컬에서 실행하려면 Azure CLI를 설치합니다. Windows 또는 macOS에서 실행 중인 경우 Docker 컨테이너에서 Azure CLI를 실행하는 것이 좋습니다. 자세한 내용은 Docker 컨테이너에서 Azure CLI를 실행하는 방법을 참조하세요.
- 로컬 설치를 사용하는 경우 az login 명령을 사용하여 Azure CLI에 로그인합니다. 인증 프로세스를 완료하려면 터미널에 표시되는 단계를 수행합니다. 다른 로그인 옵션은 Azure CLI를 사용하여 로그인을 참조하세요.
- 메시지가 표시되면 처음 사용할 때 Azure CLI 확장을 설치합니다. 확장에 대한 자세한 내용은 Azure CLI에서 확장 사용을 참조하세요.
- az version을 실행하여 설치된 버전과 종속 라이브러리를 찾습니다. 최신 버전으로 업그레이드하려면 az upgrade를 실행합니다.

Azure에 배포된 봇입니다. 아직 없는 경우 자습서: Azure에서 봇 프로비전 및 자습서: 기본 봇 게시를 참조하세요.

샘플 명령

다음 섹션에서는 Azure CLI 명령을 사용하여 봇을 채널에 연결합니다. 이러한 예제에서는 리소스 그룹에 명명된 ContosoBot 봇을 ContosoBotRG 사용합니다.

이러한 채널 중 일부는 인증을 위해 애플리케이션에 연결하는 명령이 필요합니다. 테스트를 위해 이러한 명령을 실행하는 경우 실제 값을 사용하지 않으면 실패할 수 있습니다.

직접 회선

Direct Line은 봇을 모바일 앱, 웹 페이지 또는 기타 애플리케이션에 통합합니다. 자세한 내용은 직접 회선 정보를 참조 하세요.

이러한 샘플 명령은 az bot directline create를 사용하여 직접 회선 채널에 대한 연결을 만듭니다. 이 예제에서는 콘솔의 연결을 표시하고 연결을 삭제합니다.

az bot directline create --resource-group ContosoBotRG --name ContosoBot --disablev1
az bot directline show --resource-group ContosoBotRG --name ContosoBot
az bot directline delete --resource-group ContosoBotRG --name ContosoBot

Office 365 이메일

Office 365 전자 메일을 사용하여 봇이 사용자와 통신하도록 설정할 수 있습니다. 자세한 내용은 Office 365 전자 메일에 봇 커넥트 참조하세요.

이러한 샘플 명령은 az bot email create를 사용하여 Office 365 전자 메일 채널에 대한 연결을 만듭니다. 이 예제에서는 콘솔의 연결을 표시하고 연결을 삭제합니다.

az bot email create --resource-group ContosoBotRG --name ContosoBot \
   --email-address ContosoBot@outlook.com --password <password>
az bot email show --resource-group ContosoBotRG --name ContosoBot
az bot email delete --resource-group ContosoBotRG --name ContosoBot

Facebook

Facebook Messenger와 Facebook Workplace 모두에 봇을 연결할 수 있습니다. 두 플랫폼 모두에서 사용자와 통신할 수 있습니다. 자세한 내용은 Facebook에 봇 커넥트 참조하세요.

이러한 샘플 명령은 az bot facebook create를 사용하여 Facebook 채널에 대한 연결을 만듭니다. 이 예제에서는 콘솔의 연결을 표시하고 연결을 삭제합니다.

az bot facebook create --resource-group ContosoBotRG --name ContosoBot --appid <myAppId> \
   --page-id <myPageId> --secret <secret> --token <token>
az bot facebook show --resource-group ContosoBotRG --name ContosoBot
az bot facebook delete --resource-group ContosoBotRG --name ContosoBot

Microsoft Teams

Microsoft Teams와 통신하도록 봇을 구성할 수 있습니다. 자세한 내용은 Microsoft Teams에 봇 커넥트 참조하세요.

이러한 샘플 명령은 az bot msteams create를 사용하여 Microsoft Teams 채널에 대한 연결을 만듭니다. 이 예제에서는 콘솔의 연결을 표시하고 연결을 삭제합니다.

az bot msteams create --resource-group ContosoBotRG --name ContosoBot --calling-web-hook https://www.contosoapp.com/ \
   --enable-calling 
az bot msteams show --resource-group ContosoBotRG --name ContosoBot 
az bot msteams delete --resource-group ContosoBotRG --name ContosoBot

Skype

Skype와 통신하도록 봇을 구성할 수 있습니다. 자세한 내용은 Skype에 봇 커넥트 참조하세요.

이러한 샘플 명령은 az bot skype create를 사용하여 Skype 채널에 대한 연결을 만듭니다. 이 예제에서는 콘솔의 연결을 표시하고 연결을 삭제합니다.

az bot skype create --resource-group ContosoBotRG --name ContosoBot --enable-messaging --enable-screen-sharing
az bot skype show --resource-group ContosoBotRG --name ContosoBot 
az bot skype delete --resource-group ContosoBotRG --name ContosoBot

Slack

Slack을 통해 사용자와 통신하도록 봇을 구성할 수 있습니다. 자세한 내용은 Slack에 봇 커넥트 참조하세요.

이러한 샘플 명령은 az bot slack create를 사용하여 Slack 채널에 대한 연결을 만듭니다. 이 예제에서는 콘솔의 연결을 표시하고 연결을 삭제합니다.

az bot slack create --resource-group ContosoBotRG --name ContosoBot --client-id <clientid> \
   --client-secret <secret> --verification-token <token>
az bot slack show --resource-group ContosoBotRG --name ContosoBot
az bot slack delete --resource-group ContosoBotRG --name ContosoBot

SMS

이러한 샘플 명령은 az bot sms create를 사용하여 SMS 채널에 대한 연결을 만듭니다. 이 예제에서는 콘솔의 연결을 표시하고 연결을 삭제합니다.

az bot sms create --resource-group ContosoBotRG --name ContosoBot --account-sid <sid> --auth-token <token> \
   --phone <smsphonenumber> --is-validated
az bot sms show --resource-group BotRG
az bot sms delete --resource-group BotRG

Telegram을 통해 사용자와 통신하도록 봇을 구성할 수 있습니다. 자세한 내용은 봇을 Telegram에 커넥트 참조하세요.

이러한 샘플 명령은 az bot telegram create를 사용하여 Telegram 채널에 대한 연결을 만듭니다. 이 예제에서는 콘솔의 연결을 표시하고 연결을 삭제합니다.

az bot telegram create --resource-group ContosoBotRG --name ContosoBot --access-token <token> --is-validated
az bot telegram show --resource-group ContosoBotRG --name ContosoBot 
az bot telegram delete --resource-group ContosoBotRG --name ContosoBot

배포 정리

테스트를 위해 리소스 그룹을 만든 경우 az group delete 명령을 실행하여 리소스 그룹 및 리소스 그룹에 포함된 모든 항목을 제거합니다.

az group delete --name ContosoBotRG

채널에 대한 연결을 제거하려면 적절한 삭제 명령을 사용합니다.

이 문서에서 사용되는 Azure CLI 명령

이 문서에서는 다음 Azure CLI 명령을 사용합니다.

다음을 통해 공유