Principais conceitos-API do conector de bot

O bot Framework e o serviço de bot do Azure permitem que o bot se comunique com usuários em equipes, Facebook e muito mais. Os canais estão disponíveis em duas formas: como serviço incluído como parte do Serviço de Bot do Azure e como bibliotecas de adaptador para uso com o SDK do Bot Framework. Este artigo se concentra nos canais padronizados incluídos no Serviço de Bot do Azure.

Canais do Bot Framework

Os canais do bot Framework permitem que o bot troque mensagens com canais configurados no portal do Azure. Ele usa o padrão do setor REST e JSON via HTTPS e permite a autenticação com tokens de Portador JWT. Para obter informações detalhadas sobre como usar o serviço do Conector de Bot, consulte Autenticação e os outros artigos desta seção.

Atividade

O serviço do conector troca informações entre o bot e o canal (usuário), passando um objeto de atividade . O tipo de atividade mais comum é mensagem, mas há outros tipos de atividade que podem ser usados para comunicar diversos tipos de informações a um bot ou canal. Para obter detalhes sobre as Atividades no serviço do Conector do Bot, consulte Visão geral das atividades.

Autenticação

Os Bot Framework Services usam tokens de portador JWT para autenticação. Para obter informações detalhadas sobre como autenticar solicitações de saída enviadas por seu bot para o Bot Framework, como autenticar solicitações de entrada que seu bot recebe do Bot Framework e muito mais, consulte Autenticação.

Bibliotecas de cliente

O Bot Framework fornece bibliotecas de clientes que podem ser usadas para criar bots em C#, JavaScript e Python.

Além de simplificar chamadas às APIs REST do Bot Framework, cada SDK do Bot Framework também fornece um sistema avançado para a criação de diálogos que encapsulam a lógica de conversa, solicitações internas de coisas simples como Sim/Não, cadeias de caracteres, números e enumerações, suporte interno para estruturas de IA avançadas como LUIS e muito mais.

Observação

Como alternativa ao uso do SDK, você pode gerar sua própria biblioteca de clientes na linguagem de sua escolha usando o arquivo Swagger do Conector do Bot ou codificar diretamente para a API REST.

Serviço de Estado do Bot

O serviço de Estado do Microsoft Bot Framework foi desativado em 30 de março de 2018. Anteriormente, bots criados no Serviço de Bot do Azure ou no SDK do Bot Builder tinham uma conexão padrão com esse serviço hospedado pela Microsoft para armazenar dados de estado do bot. Os bots deverão ser atualizados para usar seu próprio armazenamento de estado.

Recursos adicionais

Saiba mais sobre a criação de bots usando o serviço de conector revisando artigos em toda esta seção, começando com a autenticação. Se você tiver problemas ou tiver sugestões sobre o serviço do conector, consulte suporte para obter uma lista de recursos disponíveis.