Class

INSearchForBillsIntent

A request for the list of bills matching the specified criteria.

Declaration

@interface INSearchForBillsIntent : INIntent

Overview

Siri creates an INSearchForBillsIntent object when the user asks to see pending or already paid bills. The intent object contains the values to match when searching for bills. Users can search for bills based on whether they are pending or already paid, based on the due date, based on the payee, and based on the type. When performing the search, use only the provided parameters to filter the search results and ignore any parameters that have a missing or unknown value.

To handle this intent, the handler object in your Intents extension must adopt the INSearchForBillsIntentHandling protocol. Your handler should confirm the request and create an INSearchForBillsIntentResponse object with the results of the search. For successful searches, Siri offers a way for the user to view the results.

Additional Intent Attributes

Table 1 lists additional attributes of this intent object.

Table 1

Search for bills intent attributes

Attribute

Description

Supported by

Siri Intents

Always requires unlocked device

Yes

When performing a search, Siri automatically asks the user to unlock a currently locked device. You don’t need to explicitly ask to unlock the device.

Example Phrases

Users can ask Siri to search for bills in a variety of ways. Table 2 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.

Table 2

Siri phrases that trigger a search for bills

Locale

Example 1

Example 2

en

Show my bills

Show my electricity bill

zh_CN

显示我的账单

显示我的电费账单

zh_HK

顯示我嘅賬單

顯示我嘅水費賬單

zh_TW

查詢我的帳單

查詢我的電費帳單

yue_CN

显示我嘅账单

显示我嘅水费账单

ar

عرض الفواتير

عرض فاتورة الكهرباء

da

Vis mine regninger

vis min elregning

de

Zeige meine Rechnungen

Zeige mir meine Stromrechnung

es

Enséñame mis facturas

Muestra mis facturas de la electricidad

fi

Näytä laskut

Näytä sähkölasku

fr

Affiche mes factures

Montre-moi mes factures d'électricité

he

תראי את החשבונות שלי

תראי את חשבון החשמל שלי

it

controlla le bollette

controlla la mia bolletta della luce

ja

請求書を見せて

電気代の請求書を見せて

ko

청구서 보여줘

전기세 영수증 보여줘

ms

Tunjukkan bil saya

Tunjukkan bil elektrik saya

nb

Vis regningene mine

Vis strømregningen min

nl

Toon mijn rekeningen

Toon mijn electriciteitsfactuur

pt

Mostra minhas contas

Mostra minha conta de eletricidade

ru

Покажи мои счета

Показать мой счёт за электричество

sv

Visa mina räkningar

Visa min elräkning

th

แสดงบิล

โชว์บิลค่าน้ำ

tr

Faturalarımı göster

Elektrik faturasını göster

In Table 2, <appName> represents the name of the app whose Intents extension initiates the transaction.

Topics

Initializing the Intent Object

- initWithBillPayee:paymentDateRange:billType:status:dueDateRange:

Initializes the search for bills intent object with the specified search parameters.

Getting the Search Attributes

billPayee

The recipient of the payment.

billType

The type of the bill.

dueDateRange

The range of due dates in which to search for bills.

paymentDateRange

The range of payment dates in which to search for bills.

status

The status of the bill.

Relationships

Inherits From

See Also

Search for Bills

INSearchForBillsIntentHandling

The handler interface for searching for bills associated with the user.

INSearchForBillsIntentResponse

Your app’s response to a request to a search for bills.

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