<!--
{
  "availability" : [
    "iOS: 26.0.0 -",
    "iPadOS: -",
    "macCatalyst: -"
  ],
  "documentType" : "symbol",
  "framework" : "TelephonyMessagingKit",
  "identifier" : "/documentation/TelephonyMessagingKit",
  "metadataVersion" : "0.1.0",
  "role" : "Framework",
  "symbol" : {
    "kind" : "Framework",
    "modules" : [
      "TelephonyMessagingKit"
    ],
    "preciseIdentifier" : "TelephonyMessagingKit"
  },
  "title" : "TelephonyMessagingKit"
}
-->

# TelephonyMessagingKit

Send and receive standards-based messages over cellular networks.

## Overview

To use TelephonyMessagingKit, use the shared instance of [`TelephonyMessagingSession`](/documentation/TelephonyMessagingKit/TelephonyMessagingSession) as your app’s main point of contact with the framework.
Using a session, your app can inspect the services currently available on the device.
The framework supports Short Message Service (SMS), Multimedia Messaging Service (MMS), and Rich Communication Services (RCS).

Each service provides an asynchronous sequence for notifications of incoming messages that the app can handle.
To send a new message, compose the message content and then call the `send` method appropriate to the service.
The RCS service, if present, provides functionality that goes beyond one-to-one messaging, including group chat and chatbots.

> Note: TelephonyMessagingKit supports SMS, MMS, and RCS messaging only on iPhone devices. The framework has no functionality on iPadOS or on iOS apps running in visionOS or in macOS on Apple silicon. The framework ignores calls from Mac apps built with Mac Catalyst.

### Default carrier messaging apps

To have access to the TelephonyMessageKit API you must add the <doc://com.apple.documentation/documentation/BundleResources/Entitlements/com.apple.developer.carrier-messaging-app> entitlement to your app. This functionality will be enabled in your app only when the user selects your app to be the default carrier messaging app.

> Important: You may develop and test TelephonyMessagingKit apps on devices in all regions by using an Apple-provided provisioning profile. People using your app must have an account registered in the European Union (EU), and their device must be located within the EU.

## Topics

### Essentials

[Creating a carrier messaging app](/documentation/TelephonyMessagingKit/creating-a-carrier-messaging-app)

Use TelephonyMessagingKit to send and receive SMS, MMS, and RCS messages.

[`TelephonyMessagingSession`](/documentation/TelephonyMessagingKit/TelephonyMessagingSession)

An object that coordinates interaction with the TelephonyMessagingKit framework.

  <doc://com.apple.documentation/documentation/BundleResources/Entitlements/com.apple.developer.carrier-messaging-app>

### Supporting types

[`RCSFileTransferMetadata`](/documentation/TelephonyMessagingKit/RCSFileTransferMetadata)

A structure that contains metadata about an RCS file transfer.

[`RCSGroupContext`](/documentation/TelephonyMessagingKit/RCSGroupContext)

Structure containing information about a message’s group.


---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)