Desde hace ya tiempo quería contarte lo fácil que resulta hoy en día crear tus propios bots con Microsoft Bot Framework, el cual te permite adentrarte en este mundo con las herramientas que ya conoces. En este post quiero mostrarte además cómo este servicio puede apoyarse en Microsoft Azure como lugar para alojar tus bots y conseguir que este proceso sea aún más fácil.
Lo primero que debes hacer es descargarte un nuevo tipo de proyecto para Visual Studio. La plantilla puedes descargarla directamente desde este enlace y debes ubicarla tal cual en %USERPROFILE%\Documents\Visual Studio 2015\Templates\ProjectTemplates\Visual C#
Una vez hecho esto, ya deberías de ser capaz de crear proyectos de tipo Bot Application.
Como puedes ver, no son más que una aplicación ASP.NET MVC Api que contiene un controlador con una acción Post, la cual recibe los mensajes que el usuario envia al bot.
El ejemplo que viene por defecto es bastante básico, ya que sólo cuenta el numero de letras recibidos en el mensaje del usuario, pero te permitirá conocer todo el proceso desde que lo creas, lo despliegas y lo registras dentro de la plataforma.
Si ejecutas el proyecto, verás en el navegador la siguiente información:
Lo primero que aparece son las condiciones de uso que puedes redactar en el archivo default.htm de tu proyecto. Después se muestra el enlace donde puedes registrar tu bot, que te permitirá conectar el mismo con diferentes canales (chat web, Telegram, SMS, Skype, etc.). Por último puedes ver cuál es la URL por convención que debes utilizar para hacer llamadas a tu bot.
Antes de desplegarlo, es muy útil que pruebes el emulador de bots. Se trata de una aplicación de escritorio para Windows que podrás utilizar a modo de chat con el fin de comprobar que todo funciona correctamente. Puedes descargarlo desde el desde aquí. Los valores por defecto de la plantilla de Visual Studio estarán configurados en la parte superior del emulador.
Si ya has comprobado que todo funciona correctamente es el momento de publicar tu nuevo bot en Internet. Uno de los servicios que puedes utilizar para ello es App Service – API Apps. Para ello basta con hacer clic con el botón derecho sobre el proyecto > Publish y seleccionar la opción Microsoft Azure App Service.
Crea una nueva API App a través del asistente y publica el código fuente. Puedes modifcar el emulador con la URL de tu nueva API App para comprobar que todo funciona correctamente.
El último paso de este post es registrar tu nuevo bot dentro de la plataforma, con el fin de poder integrarlo con otros servicios. Antes de registrarlo debes cambiar el App ID en el archivo Web.config de la aplicación. Después accede a https://dev.botframework.com/bots/new y rellena el formulario con los datos del servicio. Los valores más importantes son el Endpoint ya que apunta a la URL donde está ejecutandose tu bot, en este caso la API App que acabas de crear.
y App ID del servicio que acabas de cambiar en el archivo de configuración de la aplicación.
Una vez generado el bot copia la primary app secret y actualiza el archivo web.config con la misma y despliega de nuevo la solución en tu API App.
Antes de despedirnos vamos a probar que nuestro bot es capaz de integrarse con uno de los canales que ofrece la plataforma, el Web Chat. Haz clic en la opción Get bot embed codes para recuperar el código HTML necesario para embeber un chat preconfigurado con tu bot.
En ese enlace serás capaz de recuperar un iframe y la clave necesaria para tener acceso al servicio. Para este ejemplo he copiado el mismo en una aplicación web como la siguiente:
<!DOCTYPE html>
<html>
<head>
<title></title>
<meta charset="utf-8" />
</head>
<body>
<iframe src="https://webchat.botframework.com/embed/botappgis?s=quhh3XVTk04.cwA.HAs.8-xPubLbPp-IiGPG9CEu3-Pw3Z7dZL8k82ZFex1Hy2M" style="height: 502px; max-height: 502px;"></iframe>
</body>
</html>
Si ejecutas el código podrás comprar que tu bot se integra correctamente con este canal y habrás completado el ciclo desde la creación, despliegue e integración con canales.
¡Saludos!