Conexión del bot a canales con la CLI de Azure

Un canal es una conexión entre una aplicación de comunicación y un bot. Un bot, registrado con Azure, usa canales para permitir la comunicación con los usuarios. Los comandos de este artículo conectan un bot a varios canales. Para obtener más información, consulta Conectar un bot a los canales.

Requisitos previos

• Use el entorno de Bash en Azure Cloud Shell. Para más información, consulte Inicio rápido para Bash en Azure Cloud Shell.

  

• Si prefiere ejecutar comandos de referencia de la CLI localmente, instale la CLI de Azure. Si utiliza Windows o macOS, considere la posibilidad de ejecutar la CLI de Azure en un contenedor Docker. Para más información, vea Ejecución de la CLI de Azure en un contenedor de Docker.

  • Si usa una instalación local, inicie sesión en la CLI de Azure mediante el comando az login. Siga los pasos que se muestran en el terminal para completar el proceso de autenticación. Para ver otras opciones de inicio de sesión, consulte Inicio de sesión con la CLI de Azure.

  • En caso de que se le solicite, instale las extensiones de la CLI de Azure la primera vez que la use. Para más información sobre las extensiones, consulte Uso de extensiones con la CLI de Azure.

  • Ejecute az version para buscar cuál es la versión y las bibliotecas dependientes que están instaladas. Para realizar la actualización a la versión más reciente, ejecute az upgrade.

• Un bot implementado en Azure. Si aún no tiene uno, consulte Tutorial: Aprovisionamiento de un bot en Azure y Tutorial: Publicación de un bot básico.

Comandos de ejemplo

En las secciones siguientes se usan comandos de la CLI de Azure para conectar un bot a un canal. En estos ejemplos se usa un bot denominado ContosoBot en el ContosoBotRG grupo de recursos.

Algunos de estos canales requieren que el comando se conecte con la aplicación para autenticarse. Si ejecuta estos comandos con fines de prueba, pueden producir un error si no usa valores reales.

Direct Line

Direct Line integra el bot en una aplicación móvil, una página web u otras aplicaciones. Para más información, consulte Acerca de Direct Line.

Estos comandos de ejemplo crean una conexión al canal de Direct Line mediante az bot directline create. En el ejemplo se muestra la conexión en la consola y se elimina la conexión.

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

Correo electrónico de Office 365

Puede permitir que el bot se comunique con los usuarios mediante el correo electrónico de Office 365. Para obtener más información, consulte Conectar un bot al correo electrónico de Office 365.

Estos comandos de ejemplo crean una conexión al canal para correo electrónico de Office 365 mediante az bot email create. En el ejemplo se muestra la conexión en la consola y se elimina la conexión.

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

Puede conectar el bot tanto a Facebook Messenger como a Facebook Workplace. Puede comunicarse con los usuarios en ambas plataformas. Para obtener más información, consulte Conectar un bot a Facebook.

Estos comandos de ejemplo crean una conexión al canal de Facebook mediante az bot facebook create. En el ejemplo se muestra la conexión en la consola y se elimina la conexión.

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

Puede configurar el bot para comunicarse con Microsoft Teams. Para obtener más información, consulte Conectar un bot a Microsoft Azure.

Estos comandos de ejemplo crean una conexión al canal de Microsoft Teams mediante az bot msteams create. En el ejemplo se muestra la conexión en la consola y se elimina la conexión.

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

Puede configurar el bot para comunicarse con Skype. Para obtener más información, consulte Conectar un bot a Skype.

Estos comandos de ejemplo crean una conexión al canal de Skype mediante az bot skype create. En el ejemplo se muestra la conexión en la consola y se elimina la conexión.

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

Puede configurar el bot para que se comunique con los usuarios a través de Slack. Para obtener más información, consulte Conectar un bot a Slack.

Estos comandos de ejemplo crean una conexión al canal de Slack mediante az bot slack create. En el ejemplo se muestra la conexión en la consola y se elimina la conexión.

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

Estos comandos de ejemplo crean una conexión al canal para SMS mediante az bot sms create. En el ejemplo se muestra la conexión en la consola y se elimina la conexión.

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

Puede configurar el bot para que se comunique con los usuarios a través de Telegram. Para obtener más información, consulte Conectar un bot a Telegram.

Estos comandos de ejemplo crean una conexión al canal para Telegram mediante az bot telegram create. En el ejemplo se muestra la conexión en la consola y se elimina la conexión.

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 

Limpieza de la implementación

Si ha creado un grupo de recursos para realizar pruebas, ejecute el comando az group delete para quitar el grupo de recursos y todo lo que contiene.

az group delete --name ContosoBotRG

Para quitar una conexión a un canal, use el comando de eliminación adecuado.

Comandos de la CLI de Azure usados en este artículo

En este artículo se usan los siguientes comandos de la CLI de Azure:

• az bot directline create
• az bot directline delete
• az bot directline show
• az bot email create
• az bot email delete
• az bot email show
• az bot facebook create
• az bot facebook delete
• az bot facebook show
• az bot msteams create
• az bot msteams delete
• az bot msteams show
• az bot skype create
• az bot skype delete
• az bot skype show
• az bot slack create
• az bot slack delete
• az bot slack show
• az bot sms create
• az bot sms delete
• az bot sms show
• az bot telegram create
• az bot telegram delete
• az bot telegram show
• az group delete

Pasos siguientes

• Conectar un bot a canales
• Administración de un bot