Conectar um bot aos canais

aplica-se a: SDK v4

Um canal é uma conexão entre aplicativos de comunicação e um bot. Um bot, registrado com o Azure, usa canais para facilitar a comunicação com os usuários.

Você pode configurar um bot para se conectar a qualquer um dos canais padrão, como Alexa, Facebook Messenger e Slack. Para obter mais informações, consulte Registro de Bot do Azure.

Além dos canais fornecidos, você também pode conectar um bot ao seu aplicativo de comunicação usando Direct Line como o canal. Para obter mais informações, consulte Conectar um bot ao Direct Line.

A Bot Framework permite que você desenvolva um bot de uma maneira que não seja de canal, normalizando mensagens que o bot envia para um canal. Isso significa o seguinte:

  • Converta as mensagens do Bot Framework esquema no esquema do canal.
  • Se o canal não dá suporte a todos os aspectos do esquema Bot Framework, o serviço Bot Connector tenta converter a mensagem em um formato que o canal dá suporte. Por exemplo, se o bot enviar uma mensagem contendo um cartão com botões de ação ao canal de email, o conector poderá enviar o cartão como uma imagem e incluir as ações como links no texto da mensagem.
  • Para a maioria dos canais, você deve fornecer informações de configuração de canal para executar um bot no canal. A maioria dos canais exige que um bot tenha uma conta no canal. Outros, como Facebook Messenger, exigem que um bot também tenha um aplicativo registrado no canal.

Para configurar um bot para se conectar a um canal, conclua as seguintes etapas:

  1. Entre no Portal do Azure.

  2. Selecione o bot que você deseja configurar.

  3. No painel esquerdo, selecione Canais em Gerenciamento de Bot.

  4. No painel direito, selecione o ícone do canal que você deseja adicionar ao bot.

    Conectar-se aos canais

Depois de configurar o canal, os usuários naquele canal podem começar a usar o seu bot.

Conectar um bot a um canal

As etapas de conexão são diferentes para cada canal. Consulte o artigo relacionado na tabela abaixo para obter mais informações.

Canal Descrição
Alexa Comunicar-se com os usuários por meio de dispositivos Alexa que suportam habilidades personalizadas.
Linha direta Integre um bot em um aplicativo móvel, em uma página da Web ou em outros aplicativos.
Email do Office 365 Habilite um bot para se comunicar com usuários por email do Office 365.
Facebook Conecte um bot ao Facebook Messenger e ao Facebook workplace, para que ele possa se comunicar com os usuários em ambas as plataformas.
Kik Configure um bot para se comunicar com usuários por meio do aplicativo de mensagens kik.
LINE Configure um bot para se comunicar com usuários por meio do aplicativo de linha.
Equipes da Microsoft Configure um bot para se comunicar com usuários por meio do Microsoft Teams.
Skype Configure um bot para se comunicar com usuários por meio do Skype.
Skype for Business Configure um bot para se comunicar com usuários por meio do Skype para Glossário.
Margem de atraso Configure um bot para se comunicar com os usuários por meio da margem de atraso.
Telegram Configure um bot para se comunicar com usuários por meio do Telegram.
Telefonia Configure um bot para se comunicar com os usuários por meio do canal de telefonia do bot Framework.
Twilio Configure um bot para se comunicar com os usuários por meio da plataforma de comunicação de nuvem do twilio.
WeChat Configure um bot para se comunicar com usuários usando a plataforma WeChat.
Web Chat Configurado automaticamente para você quando você cria um bot com o serviço bot Framework.
Webex Configure um bot para se comunicar com usuários usando o WebEx.
Canais adicionais Canais adicionais disponíveis como um adaptador por meio de plataformas fornecidas por meio de repositóriosde Botkit e comunidade.

Versão de transformação do esquema de bot

Conforme descrito acima, um canal converte mensagens de entrada de outros serviços para o esquema de protocolo do bot Framework. Da mesma forma, as mensagens enviadas pelo bot para outros serviços são transformadas no esquema nativo do bot Framework para o formato desses serviços. Esse processo é chamado de transformação de esquema. O Bot Framework Service mantém a compatibilidade com backward do protocolo para evitar a alteração do comportamento dos bots existentes.

Ocasionalmente, é necessário fazer uma alteração no processo de transformação de esquema que possa, potencialmente, alterar o comportamento dos bots existentes. Um exemplo dessa alteração pode ser qualquer correção de bug se um subconjunto dos usuários tiver assumido uma dependência do comportamento existente (no entanto, errôneo). Outro exemplo dessa alteração seria atualizações ou melhorias em outros serviços que beneficiariam bots; no entanto, a adoção dessas atualizações pode, potencialmente, alterar o comportamento existente.

Controlando a versão de transformação de esquema de seus bots, os desenvolvedores de bot podem controlar quando (se nunca) habilitar o novo comportamento. Por padrão, os bots recém-criados obterão a versão de transformação de esquema mais recente. Os bots existentes podem ser atualizados para a versão mais recente quando eles estão prontos para aproveitar as melhorias introduzidas nesta versão. Qualquer bot pode ser atualizado ou downgrade a qualquer momento.

Você pode alterar a versão de transformação de esquema do bot no painel Configuração:

O campo Versão da Transformação Esquema no painel Configuração

Versões de transformação de esquema com suporte

  • Versão 1.3

    • Data de lançamento: maio de 2021
    • Alterações:
      • Direct Line: Remova Desseerialize/Reserialize do Cartões Adaptáveis. O conteúdo de Cartões Adaptáveis será passado para o cliente como está.
  • Versão 1.2

    • Data de lançamento: abril de 2021
    • Alterações:
  • Versão 1.1

    • Data de lançamento: abril de 2021
    • Alterações:
  • Versão 1.0

    • Versão original

Publicar um bot

O processo de publicação é diferente para cada canal.

Skype

Observação

Desde 31 de outubro de 2019, o canal do Skype não aceita mais novas solicitações de publicação de bot. Isso significa que você pode continuar a desenvolver bots usando o canal do Skype, mas o bot será limitado a 100 usuários. Você não poderá publicar o bot para um público-alvo maior. Os bots atuais do Skype continuarão a ser executados sem interrupção. Leia mais sobre por que alguns recursos não estão mais disponíveis no Skype.

Os bots são publicados no Skype na página de configuração. A publicação de um bot envia-o para revisão. Antes da revisão, o bot é limitado a 100 contatos. Os bots aprovados não possuem limite de contatos e você pode optar por ter o bot incluído no diretório de bots do Skype.

Skype for Business

Importante

O Skype for Business Online será desativado em 31 de julho de 2021. Os clientes do Skype for Business Online não deverão ver nenhuma alteração no serviço antes da data de desativação. Para obter mais detalhes, leia O Skype for Business Online será desativado.

Os bots do Skype for Business são registrados com um locatário do Skype for Business Online por um administrador de locatários.

Para exibir o status de uma revisão, abra o bot no Portal do Bot Framework e clique em Canais. Se o bot não for aprovado, o resultado oferecerá um link para o motivo. Depois de fazer as alterações necessárias, reenvie o bot para revisão.

Recursos adicionais

O SDK inclui exemplos que podem ser usados para criar bots. Visite o repositório de exemplos no GitHub para ver uma lista de exemplos.