Bot Framework

Los usuarios de Microsfot Bot Framework pueden integrar sus bots existentes, o crear bots nuevos de forma sencilla.

BotFramework

Todos los tipos de conectores ofrecidos por Bot Framework comparten los mismos campos:

Field Value
Application ID The ID of your Bot Framework Application, can be obtained from the BF my apps section. El identificador o ID de tu aplicación en Bot Framework, el cuál puede ser obtenido desde la sección my apps.
Bot Handle Identificador de tu bot, especificado en el Tablero principal(o dashboard) de Bot Framework.
Bot Name Nombre púplico por el cuál los usuarios conocen al bot.
Bot Password Contraseña secreta del bot, obtenida en la sección my apps en Bot Framework.
Name Nombre identificador del conector en tu aplicación de la plataforma de Alan.

Crear aplicación en Bot Framework

Para crear un conector de éste tipo en Alan, se requiere tener una cuenta en Bot Framework, así como también una aplicación en ella.

A continuación detallamos los pasos para crear una aplicación en Bot Framework:

  1. Ir al sitio de Bot Framework.

    BF

    ​

  2. Ingresar con tu cuenta de Microsoft(Microsoft Account) haciendo click en el botón sign in o iniciar sesión de la parte superior derecha de la pantalla.

  3. Click en My Bots.

    NoBots

  4. Click en el botón de Register o registrar, para crear tu primer bot:

    Form1

  5. En la sección Bot Profile, ingresar el nombre de tu bot, el Handle o username, y una descripción para el bot. Asegúrate de recordar el Handle, ya que lo necesitarás posteriormente al configurar el conector en Alan.

    Form2

  6. En la sección de Configuration o configuración, hacer click en el botón Create Microsoft App ID and password.

    ARP

  7. En el campo App Name, ingresa el mismo nombre que habías elegido para tu bot anteriormente.

  8. hacer click en el botón de Save o guardar.

    ARP2

  9. Copiar el App ID que se generó y pegarlo en el campo App ID que se encuentra en la sección de Configuration, como mostramos en el paso 6. Este identificador que se generó es el Microsoft Application ID necesario posteriormente para la configuración del conector en Alan, por lo que guardalo en algún lugar.

  10. Hacer click en el botón de Generate an app password to continue (o generar una contraseña en la aplicación para continuar).

BF-P

​

  1. Copia la contraseña generada y guardala en algún lugar seguro, ya que es la única vez que se podrá ver. Esta contraseña también deberá ser ingresada posteriormente al configurar el conector en Alan.

  2. Ahora vuelve a la sección o formulario de Configuration o configuración.

    BF-C

  3. Necesitarás ingresar el campo de Messaging endpoint, el cuál deberá tener el siguiente formato:

    https://stream.lastlab.io/bot-framework/bot/webhook/YOUR-APPLICATION-ID

    Reemplaza YOUR-APPLICATION-ID con el App ID generado en pasos previos(en nuestro caso, sería 0f0b9169-5974-4500-b514-1cb6e7861835).

    Por lo que nuestro Messaging endpoint quedaría así:

    https://stream.lastlab.io/bot-framework/bot/webhook/0f0b9169-5974-4500-b514-1cb6e7861835

    Por lo que ingresa ese enlace en el campo Messaging Endpoint.

    Config

  4. Ve a la parte inferior del formulario.

    Form4

  5. Lee los documentos adjuntos y habilita la opción de I agree o Estoy de acuerdo con. Finalmente haz click en el botón de Register o registrar.

  6. Vuelve a la sección de Conectores en Alan y continúa con la configuración de dicho conector.

    BotFramework

  7. Elige la plataforma de Bot Framework que desees, en el ejemplo, se utiliza Slack.

  8. Ingresa el App ID en su campo correspondiente, al igual que con el Bot handle, Bot Name y Bot Password.

  9. Por último ingresa un nombre para tu conector en Alan, de manera que puedas distinguirlo facilmente y haz click en el botón de Save o guardar para finalizar la creación del conector.

En la página de administración de Bot Framework, puedes añadir canales a tu aplicación y testear su funcionamiento desde ahi.

En casos de plataformas soportadas nativamente por Alan, como lo es por ejemplo Facebook Messenger, se recomienda utilizar el conector nativo, en vez de utilizar el ofrecido por Bot Framework. De esta manera podemos garantizar la mejor integración y un desarrollo constante por parte de nuestro equipo.

Si encuentas algún error en esta documentación, o te gustaría enviarnos alguna sugerencia, puedes escribirnos un correo electrónico a soporte@alan.sh para que puedamos tenerlo en cuenta en futuras actualizaciones.