Changes

no edit summary
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]]