Configurar um bot para ser executado em um ou mais canais
APLICA-SE A: SDK v4
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 o registro do Bot do Azure. Você também pode conectar um bot ao seu aplicativo de comunicação usando o Direct Line como o canal. Para obter mais informações, consulte Conectar um bot ao Direct Line.
O Bot Framework permite que você desenvolva um bot de forma independente de canal normalizando as mensagens que o bot envia para um canal.
- O serviço ou um adaptador converte a comunicação entre o esquema de Atividade do Bot Framework e o esquema do canal.
- Se o canal não oferecer suporte a todos os aspectos do esquema de atividade, o Serviço de Conector de Bot tentará converter a mensagem em um formato que o canal dá suporte. Por exemplo, se o bot enviar uma mensagem que contém 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 email.
- 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:
- Entre no portal do Azure.
- Selecione o bot que você deseja configurar.
- No painel esquerdo, selecione Canais em Configurações.
- No painel direito, selecione o ícone do canal que você deseja adicionar ao 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 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 |
Comunique-se com os usuários por meio de habilidades personalizadas da Alexa. |
| Linha direta | Integre um bot a um aplicativo móvel, página da Web ou outros aplicativos. |
| Habilite um bot para se comunicar com os usuários por email do Microsoft 365. | |
| Conecte um bot ao Facebook Messenger e ao Facebook Workplace, para que ele possa se comunicar com 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 dá mais suporte ao desenvolvimento de novos bots. |
| 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 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 (versão prévia) | Configure um bot para se comunicar com os usuários por meio de ações rápidas de dentro do Outlook. |
| Pesquisar (versão prévia) | Habilite um bot para responder a consultas de usuário por meio da pesquisa federada do Dynamics 365. |
| Skype | O Skype não dá mais suporte ao desenvolvimento de novos bots. |
| 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 de telefonia do Bot Framework. |
| Twilio | Configure um bot para se comunicar com os usuários por meio da plataforma de comunicação na nuvem do Twilio. |
| Configure um bot para se comunicar com usuários usando a plataforma WeChat. | |
| Web Chat | Configurado automaticamente para você ao criar um bot com o Serviço do Bot Framework. |
| Canais adicionais | Canais adicionais disponíveis como um adaptador por meio de plataformas fornecidas pelo 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 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 Serviço do Bot Framework mantém a compatibilidade com versões anteriores do protocolo para evitar a alteração do comportamento dos bots existentes.
Ocasionalmente, é necessário realizar 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 alguns dos usuários tiverem tomado uma dependência do comportamento existente (porém incorreto). Outro exemplo dessa alteração seria 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 bot 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:
Versões de transformação de esquema com suporte
Versão 1.3
- Data introduzida: maio de 2021
- Alterações:
- Linha Direta: remover desserializar/reserializar cartões adaptáveis. O conteúdo dos Cartões Adaptáveis será passado para o cliente como está.
Versão 1.2
- Data introduzida: abril de 2021
- Alterações:
- Canal do Slack: o nome do anexo é usado para o valor de Texto da Mensagem.
- Canal do Facebook: atualizar para a API do Facebook Graph v9.0.
Versão 1.1
- Data introduzida: abril de 2021
- Alterações:
- Canal do Telegram: use a sintaxe MarkdownV2 para todos os markdowns.
Versão 1.0
- Versão original
Conectar 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óximas etapas
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.