Difference between revisions of "Trigger: Call Active"
| (7 intermediate revisions by the same user not shown) | |||
| Line 1: | Line 1: | ||
| − | < | + | <pre class="header-style">The Call Active trigger fires when a standard phone call is actively in progress. This allows you to automate actions during phone calls, such as enabling speakerphone, adjusting volume, or recording call start times.</pre> |
| − | + | ''' Options ''' | |
| − | * ''' | + | * '''Select Contacts''' - Trigger for calls with 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 calls with contacts from specific groups | ||
| + | ** Choose one or more contact groups (e.g., Favorites, Family, Work) | ||
| + | * '''Specify Number''' - Trigger for 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 call regardless of the number | ||
| − | + | ''' Special Contact Types ''' | |
| − | + | When selecting contacts, the following special options are available: | |
| + | * '''Any Contact''' - Triggers for any number that is saved in your contacts | ||
| + | * '''Non Contact''' - Triggers for numbers not saved in your contacts | ||
| + | * '''Unknown Caller''' - Triggers for 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: Enable Speakerphone for Work Calls'' | |
| + | <pre class="trigger-style">Triggers | ||
| − | = | + | Call Active (Group: Work)</pre> |
| + | <pre class="action-style">Actions | ||
| − | + | Speakerphone On</pre> | |
| − | |||
| − | |||
| − | = | + | ''Example 2: Log Unknown Caller Calls'' |
| + | <pre class="trigger-style">Triggers | ||
| − | + | Call Active (Unknown Caller)</pre> | |
| + | <pre class="action-style">Actions | ||
| + | |||
| + | Write to File: Unknown call at [date_time]</pre> | ||
| + | |||
| + | ''' Notes ''' | ||
| + | |||
| + | * This trigger fires when a call becomes active (answered), not when ringing | ||
| + | * An outgoing call is considered active as soon as you have dialled out (It's not possible to detect when the recipient accepts the call | ||
| + | * The trigger monitors both incoming and outgoing calls | ||
| + | * Contact exclusion allows you to trigger for "all except" certain contacts | ||
| + | * A background service monitors the phone state for this trigger to work | ||
| + | * USSD codes on Android 14+ may require a UI interaction action to click the call button | ||
| + | |||
| + | ''' Permissions Required ''' | ||
| + | |||
| + | * '''Read Phone State''' - Required to monitor call state | ||
| + | * '''Read Contacts''' - Required for contact-based filtering | ||
| + | * '''Read Call Log''' - Required for call information access | ||
| + | |||
| + | ''' See Also ''' | ||
| + | |||
| + | * [[Trigger:_Call_Incoming|Call Incoming Trigger]] | ||
| + | * [[Trigger:_Call_Ended|Call Ended Trigger]] | ||
| + | * [[Trigger:_Call_Missed|Call Missed Trigger]] | ||
Latest revision as of 22:00, 5 January 2026
The Call Active trigger fires when a standard phone call is actively in progress. This allows you to automate actions during phone calls, such as enabling speakerphone, adjusting volume, or recording call start times.
Options
- Select Contacts - Trigger for calls with 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 calls with contacts from specific groups
- Choose one or more contact groups (e.g., Favorites, Family, Work)
- Specify Number - Trigger for 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 call regardless of the number
Special Contact Types
When selecting contacts, the following special options are available:
- Any Contact - Triggers for any number that is saved in your contacts
- Non Contact - Triggers for numbers not saved in your contacts
- Unknown Caller - Triggers for 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: Enable Speakerphone for Work Calls
Triggers Call Active (Group: Work)
Actions Speakerphone On
Example 2: Log Unknown Caller Calls
Triggers Call Active (Unknown Caller)
Actions Write to File: Unknown call at [date_time]
Notes
- This trigger fires when a call becomes active (answered), not when ringing
- An outgoing call is considered active as soon as you have dialled out (It's not possible to detect when the recipient accepts the call
- The trigger monitors both incoming and outgoing calls
- Contact exclusion allows you to trigger for "all except" certain contacts
- A background service monitors the phone state for this trigger to work
- USSD codes on Android 14+ may require a UI interaction action to click the call button
Permissions Required
- Read Phone State - Required to monitor call state
- Read Contacts - Required for contact-based filtering
- Read Call Log - Required for call information access
See Also