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