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 no Azure, usa canais para ajudar o bot a se comunicar 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 do Bot do Azure. Você também pode conectar um bot ao seu aplicativo de comunicação usando a Linha Direta como canal. Para obter mais informações, consulte Conectar um bot à Linha Direta.

O Bot Framework permite que você desenvolva um bot de forma independente do canal, normalizando as mensagens que o bot envia para um canal.

  • O serviço ou um adaptador traduz a comunicação entre o esquema de atividade do Bot Framework e o esquema do canal.
  • Se o canal não suportar todos os aspetos do esquema de atividade, o Bot Connector Service tentará converter a mensagem para um 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 email, o conector poderá enviar o cartão como uma imagem e incluir as ações como links no corpo do e-mail.
  • 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 o 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. Inicie sessão no portal do Azure.
  2. Selecione o bot que você deseja configurar.
  3. No painel esquerdo, selecione Canais em Configurações.
  4. No painel direito, selecione o ícone do canal que você deseja adicionar ao seu bot. Talvez seja necessário rolar para baixo para ver a lista de todos os canais disponíveis.

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

Lista de canais

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

Canal Description
Alexa Comunique-se com os usuários por meio das habilidades personalizadas da Alexa.
Chat dos Serviços de Comunicação do Azure Use o Chat dos Serviços de Comunicação do Azure para adicionar um bot aos recursos de chat do seu site.
Linha Direta Integre um bot em um aplicativo móvel, página da Web ou outros aplicativos.
E-mail Habilite um bot para se comunicar com os usuários por meio do email do Microsoft 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.
GroupMe Configure um bot para se comunicar com os usuários por meio do GroupMe.
Kik O Kik não suporta mais o desenvolvimento de novos bots.
LINHA Configure um bot para se comunicar com os usuários por meio do aplicativo LINE.
Microsoft Teams Configure um bot para se comunicar com os usuários por meio do Microsoft Teams.
Omnicanal Integre um bot para iniciar uma conversa com um cliente, forneça respostas automatizadas e, em seguida, mude a conversa para um agente humano, se necessário.
Outlook (pré-visualização) Configure um bot para se comunicar com os usuários por meio de ações rápidas de dentro do Outlook.
Pesquisa (pré-visualização) Habilite um bot para responder a consultas do usuário por meio da pesquisa federada do Dynamics 365.
Skype O Skype não suporta mais o desenvolvimento de novos bots.
Slack Configure um bot para se comunicar com os usuários por meio do Slack.
Telegrama Configure um bot para se comunicar com os usuários 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 se comunicar com os usuários por meio da plataforma de comunicação em nuvem Twilio.
WeChat Configure um bot para se comunicar com os usuários usando a plataforma WeChat.
Bate-papo na Web Configurado automaticamente para você quando você cria um bot com o Bot Framework Service.
Canais adicionais Canais adicionais disponíveis como um adaptador através do Botkit fornecido plataformas 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 de protocolo do Bot Framework. Da mesma forma, as mensagens enviadas pelo bot para outros serviços são transformadas do 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 versões anteriores do protocolo para evitar alterar o comportamento dos bots existentes.

Ocasionalmente, uma mudança no processo de transformação de esquema precisa ocorrer que pode, potencialmente, mudar o comportamento dos bots existentes. Um exemplo de tal mudança pode ser qualquer correção de bug, se alguns dos usuários tiverem tomado uma dependência do comportamento existente (embora errado). Outro exemplo dessa mudança seriam atualizações ou melhorias em outros serviços que beneficiariam os bots; no entanto, a adoção dessas atualizações pode, potencialmente, alterar o comportamento existente.

Ao controlar a versão de transformação de esquema de seus bots, os desenvolvedores de bots podem controlar quando (se alguma vez) habilitar um novo comportamento. Por padrão, os bots recém-criados obtêm a versão de transformação de esquema mais recente. Os bots existentes podem ser atualizados para a versão mais recente quando estiverem prontos para aproveitar as melhorias introduzidas nesta versão. Qualquer bot pode ser atualizado ou rebaixado a qualquer momento.

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

The Schema Transformation Version field in the Configuration pane

Versões de transformação de esquema suportadas

  • Versão 1.3

    • Data de introdução: maio de 2021
    • Alterações:
      • Linha direta: remova a desserialização/reserialização de placas adaptáveis. O conteúdo dos Adaptive Cards será passado para o cliente tal como está.
  • Versão 1.2

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

    • Data de introdução: abril de 2021
    • Alterações:
      • Canal do Telegram: use a sintaxe MarkdownV2 para todas as marcações.
  • Versão 1.0

    • Versão original

Conecte seu bot a 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.

Próximos passos

O SDK inclui exemplos que você pode usar para criar bots. Visite o repositório de amostras no GitHub para ver uma lista de amostras.