997
edits
Changes
no edit summary
<pre class="header-style">The Call Incoming trigger fires when a standard phone call is incoming (i.e., the phone is ringing). This allows you to automate actions when receiving calls, such as sending auto-reply messages, or logging call attempts.</pre>
''' Options '''
'''Example Usage'''<br/>
* '''Select Contacts''' - Trigger for incoming calls from specific contacts
Incoming call (unknown caller or a NON contact > call rejected.
** Choose from your contacts list
** Includes special options: Any Contact, Non Contact, Unknown Caller
** Option to exclude selected contacts instead of including them
* '''Select Groups''' - Trigger for incoming calls from contacts in specific groups
** Choose one or more contact groups (e.g., Favorites, Family, Work)
* '''Specify Number''' - Trigger for incoming calls from a specific phone number
** Enter a phone number or partial number match
** Supports wildcards for partial matching
** Option to exclude the specified number
** Supports regex pattern matching
** Magic text can be used for dynamic numbers
* '''Any Number''' - Trigger for any incoming call regardless of the caller
''' Special Contact Types '''
When selecting contacts, the following special options are available:
* '''Any Contact''' - Triggers for incoming calls from numbers saved in your contacts
* '''Non Contact''' - Triggers for incoming calls from numbers not in your contacts
* '''Unknown Caller''' - Triggers for incoming calls from private/hidden numbers
''' Magic Text '''
When this trigger fires, the following value are available via magic text for use in subsequent actions.
* {call_number}
* {call_name}
* {call_groups}
''' Examples '''
''Example 1: Increase Ringer for Important Contacts''
<pre class="trigger-style">Triggers
Call Incoming (Group: Family)</pre>
<pre class="action-style">Actions
Volume Change: Ring to 100%</pre>
''Example 2: Log Unknown Caller Attempts and Reject Call''
<pre class="trigger-style">Triggers
Call Incoming (Unknown Caller)</pre>
<pre class="action-style">Actions
Write to File: Unknown caller at {hour}:{minute}:{second}
Notification: Incoming call from unknown number
Call Reject</pre>
''' Notes '''
* This trigger fires when the phone starts ringing, before the call is answered
* The trigger uses a PhoneStateListener to monitor incoming call state
* For actions during an active call, use the Call Active trigger instead
* Contact exclusion allows you to trigger for "all calls except" certain contacts
''' Permissions Required '''
* '''Read Phone State''' - Required to monitor incoming calls
* '''Read Call Log''' - Required for call information access
* '''Read Contacts''' - Required for contact-based filtering (when using contacts)
''' See Also '''
* [[Trigger:_Call_Active|Call Active Trigger]]
* [[Trigger:_Call_Ended|Call Ended Trigger]]
* [[Trigger:_Call_Missed|Call Missed Trigger]]
* [[Trigger:_Call_Outgoing|Call Outgoing Trigger]]