---
title: INSendMessageIntent
framework: intents
role: symbol
role_heading: Class
path: intents/insendmessageintent
---

# INSendMessageIntent

A request to send a message to the designated recipients.

## Declaration

```swift
class INSendMessageIntent
```

## Mentioned in

Dispatching intents to handlers Improving interactions between Siri and your messaging app

## Overview

Overview Siri creates an 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 protocol. Your handler confirms the request and creates an INSendMessageIntentResponse object with the results. note: To allow a user wearing AirPods to automatically hear messages, you must implement both INSearchForMessagesIntent and INSendMessageIntent. Add announcement to the options when calling requestAuthorization(options:completionHandler:). Finally, add allowAnnouncement to the category option and INSearchForMessagesIntent to the category intent identifier. Additional Intent Attributes Additional attributes of this intent object include the following:  |   |   |  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:)](intents/insendmessageintent/init(recipients:outgoingmessagetype:content:speakablegroupname:conversationidentifier:servicename:sender:attachments:).md)

### Specifying Details About a Message

- [recipients](intents/insendmessageintent/recipients.md)
- [outgoingMessageType](intents/insendmessageintent/outgoingmessagetype.md)
- [conversationIdentifier](intents/insendmessageintent/conversationidentifier.md)
- [speakableGroupName](intents/insendmessageintent/speakablegroupname.md)
- [content](intents/insendmessageintent/content.md)
- [serviceName](intents/insendmessageintent/servicename.md)
- [sender](intents/insendmessageintent/sender.md)
- [attachments](intents/insendmessageintent/attachments.md)

### Deprecated Symbols

- [init(recipients:content:speakableGroupName:conversationIdentifier:serviceName:sender:)](intents/insendmessageintent/init(recipients:content:speakablegroupname:conversationidentifier:servicename:sender:).md)
- [init(recipients:content:groupName:serviceName:sender:)](intents/insendmessageintent/init(recipients:content:groupname:servicename:sender:).md)
- [init(recipients:outgoingMessageType:content:speakableGroupName:conversationIdentifier:serviceName:sender:)](intents/insendmessageintent/init(recipients:outgoingmessagetype:content:speakablegroupname:conversationidentifier:servicename:sender:).md)
- [groupName](intents/insendmessageintent/groupname.md)

## Relationships

### Inherits From

- [INIntent](intents/inintent.md)

### Conforms To

- [CVarArg](swift/cvararg.md)
- [Copyable](swift/copyable.md)
- [CustomDebugStringConvertible](swift/customdebugstringconvertible.md)
- [CustomStringConvertible](swift/customstringconvertible.md)
- [Equatable](swift/equatable.md)
- [Escapable](swift/escapable.md)
- [Hashable](swift/hashable.md)
- [INIntentSetImageKeyPath](intents/inintentsetimagekeypath.md)
- [NSCoding](foundation/nscoding.md)
- [NSCopying](foundation/nscopying.md)
- [NSObjectProtocol](objectivec/nsobjectprotocol.md)
- [NSSecureCoding](foundation/nssecurecoding.md)
- [UNNotificationContentProviding](usernotifications/unnotificationcontentproviding.md)

## See Also

### Sending a Message

- [INSendMessageIntentHandling](intents/insendmessageintenthandling.md)
- [INSendMessageIntentResponse](intents/insendmessageintentresponse.md)
- [INOutgoingMessageType](intents/inoutgoingmessagetype.md)
- [INSendMessageAttachment](intents/insendmessageattachment.md)
- [INSendMessageIntentDonationMetadata](intents/insendmessageintentdonationmetadata.md)