Difference between revisions of "Trigger: Call Incoming"

Revision as of 22:06, 5 January 2026

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.

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

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

Triggers

Call Incoming (Group: Family)

Actions

Volume Change: Ring to 100%

Example 2: Log Unknown Caller Attempts

Triggers

Call Incoming (Unknown Caller)

Actions

Write to File: Unknown caller at [date_time]
Notification: Incoming call from unknown number

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

@@ 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]]