---
title: "didReceive(_:conversation:)"
framework: messages
role: symbol
role_heading: Instance Method
path: "messages/msmessagesappviewcontroller/didreceive(_:conversation:)"
---

# didReceive(_:conversation:)

Invoked when the iMessage app receives a new message object.

## Declaration

```swift
func didReceive(_ message: MSMessage, conversation: MSConversation)
```

## Parameters

- `message`: The received message object.
- `conversation`: The conversation that the user is currently viewing in the Messages app.

## Mentioned in

Adding Sticker packs and iMessage apps to the system Stickers app, Messages camera, and FaceTime

## Discussion

Discussion Override this method to respond to messages that arrive while your extension is active. If your app displays information about the currently selected message, check the incoming message’s session against the selected message’s session. If they match, update the information displayed in your user interface to represent the most recent message data (see Listing 1). Listing 1. Updating the current session override func didReceive(_ message: MSMessage, conversation: MSConversation) {     // Check to see if the incoming message is part of a session     if let incomingSession = message.session {         // Check to see if the incoming session matches the current message’s session         if incomingSession == conversation.selectedMessage?.session {             // Update your user interface here...         }     } } note: There is an inherent race condition when multiple participants send messages using the same session object. You cannot guarantee the order in which the messages are received. To ensure that your app always has the latest data, save your data to a server (for example, using CloudKit) and have your messages just carry an ID for that data. Your app can then look up the current data whenever it receives a new message. This method is called when a new message arrives while your extension is active. You receive notifications about messages sent using your extension only. You cannot interact with messages from other extensions. The system does not call this method if the controller’s presentationStyle property is MSMessagesAppPresentationStyle.transcript, or if its presentationContext property is MSMessagesAppPresentationContext.media.

## See Also

### Tracking Messages

- [willSelect(_:conversation:)](messages/msmessagesappviewcontroller/willselect(_:conversation:).md)
- [didSelect(_:conversation:)](messages/msmessagesappviewcontroller/didselect(_:conversation:).md)
- [didStartSending(_:conversation:)](messages/msmessagesappviewcontroller/didstartsending(_:conversation:).md)
- [didCancelSending(_:conversation:)](messages/msmessagesappviewcontroller/didcancelsending(_:conversation:).md)