Configurar um bot para ser executado em um ou mais canais

aplica-se a: SDK v4

Um canal é uma conexão entre um aplicativo 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 Conexão um bot para Direct Line.

O 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:

  • O serviço ou um adaptador converte a comunicação entre o esquema Bot Framework Atividade de Bot Framework e o esquema do canal.
  • Se o canal não dá suporte a todos os aspectos do esquema de atividade, o Serviço de Conector de Bot 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 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.

Lista de canais

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 Integrar um bot a um aplicativo móvel, página da Web ou outros aplicativos.
Facebook Conexão um bot para o Facebook Messenger e o Facebook Workplace, para que ele possa se comunicar com os usuários em ambas as plataformas.
Kik Configure um bot para se comunicar com os usuários por meio do aplicativo de mensagens Kik.
LINE Configure um bot para se comunicar com os usuários por meio do aplicativo LINE.
Equipes da Microsoft Configure um bot para se comunicar com os usuários por meio Microsoft Teams.
Email do Office 365 Habilitar um bot para se comunicar com os usuários por Office 365 email.
Skype Configure um bot para se comunicar com os usuários por meio Skype.
Skype for Business Configure um bot para se comunicar com os usuários por meio Skype para Busines.
Margem de atraso Configure um bot para se comunicar com os usuários por meio do Slack.
Telegram Configure um bot para se comunicar com os usuários por meio do Telegram.
Telefonia Configure um bot para se comunicar com os usuários por meio do canal Bot Framework Telefonia.
Twilio Configure um bot para se comunicar com os usuários por meio da plataforma de comunicação na nuvem do Twilio.
WeChat Configure um bot para se comunicar com os usuários usando a plataforma WeChat.
Web Chat Configurado automaticamente para você ao criar um bot com o Bot Framework Service.
Webex Configure um bot para se comunicar com os usuários usando o Webex.
Canais adicionais Canais adicionais disponíveis como um adaptador por meio de plataformas fornecidas por meio do Botkit e repositórios da comunidade.

Selecione a versão de transformação do esquema de protocolo

Conforme descrito acima, um canal converte mensagens de entrada de outros serviços para o esquema Bot Framework protocolo. Da mesma forma, as mensagens enviadas pelo bot para outros serviços são transformadas do esquema Bot Framework nativo 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 de Cartões Adaptáveis. O conteúdo Cartões Adaptáveis será passado para o cliente como está.
  • Versão 1.2

    • Data de lançamento: abril de 2021
    • Alterações:
      • Canal do Slack: o nome do anexo é usado para o valor de Texto da Mensagem.
      • Canal do Facebook: atualize para a API Graph Facebook v9.0.
  • Versão 1.1

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

    • Versão original

Conexão bot para um ou mais canais

O processo de publicação é diferente para cada canal. Para obter mais informações, consulte o artigo para cada canal específico.

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.