Configure um bot para correr em um ou mais canais

APLICA-SE A: SDK v4

Um canal é uma ligação entre uma aplicação de comunicação e um bot. Um bot, registado no Azure, usa canais para ajudar o bot a comunicar com os utilizadores. Pode configurar um bot para ligar a qualquer um dos canais padrão, como Alexa, Facebook Messenger e Slack. Para mais informações, consulte o registo da Azure Bot. Também pode ligar um bot à sua aplicação de comunicação utilizando Direct Line como canal. Para mais informações, consulte Connect a bot para Direct Line.

O Bot Framework permite-lhe desenvolver um bot de forma agnóstica de canal, normalizando mensagens que o bot envia para um canal.

  • O serviço ou um adaptador traduz a comunicação entre o esquema de Actividade-Quadro bot e o esquema do canal.
  • Se o canal não suportar todos os aspetos do esquema de atividade, o Serviço de Conector Bot tenta converter a mensagem num formato que o canal suporta. Por exemplo, se o bot enviar uma mensagem que contenha um cartão com botões de ação para o canal de e-mail, o conector pode enviar o cartão como uma imagem e incluir as ações como links no corpo do e-mail.
  • Para a maioria dos canais, deve fornecer informações de configuração de canais para executar um bot no canal. A maioria dos canais exige que um bot tenha uma conta no canal. Outros, como o Facebook Messenger, exigem que um bot tenha uma aplicação registada no canal.

Para configurar um bot para ligar a um canal, complete os seguintes passos:

  1. Inicie sessão no portal do Azure.
  2. Selecione o bot que pretende configurar.
  3. No painel esquerdo, selecione Canais em Definições.
  4. No painel direito, selecione o ícone do canal que pretende adicionar ao seu bot. Poderá ser necessário deslocar-se para ver a lista de todos os canais disponíveis.

Depois de configurar o canal, os utilizadores desse canal podem começar a usar o seu bot.

Lista de canais

Os passos de ligação são diferentes para cada canal. Consulte o artigo relacionado na tabela abaixo mais informações.

Canal Descrição
Alexa Comunicar com os utilizadores através de habilidades personalizadas alexa.
Direct Line Integrar um bot numa aplicação móvel, página web ou outras aplicações.
E-mail Permita que um bot comunique com os utilizadores através do e-mail microsoft 365.
Facebook Ligue um bot ao Facebook Messenger e ao Facebook Workplace, para que possa comunicar com os utilizadores em ambas as plataformas.
GroupMe Configure um bot para comunicar com os utilizadores através do GroupMe.
Kik Kik já não apoia o desenvolvimento de novos bots.
LINHA Configure um bot para comunicar com os utilizadores através da aplicação LINE.
Equipas da Microsoft Configure um bot para comunicar com os utilizadores através do Microsoft Teams.
Omnicanal Integre um bot para iniciar uma conversa com um cliente, forneça respostas automatizadas e, em seguida, transloque a conversa para um agente humano, se necessário.
Perspetivas (pré-visualização) Configure um bot para comunicar com os utilizadores através de ações rápidas dentro do Outlook.
Pesquisa (pré-visualização) Capacite um bot para responder a consultas de utilizador através da pesquisa federada Dynamics 365.
Skype O Skype já não suporta o desenvolvimento de novos bots.
Slack Configure um bot para comunicar com os utilizadores através da Slack.
Telegram Configure um bot para comunicar com os utilizadores através do Telegram.
Telefonia A telefonia está em pré-visualização e não está a aceitar clientes adicionais.
Twilio (SMS) Configure um bot para comunicar com os utilizadores através da plataforma de comunicação em nuvem Twilio.
WeChat Configure um bot para comunicar com os utilizadores utilizando a plataforma WeChat.
Web Chat Configurado automaticamente para si quando criar um bot com o Serviço De Estrutura Bot.
Canais adicionais Canais adicionais disponíveis como adaptador através do Botkit forneceram plataformas e repositórios comunitários.

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

Como descrito acima, um canal converte mensagens recebidas de outros serviços para o esquema do protocolo Bot Framework. Da mesma forma, as mensagens enviadas pelo bot para outros serviços são transformadas do esquema nativo bot Framework para o formato destes serviços. Este processo chama-se transformação de esquemas. O Serviço Quadro Bot mantém a retrocompatibilidade do protocolo para evitar alterar o comportamento dos bots existentes.

Ocasionalmente, uma mudança no processo de transformação do esquema precisa de ocorrer que pode, potencialmente, alterar o comportamento dos bots existentes. Um exemplo de tal mudança poderia ser qualquer correção de bug, se alguns dos utilizadores tiverem tido uma dependência do comportamento existente (por mais erróneo). Outro exemplo dessa mudança seria atualizações ou melhorias noutros serviços que beneficiariam os bots; no entanto, a adoção destas atualizações pode, potencialmente, alterar o comportamento existente.

Ao controlar a versão de transformação de esquemas dos seus bots, os desenvolvedores de bots podem controlar quando (se alguma vez) permitir um novo comportamento. Por padrão, os bots recém-criados obtêm a versão mais recente da transformação de esquemas. Os bots existentes podem ser atualizados para a versão mais recente quando estão prontos para tirar partido das melhorias introduzidas nesta versão. Qualquer bot pode ser atualizado ou desclassificado a qualquer momento.

Pode alterar a versão de transformação de esquema do seu bot no painel de configuração em Definições:

O campo versão de transformação de Schema no painel de configuração

Versões de transformação de esquemas suportados

  • Versão 1.3

    • Data introduzida: maio 2021
    • Alterações:
      • Direct Line: Remover Deserializar/Reserializar cartões adaptativos. O conteúdo dos Cartões Adaptativos será passado para o cliente tal como está.
  • Versão 1.2

    • Data introduzida: abril 2021
    • Alterações:
      • Canal de folga: O nome de anexo é utilizado para o valor do texto de mensagem.
      • Canal do Facebook: Upgrade para Facebook Graph API v9.0.
  • Versão 1.1

    • Data introduzida: abril 2021
    • Alterações:
  • Versão 1.0

    • Versão original

Ligue o seu bot a um ou mais canais

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

Passos seguintes

O SDK inclui amostras que pode usar para construir bots. Visite as amostras no GitHub para ver uma lista de amostras.