Configurar um bot para execução 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 que ajudam 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, confira Registro de bot do Azure. Você também pode conectar um bot ao seu aplicativo de comunicação usando o Direct Line como canal. Para obter mais informações, confira Conectar um bot ao Direct Line.
O Bot Framework permite que você desenvolva um bot de maneira independente de canal normalizando as mensagens que o bot envia a 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.
- No entanto, se o canal não oferecer suporte a todos os aspectos do esquema de atividade, o serviço do conector do bot tentará converter a mensagem em um formato com suporte pelo canal. 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 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 à esquerda, em Configurações, selecione Canais.
- No painel à direita, selecione o ícone do canal que 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 naquele canal podem começar a usar o seu bot.
Lista de canais
As etapas de conexão são diferentes para cada canal. Veja 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. |
| Serviços de Comunicação do Azure de Chat | Use os Serviços de Comunicação do Azure de Chat para adicionar um bot aos recursos de conversa do seu site. |
| Direct Line | Integre um bot a um aplicativo móvel, página da Web ou outros aplicativos. |
| Permita que um bot se comunique com os usuários pelo email do Microsoft 365. | |
| Conecte um bot ao Facebook Messenger e ao Workplace do Facebook, para que ele possa se comunicar com usuários nas duas plataformas. | |
| GroupMe | Configure um bot para se comunicar com os usuários por meio do GroupMe. |
| Kik | O Kik não oferece mais suporte ao desenvolvimento de novos bots. |
| LINE | Configure um bot para se comunicar com 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, transfira a conversa para um agente humano, se necessário. |
| Outlook (preview) | Configure um bot para se comunicar com os usuários por meio de ações rápidas no Outlook. |
| Localizar (preview) | Habilite um bot para responder a consultas do usuário por meio da pesquisa federada do Dynamics 365. |
| Skype | O Skype não oferece mais suporte ao desenvolvimento de novos bots. |
| Stack | Configure um bot para se comunicar com usuários por meio do Stack. |
| Telegram | Configure um bot para se comunicar com os usuários por meio do Telegram. |
| Telefonia | A telefonia se encontra no modo preview e não está aceitando clientes adicionais no momento. |
| Twilio (SMS) | Configure um bot para se comunicar com os usuários por meio da plataforma de comunicação em nuvem Twilio. |
| Configure um bot para se comunicar com os usuários usando a plataforma WeChat. | |
| Web Chat | Configurado automaticamente para ser usado quando você criar um bot com o Bot Framework Service. |
| Canais adicionais | Canais adicionais estão disponíveis como adaptador por meio das plataformas fornecidas pelo Botkit e dos repositórios da comunidade. |
Selecione a versão de transformação do esquema de protocolo
Conforme descrito acima, um canal converte mensagens recebidas de outros serviços em esquema de protocolo 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 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, precisa ocorrer uma alteração no processo de transformação de esquema que possa, potencialmente, alterar o comportamento dos bots existentes. Um exemplo de tal alteração pode ser qualquer correção de bug, caso alguns dos usuários tenham criado uma dependência do comportamento existente (por mais errôneo que seja). Outro exemplo de tal alteração 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 é que isso acontece) 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 passar a usar uma versão atualizada ou antiga a qualquer momento.
Você pode alterar a versão de transformação de esquema do seu bot no painel Configuração em Configurações:
Versões de transformação de esquema com suporte
Versão 1.3
- Data de introdução: maio de 2021
- Alterações:
- Direct Line: remova a desserialização/resserialização de cartões adaptáveis. O conteúdo dos cartões adaptáveis será passado para o cliente como estiver.
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 o Facebook API do Graph v9.0.
Versão 1.1
- Data de introdução: abril de 2021
- Alterações:
- Canal do Telegram: use a sintaxe MarkdownV2 para todo o markdown.
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, confira o artigo de 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.