| Line 1: |
Line 1: |
| − | This trigger will be fired when a call is actively in progress.
| + | <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> |
| | | | |
| − | For example
| + | ''' Options ''' |
| − | Active call > SpeakerPhone On
| |
| | | | |
| − | You can create more combinations using conditions or restrictions.
| + | * '''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]] |