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

# INMessage

An object that describes a sent or received message.

```
class INMessage
```

## Overview

When your app responds to an [`INSearchForMessagesIntent`](/documentation/Intents/INSearchForMessagesIntent), you create instances of this class to provide Siri with information about the messages in your app. Each message contains a unique identifier, the participants’ details, and the content. You can group messages into larger discussions and, if you app supports multiple services, identify the service that delivers each message.

## Topics

### Creating a Message

[`init(identifier:conversationIdentifier:content:dateSent:sender:recipients:groupName:messageType:serviceName:audioMessageFile:)`](/documentation/Intents/INMessage/init(identifier:conversationIdentifier:content:dateSent:sender:recipients:groupName:messageType:serviceName:audioMessageFile:))

Creates a message with the specified content and an optional audio message file.

[`init(identifier:conversationIdentifier:content:dateSent:sender:recipients:groupName:messageType:serviceName:)`](/documentation/Intents/INMessage/init(identifier:conversationIdentifier:content:dateSent:sender:recipients:groupName:messageType:serviceName:))

Creates a message with the specified content and an optional service name.

[`init(identifier:conversationIdentifier:content:dateSent:sender:recipients:groupName:messageType:)`](/documentation/Intents/INMessage/init(identifier:conversationIdentifier:content:dateSent:sender:recipients:groupName:messageType:))

Creates a message with the specified content and an optional group name.

[`init(identifier:conversationIdentifier:content:dateSent:sender:recipients:messageType:)`](/documentation/Intents/INMessage/init(identifier:conversationIdentifier:content:dateSent:sender:recipients:messageType:))

Creates a message of a distinct type with the specified content.

[`init(identifier:content:dateSent:sender:recipients:)`](/documentation/Intents/INMessage/init(identifier:content:dateSent:sender:recipients:))

Creates a message with the specified content.

### Identifying the Message

[`identifier`](/documentation/Intents/INMessage/identifier)

The message’s unique identifier.

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

The identifier of the conversation that contains this message.

### Getting the Participants

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

The person who sent the message.

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

The people who received the message.

### Getting the Content

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

The text that Siri recites to the message recipient.

[`audioMessageFile`](/documentation/Intents/INMessage/audioMessageFile)

An audio recording that Siri plays to the message recipient.

### Getting the Supplementary Attributes

[`dateSent`](/documentation/Intents/INMessage/dateSent)

The date and time the app sent the message to each recipient.

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

The name of the grouped conversation.

[`messageType`](/documentation/Intents/INMessage/messageType)

The type of content the message contains.

[`INMessageType`](/documentation/Intents/INMessageType)

Constants that describe the kinds of content a message can contain.

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

The name of the service that delivers 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)