Protocol

INSendMessageIntentHandling

An interface to handle sending messages to one or more designated users.

Declaration

protocol INSendMessageIntentHandling

Overview

Use the methods of the INSendMessageIntentHandling protocol to resolve, confirm, and handle requests to send messages to the designated users. Adopt this protocol in an object of your Intents extension that is capable of sending the messages.

Siri delivers an INSendMessageIntent object to your handler when the user asks to send a message using your app. The provided intent object contains the recipients and content of the message. Use the methods of this protocol to resolve the parameters and to validate that sending the message is possible.

Topics

Resolving the Intent Parameters

func resolveRecipients(for: INSendMessageIntent, with: ([INSendMessageRecipientResolutionResult]) -> Void)

Resolves the user’s input when it is not clear who are the recipients of the message.

func resolveContent(for: INSendMessageIntent, with: (INStringResolutionResult) -> Void)

Resolves the contents of the message.

func resolveSpeakableGroupName(for: INSendMessageIntent, with: (INSpeakableStringResolutionResult) -> Void)

Resolves the name of the group receiving the message.

func resolveRecipients(for: INSendMessageIntent, with: ([INPersonResolutionResult]) -> Void)

Called when you need to resolve the recipients of the message.

Deprecated
func resolveGroupName(for: INSendMessageIntent, with: (INStringResolutionResult) -> Void)

Called when you need to resolve the name of the group receiving the message.

Deprecated

Confirming the Response

func confirm(intent: INSendMessageIntent, completion: (INSendMessageIntentResponse) -> Void)

Confirms that you can send the message.

Handling the Intent

func handle(intent: INSendMessageIntent, completion: (INSendMessageIntentResponse) -> Void)

Sends the message to the specified recipients.

Required.

Relationships

Inherits From

Inherited By

See Also

Send a Message

class INSendMessageIntent

A request to send a message to the designated recipients.

class INSendMessageIntentResponse

Your app’s response to a send message intent.

Beta Software

This documentation contains preliminary information about an API or technology in development. This information is subject to change, and software implemented according to this documentation should be tested with final operating system software.

Learn more about using Apple's beta software