Send RCS

Rich card

{
  "to": "447700900123",
  "mode": "fallback",
  "fallbackText": "Your parcel arrives today, 10:00-12:00. Track it: https://rcsview.uk/A1042",
  "reference": "parcel-A1042",
  "card": {
    "title": "Your parcel arrives today",
    "description": "Delivery window 10:00-12:00",
    "mediaUrl": "https://example.com/images/delivery-van.png",
    "suggestions": [
      {
        "type": "openUrl",
        "text": "Track parcel",
        "url": "https://example.com/t/A1042"
      },
      {
        "type": "reply",
        "text": "Leave with a neighbour"
      },
      {
        "type": "dial",
        "text": "Call us",
        "phone": "+441234567890"
      }
    ]
  }
}

Request

{
  "to": "447700900123",
  "messageId": "261011_4821_1_1_1_0_1-447700900123"
}

C#

// Send an RCS rich card, falling back to SMS, with the everymessage v1 API (.NET 8 or later)
using System.Net.Http.Headers;
using System.Net.Http.Json;
using System.Text;
using System.Text.Json;
using System.Text.Json.Serialization;

var apiKey = Environment.GetEnvironmentVariable("EM_API_KEY")!;
var secretKey = Environment.GetEnvironmentVariable("EM_SECRET_KEY")!;

using var http = new HttpClient { BaseAddress = new Uri("https://api.everymessage.com/") };
http.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue(
    "Basic", Convert.ToBase64String(Encoding.UTF8.GetBytes($"{apiKey}:{secretKey}")));

var json = new JsonSerializerOptions(JsonSerializerDefaults.Web)
{
    DefaultIgnoreCondition = JsonIgnoreCondition.WhenWritingNull
};

var request = new RcsMessage(
    To: "447700900123",
    Mode: "fallback",
    FallbackText: "Your parcel arrives today, 10:00-12:00. Track it: https://rcsview.uk/A1042",
    Reference: "parcel-A1042",
    Card: new Card(
        Title: "Your parcel arrives today",
        Description: "Delivery window 10:00-12:00",
        MediaUrl: "https://example.com/images/delivery-van.png",
        Suggestions:
        [
            new Suggestion("openUrl", "Track parcel", Url: "https://example.com/t/A1042"),
            new Suggestion("reply", "Leave with a neighbour"),
            new Suggestion("dial", "Call us", Phone: "+441234567890")
        ]));

using var response = await http.PostAsJsonAsync("v1/rcs/messages", request, json);

// Unlike /v1/submit, the RCS API uses HTTP status codes: 202 means accepted.
if (!response.IsSuccessStatusCode)
    throw new InvalidOperationException(
        $"RCS send failed ({(int)response.StatusCode}): {await response.Content.ReadAsStringAsync()}");

var result = await response.Content.ReadFromJsonAsync<RcsResult>(json)
             ?? throw new InvalidOperationException("Empty response from everymessage");

// Keep rcsMessageId if you may want to revoke or replace the message.
foreach (var r in result.Recipients)
    Console.WriteLine($"{r.To}: {r.Status} (rcsMessageId {r.RcsMessageId})");

Console.WriteLine($"{result.Category} message, charged {result.Charged}");

record RcsMessage(string To, Card Card, string Mode = "only",
    string? FallbackText = null, string? Reference = null);
record Card(string Title, string Description, string? MediaUrl = null,
    IReadOnlyList<Suggestion>? Suggestions = null);
record Suggestion(string Type, string Text, string? Url = null, string? Phone = null);

record RcsResult(string Status, string Category, decimal Charged, IReadOnlyList<RecipientResult> Recipients);
record RecipientResult(string To, string Status, long MessageId, string? RcsMessageId);

C#

// Revoke an RCS message that has not been delivered yet (.NET 8 or later)
// Usage: dotnet run -- <to> <rcsMessageId>
using System.Net;
using System.Net.Http.Headers;
using System.Net.Http.Json;
using System.Text;

var apiKey = Environment.GetEnvironmentVariable("EM_API_KEY")!;
var secretKey = Environment.GetEnvironmentVariable("EM_SECRET_KEY")!;

using var http = new HttpClient { BaseAddress = new Uri("https://api.everymessage.com/") };
http.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue(
    "Basic", Convert.ToBase64String(Encoding.UTF8.GetBytes($"{apiKey}:{secretKey}")));

using var response = await http.PostAsJsonAsync("v1/rcs/messages/revoke",
    new { to = args[0], messageId = args[1] });

// 200 = revoked, 404 = unknown or expired id, 409 = too late (usually already delivered).
if (response.StatusCode is not (HttpStatusCode.OK or HttpStatusCode.NotFound or HttpStatusCode.Conflict))
    throw new InvalidOperationException(
        $"Revoke failed ({(int)response.StatusCode}): {await response.Content.ReadAsStringAsync()}");

var result = await response.Content.ReadFromJsonAsync<RevokeResult>()
             ?? throw new InvalidOperationException("Empty response from everymessage");

Console.WriteLine(result.Revoked ? "Revoked before delivery" : $"Not revoked: {result.Status}");

record RevokeResult(string To, string MessageId, bool Revoked, string? Status);