---
title: INStartVideoCallIntent
framework: intents
role: symbol
role_heading: Class
path: intents/instartvideocallintent
---

# INStartVideoCallIntent

A request to start a video call with one or more users.

## Declaration

```swift
class INStartVideoCallIntent
```

## Overview

Overview The system creates INStartVideoCallIntent objects to let you know when the user wants to place a video call using your app. A video call intent object contains the users to include in the call. It’s up to you to match the information in this object to contacts in your app and to initiate the resulting call. Your Intents extension receives this intent when the user tries to initiate a call from the Siri interface. If your app supports CallKit, you may also receive this intent when the user tries to initiate a call from system interfaces such as the Recents tab of the Phone app. To handle this intent, the handler object in your Intents extension must adopt the INStartVideoCallIntentHandling protocol. Your handler confirms the request and creates an INStartVideoCallIntentResponse object to indicate that it’s possible to begin the call. Don’t try to initiate calls directly from your Intents extension. SiriKit launches your app and passes it an NSUserActivity object that your app must then use to initiate the call. SiriKit places an INInteraction object in the user activity object with this intent. For calls initiated through Siri, the interaction object also includes the response provided by your Intents extension. For a list of other intents in the VoIP calling domain, see INCallsDomainHandling. Additional Intent Attributes The following table lists additional attributes of this intent object:  |   |   |  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. Example Phrases There are many ways in which users can ask Siri to place a video call. The table below provides a few sample phrases in different languages. You can use these phrases during testing to trigger your intents. This list isn’t exhaustive and Siri may recognize many other phrases.  |  |   |  |   |  |   |  |   |  |   |  |   |  |   |  |   |  |   |  |   |  |   |  |   |  |   |  |   |  |   |  |   |  |   |  |   |  |   |  |   |  |   |  |   |  |   |  |  In the preceding examples, <appName> represents the name of the app whose Intents extension initiates the call. If your app uses custom names for contacts, you can tell Siri about those names using the INVocabulary class.

## Topics

### Initializing the Intent Object

- [init(contacts:)](intents/instartvideocallintent/init(contacts:).md)

### Getting the Recipients of the Call

- [contacts](intents/instartvideocallintent/contacts.md)

## Relationships

### Inherits From

- [INIntent](intents/inintent.md)

### Conforms To

- [CVarArg](swift/cvararg.md)
- [CustomDebugStringConvertible](swift/customdebugstringconvertible.md)
- [CustomStringConvertible](swift/customstringconvertible.md)
- [Equatable](swift/equatable.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)

## See Also

### Video Call Initiation

- [INStartVideoCallIntentHandling](intents/instartvideocallintenthandling.md)
- [INStartVideoCallIntentResponse](intents/instartvideocallintentresponse.md)