Build messaging into your product

using DevFlowMessaging.BusinessMessaging;
using DevFlowMessaging.BusinessMessaging.Model;
using DevFlowMessaging.BusinessMessaging.Model.MultiChannel;

var approvedTemplate = new TemplateMessage
{
    Content = new TemplateMessageContent
    {
        WhatsApp = new WhatsAppTemplate
        {
            Name = "shopify_campaign_test",
            Language = new TemplateLanguage("en_US"),
            Components =
            [
                new TemplateComponent
                {
                    Type = "body",
                    Parameters =
                    [
                        TemplateParameter.FromText("Ava"),          // {{1}}
                        TemplateParameter.FromText("+27820000000") // {{2}}
                    ]
                }
            ]
        }
    }
};

var message = new MessageBuilder(
        messageText: string.Empty,
        from: phoneNumberId,
        to: customerNumber)
    .WithAllowedChannels(Channel.WhatsApp)
    .WithTemplate(approvedTemplate)
    .WithReference("order-123-template")
    .Build();

await messaging.SendMessageAsync(message);

{
  "allowedChannels": ["WhatsApp"],
  "body": {
    "content": "",
    "type": "auto"
  },
  "from": "YOUR_META_PHONE_NUMBER_ID",
  "to": [
    { "number": "+27820000000" }
  ],
  "reference": "order-123-template",
  "richContent": {
    "conversation": [
      {
        "type": "template",
        "template": {
          "whatsapp": {
            "name": "shopify_campaign_test",
            "language": { "code": "en_US" },
            "components": [
              {
                "type": "body",
                "parameters": [
                  { "type": "text", "text": "Ava" },
                  { "type": "text", "text": "+27820000000" }
                ]
              }
            ]
          }
        }
      }
    ]
  }
}

using DevFlowMessaging.BusinessMessaging;
using DevFlowMessaging.BusinessMessaging.Model;
using DevFlowMessaging.BusinessMessaging.Model.MultiChannel;

// Copy these IDs and available prefill keys from the
// Developer tab on the published Flow.
var flow = new FlowMessage(
        flowId: "YOUR_META_FLOW_ID",
        text: "Please confirm your details.",
        callToAction: "Open Flow",
        screenId: "DETAILS")
    .WithFlowToken("customer-123")
    .WithPrefill("full_name", "Ava Customer")
    .WithPrefill("interests", new[] { "support", "sales" });

var message = new MessageBuilder(
        messageText: string.Empty,
        from: phoneNumberId,
        to: customerNumber)
    .WithAllowedChannels(Channel.WhatsApp)
    .WithFlow(flow)
    .WithReference("customer-123-flow")
    .Build();

await messaging.SendMessageAsync(message, cancellationToken);

{
  "allowedChannels": ["WhatsApp"],
  "body": {
    "content": "",
    "type": "auto"
  },
  "from": "YOUR_META_PHONE_NUMBER_ID",
  "to": [
    { "number": "+27820000000" }
  ],
  "reference": "customer-123-flow",
  "richContent": {
    "conversation": [
      {
        "type": "flow",
        "flowId": "YOUR_META_FLOW_ID",
        "text": "Please confirm your details.",
        "callToAction": "Open Flow",
        "screenId": "DETAILS",
        "flowToken": "customer-123",
        "prefillData": {
          "full_name": "Ava Customer",
          "interests": ["support", "sales"]
        }
      }
    ]
  }
}

using DevFlowMessaging.BusinessMessaging.Model;
using DevFlowMessaging.Models;

// Omit the query to return all company message history.
var history = await messaging.GetMessageHistoryAsync(
    new MessageHistoryQuery
    {
        PhoneNumber = "+27820000000",
        StartDate = new DateTimeOffset(2026, 7, 1, 0, 0, 0, TimeSpan.Zero),
        EndDate = new DateTimeOffset(2026, 7, 31, 23, 59, 59, TimeSpan.Zero),
        Channel = Channel.WhatsApp
    },
    cancellationToken);

foreach (var message in history.Messages)
{
    Console.WriteLine(
        $"{message.CreatedAt:u} {message.Channel} " +
        $"{message.Direction} {message.Status}");
}

GET /v1/messages/history?phoneNumber=%2B27820000000&startDate=2026-07-01T00%3A00%3A00Z&endDate=2026-07-31T23%3A59%3A59Z&channel=WhatsApp HTTP/1.1
Host: api.devflowltd.com
X-Api-Key: dfm_live_replace_me
Accept: application/json