[챗봇/ASP.NET] C#으로 Microsoft Azure 서버에 카카오톡 예제 스킬 서버 구축하기

지난 포스팅에서 카카오톡 챗봇 스킬 서버가 무엇인지, 그리고 윈도우 기반에서 nvm 및 nodejs를 이용한 예제 스킬 서버를 실행하고 오픈 빌더 스킬에 연동해 보았습니다.

[챗봇] 윈도우에서 카카오톡 챗봇을 위한 예제 스킬 서버 구축하기

이번 포스팅에서는 좀 더 친숙한 C#으로 코드를 구현하고, Microsoft Azure 서버에 게시하여 오픈 빌더 스킬에 연동하는 방법을 소개하겠습니다.

Azure 서버를 이용한 스킬 서버 다이어그램

따라 하기

1. Microsoft Azure 가입하기

Microsoft Azure 서비스는 유료이지만, 회원가입 후 1년 간은 무료로 이용이 가능합니다(2021-02-14 기준). 아래 공식 홈페이지에 접속하여 Azure 서비스에 가입해 보겠습니다.

공식 홈페이지: 링크

지금 Azure 체험 계정 만들기 | Microsoft Azure

홈페이지 접속 후 계정 생성 버튼을 클릭합니다.

Azure 공식 홈페이지

Microsoft 계정 로그인 후 아래와 같이 Azure 체험 계정을 생성하기 위해 기본 정보를 입력합니다.

Azure 체험 계정 생성하기

ID 검증을 위해 카드 정보도 입력합니다. 결제되는 것이 아니니 걱정 안 하셔도 됩니다.

카드로 ID 검증 화면

마지막으로 계약 동의를 하면 가입 절차가 끝납니다.

계약 동의 화면

가입이 완료되면 아래와 같은 페이지가 표시됩니다.

가입 완료 화면

2. ASP.NET 프로젝트 생성하기

우선 아래와 같이 Visual Studio에 ASP.NET 및 웹 개발 구성요소가 설치되어 있는지 확인해 보세요. 만약 없다면 구성요소를 설치해야 합니다.

Visual Studio ASP.NET 개발 구성 요소 설치하기

주의

 

 

참고로 이전에 작업했던 프로젝트는 Visual Studio 2017이었는데, 최근에 다시 시도해보니 기본 프로젝트에서 ASP.NET 관련 에러가 무수히 표시되더군요. Visual Studio 2019로 시도해보니 문제는 없었습니다. 혹시 같은 현상이 있다면 Visual Studio 2019로 시도해 보세요.

새 프로젝트를 생성합니다.

ASP.NET Core 프로젝트 생성하기

ASP.NET Core 웹 응용 프로그램 프로젝트를 생성합니다.

ASP.NET Core 웹 애플리케이션 선택

프로젝트의 이름은 ExamSkillServer라고 지정했습니다.

프로젝트 이름 설정

마지막으로 API 항목을 선택합니다.

API 항목 선택

프로젝트가 생성되면 아래와 같이 WeatherForecastController.cs가 보입니다. 기본 프로젝트 예시로 일기 예보 관련된 내용이 추가된 겁니다.

생성된 기본 프로젝트

그럼 우리는 챗봇 스킬 서버를 위한 새로운 컨트롤러를 추가해 보겠습니다. 아래와 같이 컨트롤러를 추가합니다.

컨트롤러 추가하는 모습

그리고 아래와 같이 API의 아래 항목을 선택합니다.

API의 읽기/쓰기 동작이 포함된 API 컨트롤러 추가

그리고 이름에는 sayHello.cs로 지정합니다.

이름 변경 후 컨트롤러 추가

완료 후 아래의 코드가 자동 생성됩니다.

using Microsoft.AspNetCore.Mvc;
using System;
using System.Collections.Generic;
using System.Linq;
using System.Threading.Tasks;

namespace ExamSkillServer.Controllers
{
    [Route("api/[controller]")]
    [ApiController]
    public class sayHello : ControllerBase
    {
        // GET: api/<sayHello>
        [HttpGet]
        public IEnumerable<string> Get()
        {
            return new string[] { "value1", "value2" };
        }

        // GET api/<sayHello>/5
        [HttpGet("{id}")]
        public string Get(int id)
        {
            return "value";
        }

        // POST api/<sayHello>
        [HttpPost]
        public void Post([FromBody] string value)
        {
        }

        // PUT api/<sayHello>/5
        [HttpPut("{id}")]
        public void Put(int id, [FromBody] string value)
        {
        }

        // DELETE api/<sayHello>/5
        [HttpDelete("{id}")]
        public void Delete(int id)
        {
        }
    }
}

이제 빌드하고 실행하면 아래와 같은 페이지가 생성될 것입니다.

실행된 모습

위 예시 페이지의 주소는 https://localhost:44372/swagger/index.html입니다. 이 주소를 https://localhost:44372/api/sayHello로 변경하면 아래와 같이 표시됩니다.

api/sayHello 페이지 출력 모습

위 페이지는 아래의 코드가 실행된 결과입니다.

// GET: api/<sayHello>
[HttpGet]
public IEnumerable<string> Get()
{
	return new string[] { "value1", "value2" };
}

이제 챗봇으로부터 받은 POST 메서드에 대한 응답을 만들어야 합니다. 기존 HttpPost 메서드에 대한 코드를 아래와 같이 변경합니다.

// POST api/<sayHello>
[HttpPost]
public dynamic Post(dynamic value)
{
	Dictionary<string, object> response = new Dictionary<string, object>();

	try
	{
		Dictionary<string, object> text = new Dictionary<string, object>();
		Dictionary<string, object> simpleText = new Dictionary<string, object>();
		List<Dictionary<string, object>> outputs = new List<Dictionary<string, object>>();
		Dictionary<string, object> template = new Dictionary<string, object>();

		text.Add("text", "hello I'm Ryan");
		simpleText.Add("simpleText", text);
		outputs.Add(simpleText);

		template.Add("outputs", outputs);
		response.Add("version", "2.0");
		response.Add("template", template);
	}
	catch (Exception e)
	{

	}

	return response;
}

빌드하면 에러 없이 성공할 것입니다. 이제 Azure 서버에 게시할 차례입니다. 프로젝트의 게시 메뉴를 클릭합니다.

프로젝트의 게시 메뉴

아래처럼 게시 창이 표시되면 Azure를 선택합니다.

대상 선택 화면

특정 대상으로는 Azure App Service(Windows)를 선택합니다.

특정 대상 선택 화면

Azure 계정 로그인 화면이 표시되는데요. 가입한 Azure 계정으로 로그인합니다.

Azure 계정 로그인 화면

로그인이 완료되면 업로드 가능한 App Service 목록이 표시됩니다. 처음 가입했다면 목록이 없을 텐데요. 우측의 추가 버튼을 클릭하여 App Service를 추가합니다.

App Service 화면

아래와 같이 이름을 입력하고 만들기 버튼을 클릭합니다.

App Service 생성 화면

App Service 생성이 완료되면 아래의 화면으로 전환됩니다. 다음 버튼을 클릭합니다.

App Service 선택 화면

API 관리 단계는 건너뛰고 마침 버튼을 클릭합니다.

API 관리 화면

이제 게시 화면에서 게시 버튼을 클릭하여 업로드합니다.

게시 화면

출력 창에 빌드 및 게시 작업이 성공했다는 메시지가 보입니다.

출력 창 화면

그리고 Microsoft Azure 페이지에 접속한 후 App Service 버튼을 클릭합니다.

Azure 홈 화면

ExamSkillServer가 정상적으로 실행 중인 것을 확인할 수 있습니다.

App Service 상태 확인

3. 오픈 빌더에서 Azure 스킬 서버 연동하기

이제 마지막 단계입니다. 오픈 빌더 사이트에 접속한 후 스킬을 생성합니다. 그리고 URL 입력에 위에서 생성한 App Service 주소에 /api/sayHello를 붙인 주소를 입력합니다.

오픈 빌더 스킬 화면

스킬 서버로 전송 버튼을 클릭하면 응답을 확인할 수 있습니다.

스킬 서버 응답 확인

이렇게 생성된 스킬은 특정 블록에 연결하여 응답하게 만들 수 있습니다.

블록에 스킬 연결하기

이런 식으로 결과를 얻을 수 있습니다.

스킬 서버로 응답한 메시지

정리

여기까지 잘 따라 하셨나요? 사실 에러가 발생할 부분이 없어서 문제없이 잘 따라 하셨을 거라 생각됩니다. 본문에서는 Microsoft Azure 서버를 사용했는데 어쨌든 1년 무료 기간만 사용이 가능합니다. 무료 기간이 끝나면 유료 결제를 진행해야 하는데요. 다음 포스팅에서는 Synology NAS를 이용하여 ASP.NET 서비스를 운영하는 방법을 소개하겠습니다.