MacroDroid Wiki

Changes

Trigger: Call Incoming (view source)

Revision as of 22:06, 5 January 2026

1,726 bytes added ,  Monday at 22:06
no edit summary
Line 1: Line 1: −
<pre class="header-style">
+
<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>
−
This trigger will fire when a standard phone call is incoming (i.e. the phone is ringing).
  −
</pre>
     −
'''Magic Text'''<br/>
+
''' Options '''
−
When this trigger is used, you can access magic text via the [...] button where available.<br/>[https://macrodroidforum.com/wiki/index.php/Magic_text#Call_.28Active.2C_Ended.2C_Incoming.2C_Missed.2C_Outgoing.29 magic text]
     −
'''Configuration Options'''
+
* '''Select Contacts''' - Trigger for incoming calls from specific contacts
 +
** 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
   −
* Select Contact(s)
+
''' Special Contact Types '''
   −
'''''Any Contact'''''
+
When selecting contacts, the following special options are available:
−
- A call with any number that is in your contacts is incoming.
+
* '''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
   −
'''''Non Contact'''''
+
''' Magic Text '''
−
- A call  with any number that is not your contacts is incoming.
     −
'''''Unknown Caller'''''
+
When this trigger fires, the following value are available via magic text for use in subsequent actions.
−
- A call with an unknown number (e.g. private number) is incoming.
     −
* Select Group(s)
+
* {call_number}
 +
* {call_name}
 +
* {call_groups}
   −
You can select to trigger based on a contact group (e.g. Favourites/Friends etc.). The trigger will fire when a call is incoming with any contact from within the chosen group.
+
''' Examples '''
   −
* Select Number
+
''Example 1: Increase Ringer for Important Contacts''
 +
  <pre class="trigger-style">Triggers
   −
You can specify a specific number to match against (or partial match).
+
Call Incoming (Group: Family)</pre>
 +
  <pre class="action-style">Actions
   −
* Any Number
+
Volume Change: Ring to 100%</pre>
   −
When selecting this option the trigger will fire when any call is ended (regardless of number).
+
''Example 2: Log Unknown Caller Attempts''
 +
  <pre class="trigger-style">Triggers
 +
 
 +
Call Incoming (Unknown Caller)</pre>
 +
  <pre class="action-style">Actions
 +
 
 +
Write to File: Unknown caller at [date_time]
 +
Notification: Incoming call from unknown number</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]]
Retrieved from ‘https://macrodroidforum.com/wiki/index.php/Special:MobileDiff/2948’