Abc-Sdk 2.0.21

Apple Business Chat SDK

A .NET SDK for integrating with Apple Business Chat (Messages for Business). It enables Customer Service Platforms (CSPs) to communicate with customers on iPhone, iPad, Mac, and Apple Watch through iMessage — sending text, rich links, interactive messages, forms, Apple Pay requests, and more.

Installation

dotnet add package Abc-Sdk

For webhook support in ASP.NET Core:

dotnet add package Abc-Sdk.Controllers

Authentication

using Abc;

var credentials = Auth.CreateCredentials(
    cspId: "your-csp-id",
    secret: "your-base64-secret",
    businessChatId: "your-business-chat-id"
);

All Message.* methods accept an optional IAbcCredentials credentials parameter, making them thread-safe for concurrent multi-tenant use.

Usage

Sending Messages

await Message.SendMessage("Hello!", recipientId, credentials);

Typing Indicators

await Message.SendMessageTyping(typing: true, recipientId, credentials);

Quick Replies

var items = new List<QuickReplyItem>
{
    new QuickReplyItem { Title = "Yes" },
    new QuickReplyItem { Title = "No" }
};

await Message.SendMessageQuickReply("Do you agree?", items, recipientId, credentials);

Rich Links

byte[] imageData = File.ReadAllBytes("preview.jpg");
await Message.SendMessageRichLinkImage(
    linkUrl: "https://example.com/article",
    data: imageData,
    mimeType: "image/jpeg",
    title: "Read this article",
    recipientId: recipientId,
    credentials: credentials
);

File Attachments

Files are automatically encrypted (AES-CTR), uploaded, and sent as message attachments.

await Message.SendFile("/path/to/document.pdf", recipientId, credentials: credentials);

Interactive Messages

Use the dedicated factories to construct list pickers, time pickers, and forms:

var listPickerMessage = MessageListPickerFactory.CreateListPickerMessage(
    businessChatId, recipientId, sections, receivedMessage, imageData, title, subtitle);
await Message.SendMessage(listPickerMessage, credentials);

Apple Pay

var applePayMessage = MessagePaymentFactory.CreateApplePayMessage(
    businessChatId, recipientId, receivedMessage, paymentRequest, endpoints, imageData, title, subtitle);

await Message.SendMessageApplePay(
    message: applePayMessage,
    merchantCertificate: cert,
    merchantName: "My Store",
    merchantId: "merchant.com.example",
    domainName: "example.com",
    paymentGatewayUrl: "https://example.com/paymentGateway"
);

Receiving Webhooks

Use Abc.Controllers to validate and parse inbound messages from Apple (gzip-compressed, JWT-signed):

using Abc.Controllers.Helper;

if (!AuthHelper.IsAuthorizationValid(credentials, headerMessage))
    return Unauthorized();

License

See the LICENSE file for details.