Changes

no edit summary
Line 1: Line 1:  
<pre class="header-style">
 
<pre class="header-style">
This trigger will fire when a missed call occurs. (i.e. you didn't answer an incoming call)
+
This trigger will fire when a missed call occurs. A missed call is defined as an incoming call that you did not answer.
 
</pre>
 
</pre>
    +
''' Options '''
   −
'''Magic Text'''<br/>
+
* '''Select Contacts''' - Choose specific contacts from your contact list. You can select multiple contacts and optionally exclude them instead of matching.
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]
+
** '''Any Contact''' - Fires when a missed call comes from any number saved in your contacts
 +
** '''Non Contact''' - Fires when a missed call comes from a number not in your contacts
 +
** '''Unknown Caller''' - Fires when a missed call has an unknown or private number (caller ID blocked)
   −
'''Configuration Options'''
+
* '''Select Groups''' - Filter by contact groups (such as Favorites or Friends). The trigger activates only when missed calls come from members of the chosen groups.
   −
* Select Contact(s)
+
* '''Select Number''' - Specify an exact or partial phone number to match. Supports wildcards and regular expressions.
 +
** '''Exclude''' - Option to trigger for all numbers EXCEPT the specified number
 +
** '''Enable Regex''' - Enable regular expression matching for advanced pattern matching
   −
'''''Any Contact'''''
+
* '''Any Number''' - Fires regardless of the calling number
- A call with any number that is in your contacts was missed.
     −
'''''Non Contact'''''
+
''' Magic Text '''
- A call  with any number that is not your contacts was missed.
     −
'''''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) was missed.
     −
* 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 with any contact from within the chosen group is made.
+
''' Examples '''
   −
* Select Number
+
Example 1: Send notification when spouse calls and you miss it
   −
You can specify a specific number to match against (or partial match).
+
  <pre class="trigger-style">Triggers
   −
* Any Number
+
Call Missed [Select Contacts: Spouse]</pre>
 +
  <pre class="action-style">Actions
   −
When selecting this option the trigger will fire when any call is ended (regardless of number).
+
Notification: Missed call from {call_name}</pre>
 +
 
 +
Example 2: Log all missed calls from unknown numbers
 +
 
 +
  <pre class="trigger-style">Triggers
 +
 
 +
Call Missed [Unknown Caller]</pre>
 +
  <pre class="action-style">Actions
 +
 
 +
Set Variable: missed_call_log = {lv=missed_call_log} + "\n" + {call_number} + " at " + [date_time]</pre>
 +
 
 +
''' Notes '''
 +
 
 +
* This trigger monitors the call log for missed calls. It requires the READ_CALL_LOG permission.
 +
* When using contact-based options, the READ_CONTACTS permission is also required.
 +
* The trigger uses a 90-second lookback window to detect missed calls, which helps when used with the "Wait Until Trigger" action.
 +
* Multiple missed calls in quick succession are deduplicated based on timestamp to prevent double-firing.
 +
* The trigger checks constraints before invoking the macro.
 +
 
 +
''' Permissions Required '''
 +
 
 +
* READ_PHONE_STATE
 +
* READ_CALL_LOG
 +
* READ_CONTACTS (when using contact or group-based filtering)
 +
 
 +
''' See Also '''
 +
 
 +
* [[Trigger:_Call_Active|Call Active Trigger]]
 +
* [[Trigger:_Call_Ended|Call Ended Trigger]]
 +
* [[Trigger:_Call_Incoming|Call Incoming Trigger]]
 +
* [[Trigger:_Call_Outgoing|Call Outgoing Trigger]]