<!--
{
  "availability" : [
    "iOS: 10.0.0 -",
    "iPadOS: 10.0.0 -",
    "macCatalyst: 13.1.0 -",
    "macOS: 12.0.0 -",
    "visionOS: 1.0.0 -",
    "watchOS: 3.2.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "SiriKit",
  "identifier" : "/documentation/Intents/INSendMessageIntent",
  "metadataVersion" : "0.1.0",
  "role" : "Class",
  "symbol" : {
    "kind" : "Class",
    "modules" : [
      "Intents"
    ],
    "preciseIdentifier" : "c:objc(cs)INSendMessageIntent"
  },
  "title" : "INSendMessageIntent"
}
-->

# INSendMessageIntent

A request to send a message to the designated recipients.

```
class INSendMessageIntent
```

## Overview

Siri creates an [`INSendMessageIntent`](/documentation/Intents/INSendMessageIntent) object when the user asks to send a message to one or more users. This intent object contains the message to send and the recipients of the message, which can include groups of users. Use the information in this object to construct and send the message.

To handle this intent, the handler object in your Intents extension must adopt the [`INSendMessageIntentHandling`](/documentation/Intents/INSendMessageIntentHandling) protocol. Your handler confirms the request and creates an [`INSendMessageIntentResponse`](/documentation/Intents/INSendMessageIntentResponse) object with the results.

> Note:
> To allow a user wearing AirPods to automatically hear messages, you must implement both ``doc://com.apple.sirikit/documentation/Intents/INSearchForMessagesIntent`` and ``doc://com.apple.sirikit/documentation/Intents/INSendMessageIntent``. Add <doc://com.apple.documentation/documentation/UserNotifications/UNAuthorizationOptions/announcement> to the options when calling <doc://com.apple.documentation/documentation/UserNotifications/UNUserNotificationCenter/requestAuthorization(options:completionHandler:)>. Finally, add <doc://com.apple.documentation/documentation/UserNotifications/UNNotificationCategoryOptions/allowAnnouncement> to the category option and ``doc://com.apple.sirikit/documentation/Intents/INSearchForMessagesIntent`` to the category intent identifier.

### Additional Intent Attributes

Additional attributes of this intent object include the following:

|Attribute                      |Description                   |
|-------------------------------|------------------------------|
|Supported by                   |Siri Intents, Siri Suggestions|
|Always requires unlocked device|No                            |

Apps can optionally ask the user to unlock the device before handling this intent. To require unlocking of the device, include the name of this class in the `IntentsRestrictedWhileLocked` key of your Intents extension’s `Info.plist` file.

## Topics

### Creating the Intent Object

[`init(recipients:outgoingMessageType:content:speakableGroupName:conversationIdentifier:serviceName:sender:attachments:)`](/documentation/Intents/INSendMessageIntent/init(recipients:outgoingMessageType:content:speakableGroupName:conversationIdentifier:serviceName:sender:attachments:))

Creates a send message intent object with the specified content and recipients.

### Specifying Details About a Message

[`recipients`](/documentation/Intents/INSendMessageIntent/recipients)

The array of users to receive the message.

[`outgoingMessageType`](/documentation/Intents/INSendMessageIntent/outgoingMessageType)

The format of the message contents.

[`conversationIdentifier`](/documentation/Intents/INSendMessageIntent/conversationIdentifier)

The identifier for the conversation.

[`speakableGroupName`](/documentation/Intents/INSendMessageIntent/speakableGroupName)

The name of the group to receive the message.

[`content`](/documentation/Intents/INSendMessageIntent/content)

The content of the message.

[`serviceName`](/documentation/Intents/INSendMessageIntent/serviceName)

The service to use when sending the message.

[`sender`](/documentation/Intents/INSendMessageIntent/sender)

The person or account that’s sending the message.

[`attachments`](/documentation/Intents/INSendMessageIntent/attachments)

Audio files to include in the message.

### Deprecated Symbols

[`init(recipients:content:speakableGroupName:conversationIdentifier:serviceName:sender:)`](/documentation/Intents/INSendMessageIntent/init(recipients:content:speakableGroupName:conversationIdentifier:serviceName:sender:))

Initializes a send message intent object with the specified content and recipients.

[`init(recipients:content:groupName:serviceName:sender:)`](/documentation/Intents/INSendMessageIntent/init(recipients:content:groupName:serviceName:sender:))

Initializes a send message intent object with the specified content and recipients.

[`init(recipients:outgoingMessageType:content:speakableGroupName:conversationIdentifier:serviceName:sender:)`](/documentation/Intents/INSendMessageIntent/init(recipients:outgoingMessageType:content:speakableGroupName:conversationIdentifier:serviceName:sender:))

Initializes a send message intent object with the specified content and recipients.

[`groupName`](/documentation/Intents/INSendMessageIntent/groupName)

The name of the group to receive the message.


---

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)