BotFrameworkAdapter Sınıf

can_process_outgoing_activity(activity: Activity) -> bool

Parametreler

Bir kullanıcıyla konuşmaya devam eder.

ve genellikle config.pyMicrosoftAppId parametresinde bulunur. :type bot_id: <xref:typing.str> :p aram claims_identity: Bot talep kimliği :type claims_identity: <xref:botframework.connector.auth.ClaimsIdentity> :p aram audience: :type audience: <xref:typing.str>

async continue_conversation(reference: ConversationReference, callback: Callable, bot_id: str = None, claims_identity: ClaimsIdentity = None, audience: str = None)

Parametreler

Döndürülenler

Özel durumlar

Açıklamalar

Bu genellikle botların iletişimde olan bir konuşmaya veya kullanıcıya proaktif olarak ileti göndermesine olanak sağlayan proaktif mesajlaşma akışı botlar olarak adlandırılır. Kullanıcıya bildirim veya kupon gönderme gibi senaryolar bu işlev tarafından etkinleştirilir.

ConnectorClientProvider.create_connector_client uygulaması.

async create_connector_client(service_url: str, identity: ClaimsIdentity = None, audience: str = None) -> ConnectorClient

Parametreler

Döndürülenler

Bir kullanıcıyla yeni bir konuşma başlatır. İletiyi bir grubun üyesine yönlendirmek için kullanılır.

async create_conversation(reference: ConversationReference, logic: Callable[[TurnContext], Awaitable] = None, conversation_parameters: ConversationParameters = None, channel_id: str = None, service_url: str = None, credentials: AppCredentials = None)

Parametreler

Döndürülenler

Özel durumlar

Açıklamalar

Bir konuşma başlatmak için botunuzun bu kanaldaki hesap bilgilerini ve kullanıcının hesap bilgilerini bilmesi gerekir. Kanalların çoğu yalnızca doğrudan ileti (grup dışı) konuşma başlatmayı destekler. Bağdaştırıcı kanalda yeni bir konuşma oluşturmayı dener ve ardından ara yazılım işlem hattı aracılığıyla geri çağırma yöntemine bir konuşma güncelleştirme etkinliği gönderir. Belirtilen kullanıcılarla konuşma oluşturulursa, etkinliğin kimliği yeni konuşmanın kimliğini içerir.

Daha önce kanala gönderilen bir etkinliği siler. Tüm kanalların bu özelliği desteklemediği belirtilmelidir.

async delete_activity(context: TurnContext, reference: ConversationReference)

Parametreler

Döndürülenler

Özel durumlar

Bir üyeyi geçerli konuşmadan siler.

async delete_conversation_member(context: TurnContext, member_id: str) -> None

Parametreler

Döndürülenler

Özel durumlar

async exchange_token(turn_context: TurnContext, connection_name: str, user_id: str, exchange_request: TokenExchangeRequest) -> TokenResponse

Parametreler

async exchange_token_from_credentials(turn_context: TurnContext, oauth_app_credentials: AppCredentials, connection_name: str, user_id: str, exchange_request: TokenExchangeRequest) -> TokenResponse

Parametreler

Yapılandırılmış bir bağlantıdaki belirli kaynaklar için Azure Active Directory belirteçlerini alır.

seçeneğini seçin. :type user_id: str :p aram oauth_app_credentials: (İsteğe bağlı) OAuth için AppCredentials. :type oauth_app_credentials: <xref:botframework.connector.auth.AppCredential>

async get_aad_tokens(context: TurnContext, connection_name: str, resource_urls: List[str], user_id: str = None, oauth_app_credentials: AppCredentials = None) -> Dict[str, TokenResponse]

Parametreler

Döndürülenler

Belirli bir etkinliğin üyelerini listeler.

Belirtilmezse geçerli etkinlik kimliği kullanılır.

async get_activity_members(context: TurnContext, activity_id: str)

Parametreler

Döndürülenler

Özel durumlar

Geçerli bir konuşmanın üyesini alma.

async get_conversation_member(context: TurnContext, member_id: str) -> ChannelAccount

Parametreler

Döndürülenler

Özel durumlar

Geçerli bir konuşmanın üyelerini listeler.

async get_conversation_members(context: TurnContext)

Parametreler

Döndürülenler

Özel durumlar

Bu botunun belirli bir kanal sunucusu için katıldığı Konuşmaları listeler.

context.activity.serviceUrl :type service_url: str

async get_conversations(service_url: str, credentials: AppCredentials, continuation_token: str = None)

Parametreler

Döndürülenler

Özel durumlar

Açıklamalar

Kanal sunucusu sonuçları sayfa olarak döndürür ve her sayfada sunucudan bir sonraki sonuç sayfasını getirmek için kullanılabilecek bir continuationToken bulunur. Görev başarıyla tamamlanırsa, sonuç geçerli konuşmanın üyelerinin bir sayfasını içerir. Yalnızca botun hizmet URL'si ve kimlik bilgileri gerektiğinden, bu aşırı yükleme konuşma bağlamının dışından çağrılabilir.

Bağlantı adı için oturum açmak üzere kullanıcıya gönderilecek ham oturum açma bağlantısını alır.

async get_oauth_sign_in_link(context: TurnContext, connection_name: str, final_redirect: str = None, oauth_app_credentials: AppCredentials = None) -> str

Parametreler

Döndürülenler

async get_sign_in_resource_from_user(turn_context: TurnContext, connection_name: str, user_id: str, final_redirect: str = None) -> SignInUrlResponse

Parametreler

async get_sign_in_resource_from_user_and_credentials(turn_context: TurnContext, oauth_app_credentials: AppCredentials, connection_name: str, user_id: str, final_redirect: str = None) -> SignInUrlResponse

Parametreler

Belirli bir kullanıcı için yapılandırılmış her bağlantı için belirteç durumunu alır.

Boş değer, yapılandırılan tüm bağlantılar için belirteç durumunu döndürür. :type include_filter: str :p aram oauth_app_credentials: (İsteğe bağlı) OAuth için AppCredentials. :type oauth_app_credentials: <xref:botframework.connector.auth.AppCredential>

async get_token_status(context: TurnContext, connection_name: str = None, user_id: str = None, include_filter: str = None, oauth_app_credentials: AppCredentials = None) -> List[TokenStatus]

Parametreler

Döndürülenler

Oturum açma akışında olan bir kullanıcının belirtecini almaya çalışır.

:p aram magic_code" (İsteğe bağlı) kullanıcısı :str magic_code" str :p aram oauth_app_credentials: (İsteğe bağlı) OAuth için AppCredentials'ı doğrulamak için kod girdi. :type oauth_app_credentials: <xref:botframework.connector.auth.AppCredential>

async get_user_token(context: TurnContext, connection_name: str, magic_code: str = None, oauth_app_credentials: AppCredentials = None) -> TokenResponse

Parametreler

Döndürülenler

Özel durumlar

static key_for_app_credentials(app_id: str, scope: str)

Parametreler

static key_for_connector_client(service_url: str, app_id: str, scope: str)

Parametreler

İsteği ayrıştırıp doğrular :p aram req: :return:

async static parse_request(req)

Parametreler

Bir dönüş bağlamı oluşturur ve gelen etkinlik için ara yazılım işlem hattını çalıştırır.

async process_activity(req, auth_header: str, logic: Callable)

Parametreler

Döndürülenler

Açıklamalar

Bu sınıf, botlar web sunucusu tarafından alınan bir etkinliği işler. Bu, bir kullanıcıdan gönderilen iletileri içerir ve genellikle botlar reaktif mesajlaşma akışı olarak adlandırılanları yönlendiren yöntemdir. Konuşmaya reaktif olarak ileti göndermek için bu yöntemi çağırın. Görev başarıyla tamamlanırsa bir InvokeResponse döndürülür; yoksa. null döndürülür.

async process_activity_with_identity(activity: Activity, identity: ClaimsIdentity, logic: Callable)

Parametreler

async process_outgoing_activity(turn_context: TurnContext, activity: Activity) -> ResourceResponse

Parametreler

async send_activities(context: TurnContext, activities: List[Activity]) -> List[ResourceResponse]

Parametreler

Kullanıcıyı belirteç sunucusuyla imzalar.

async sign_out_user(context: TurnContext, connection_name: str = None, user_id: str = None, oauth_app_credentials: AppCredentials = None)

Parametreler

Daha önce bir kanala gönderilen etkinliğin yerini alır. Tüm kanalların bu özelliği desteklemediği belirtilmelidir.

async update_activity(context: TurnContext, activity: Activity)

Parametreler

Döndürülenler

Özel durumlar

Açıklamalar

Etkinlik başarıyla gönderilirse, görev sonucu, alıcı kanalın etkinliğe atadığı kimliği içeren bir ResourceResponse nesnesi içerir. Bu işlevi çağırmadan önce, değiştirme etkinliğinin kimliğini değiştirilecek etkinliğin kimliği olarak ayarlayın.