This site is obsolete and should be used for reference only. The information in this documentation is not guaranteed to work for Bot Framework SDK versions past 4.9.1.

Tutorial: Enable proactive notifications

Handle notifications

The EventHandler project is a sample Azure Function application that performs the following order of operations:

  1. Listens for events from an Event Hubs Instance.
  2. Read from a user preference store in Azure Cosmos DB to check a user’s settings.
  3. If the SendNotificationToConversation flag is true, send an event activity to a user’s active conversation with the message.
  4. If the SendNotificationToMobileDevice flag is true, send a notification to the user’s mobile devce using Azure Notifications Hubs.

Configure the Event Handler project

Update the YOUR_EVENT_HUB_NAME parameter of Function1 class with your Event Hubs Instance name.


+ public static async Task Run([EventHubTrigger("YOUR_EVENT_HUB_NAME", Connection = "EventHubConnection")] EventData[] events, ILogger log)
    foreach (EventData eventData in events)
            string messageBody = Encoding.UTF8.GetString(eventData.Body.Array, eventData.Body.Offset, eventData.Body.Count);

            var data = JsonConvert.DeserializeObject<EventDataType>(messageBody);
            await SendEventToBot(data);
            await Task.Yield();
        catch { }

Publish and configure the Function App

  1. Publish the EventHandler project to your Function Apps resource
  2. Navigate to the resource and select Configuration

Application Strings

Select + New application setting for each of the following:

    • Located in the Azure Bot Service resource > Channels
  • DocumentDbEndpointUrl: YOUR_COSMOS_DB_URI
  • DocumentDbPrimaryKey: YOUR_COSMOS_DB_PRIMARY_KEY
    • Located in the Azure Cosmos DB account resource > Keys

Connection Strings

Select + New connection string for the following: