This is the repo that i experiment issues or new features. If you want to use MessageBird WhatsApp channel with your bot, please use the adapter from this repo. https://github.com/BotBuilderCommunity/botbuilder-community-dotnet/tree/develop/libraries/Bot.Builder.Community.Adapters.MessageBird
This project is created by Ahmet Kocadoğan to help Bot Framework community for WhatsApp channel and not related with MessageBird officially.
This is part of the Bot Builder Community project which contains Bot Framework Components and other projects / packages for use with Bot Framework Composer and the Bot Builder .NET SDK v4.
The MessageBird WhatsApp adapter enables receiving and sending WhatsApp messages. The MessageBird adapter allows you to add an additional endpoint to your bot for receiving WhatsApp messages. The MessageBird endpoint can be used in conjunction with other channels meaning, for example, you can have a bot exposed on out of the box channels such as Facebook and Teams, but also via an MessageBird (as well as side by side with the Google/Twitter adapters also available from the Bot Builder Community Project).
Incoming MessageBird message requests are transformed, by the adapter, into Bot Framework Activites and then when your bot sends outgoing activities, the adapter transforms the outgoing Activity into an MessageBird messages.
The adapter currently supports the following scenarios:
- Send/receive messages with WhatsApp Sandbox
- Send/receive text messages
- Send/receive media messages (document, image, video, audio) - Supported formats for media message types available here
- Send/receive stickers - This feature will be supported as soon as MessageBird nuget package add this support. You can check the status of my PR about WhatsApp Sticker messages here
- Send/receive location messages
- Verification of incoming MessageBird requests (New request verification way of MessageBird API via Messagebird-Signature-Jwt header is supported)
- Receive delivery reports
- Full incoming request from MessageBird is added to the incoming activity as ChannelData
Basic sample bot available here.
- Prerequisites
- Set MessageBird credentials
- Wiring up the MessageBird adapter in your bot
- Incoming Whatsapp message requests to Bot Framework Activity mapping - Learn how incoming request types are handled by the adapter and the activities received by your bot.
- Outgoing Bot Framework Activity to MessageBird Whatsapp message mapping - Learn how outgoing Bot Framework activities are handled by the adapter.
- Useful links
Create a MessageBird account and activate WhatsApp Sandbox or Production. Get your SigningKey Get your AccessKey
At the end of process you will get the following parameters:
- SigningKey - will be used for requests authentication and authorization
- AccessKey - will be used for MessageBird Conversations API
- MessageBirdWebhookEndpointUrl - will be used for request verification
To authenticate the requests, you will need to configure the Adapter with the Signing Key, Access Key and your endpoint for MessageBird webhooks.
You could create in the project an appsettings.json file to set the MessageBird options as follows:
{
"MessageBirdAccessKey": "access_key_that_you_obtained_from_messagebird",
"MessageBirdSigningKey": "signing_key_that_you_obtained_from_messagebird",
"MessageBirdWebhookEndpointUrl": "your_bot_endpoint_url_for_incoming_messagebird_requests"
}After you completed the configuration of your MessageBird adapter, you need to wire up the MessageBird adapter into your bot.
Create a new class that inherits from the MessageBirdAdapter class. This class will act as our adapter for the MessageBird WhatsApp channel. It includes error handling capabilities (much like the BotFrameworkAdapterWithErrorHandler class already in the sample, used for handling requests from Azure Bot Service).
public class MessageBirdAdapterWithErrorHandler : MessageBirdAdapter
{
public MessageBirdAdapterWithErrorHandler(ILogger<MessageBirdAdapter> logger, MessageBirdAdapterOptions adapterOptions)
: base(adapterOptions, logger)
{
OnTurnError = async (turnContext, exception) =>
{
// Log any leaked exception from the application.
logger.LogError($"Exception caught : {exception.Message}");
// Send a catch-all apology to the user.
await turnContext.SendActivityAsync("Sorry, it looks like something went wrong.");
};
}
}You will also need to add the following using statements.
using Bot.Builder.Community.Adapters.MessageBird;
using Microsoft.Extensions.Logging;You now need to create a new controller which will handle requests for incoming WhatsApp messages, delivery and seen reports, on a new endpoint 'api/messagebird' instead of the default 'api/messages' used for requests from Azure Bot Service Channels. By adding an additional endpoint to your bot, you can accept requests from Bot Service channels (or additional adapters), as well as from MessageBird, using the same bot.
[Route("api/messagebird")]
[ApiController]
public class MessageBirdController : ControllerBase
{
private readonly MessageBirdAdapter Adapter;
private readonly IBot Bot;
public MessageBirdController(MessageBirdAdapter adapter, IBot bot)
{
Adapter = adapter;
Bot = bot;
}
[HttpPost]
public async Task PostAsync()
{
// Delegate the processing of the HTTP POST to the adapter.
// The adapter will invoke the bot.
await Adapter.ProcessAsync(Request, Response, Bot);
}
}You will also need to add the following using statements.
Add the following line into the ConfigureServices method within your Startup.cs file, which will register your MessageBird adapter with two dependencies and make it available for your new controller class. The configuration settings, described in the previous step, will be automatically used by the adapter.
//Add dependencies for MessageBird Adapter
services.AddSingleton<MessageBirdAdapterOptions>();
// Add MessageBird Adapter with the error handler
services.AddSingleton<MessageBirdAdapter, MessageBirdAdapterWithErrorHandler>();Sample code for sending text, image, audio, video, location, file and WhatsApp Sticker (WhatsApp Sticker will be added soon)
var reply = MessageFactory.Text("your text here");
await turnContext.SendActivityAsync(reply); var reply = MessageFactory.Text("Image");
Attachment attachment = new Attachment();
attachment.Name = "Bot Framework Arcitecture";
attachment.ContentType = "image";
attachment.ContentUrl = "https://docs.microsoft.com/en-us/bot-framework/media/how-it-works/architecture-resize.png";
reply.Attachments = new List<Attachment>() { attachment };
await turnContext.SendActivityAsync(reply); var reply = MessageFactory.Text("Audio");
Attachment attachment = new Attachment();
attachment.Name = "";
attachment.ContentType = "audio";
attachment.ContentUrl = "url_of_your_audio";
reply.Attachments = new List<Attachment>() { attachment };
await turnContext.SendActivityAsync(reply); var reply = MessageFactory.Text("Video");
Attachment attachment = new Attachment();
attachment.Name = "";
attachment.ContentType = "video";
attachment.ContentUrl = "url_of_your_video";
reply.Attachments = new List<Attachment>() { attachment };
await turnContext.SendActivityAsync(reply); var reply = MessageFactory.Text("Location");
reply.Entities = new List<Entity>() { new GeoCoordinates() { Latitude = 41.0572, Longitude = 29.0433 } };
await turnContext.SendActivityAsync(reply); var reply = MessageFactory.Text("File");
Attachment attachment = new Attachment();
attachment.ContentType = "file";
attachment.ContentUrl = "https://qconlondon.com/london-2017/system/files/presentation-slides/microsoft_bot_framework_best_practices.pdf";
attachment.Name = "Microsoft Bot Framework Best Practices";
reply.Attachments = new List<Attachment>() { attachment };
await turnContext.SendActivityAsync(reply); var reply = MessageFactory.Text("WhatsApp Sticker");
Attachment attachment = new Attachment();
attachment.Name = "";
attachment.ContentType = "whatsappsticker";
attachment.ContentUrl = "url_of_your_sticker";
reply.Attachments = new List<Attachment>() { attachment };
await turnContext.SendActivityAsync(reply);