Changes

no edit summary
Line 1: Line 1:  
<pre class="header-style">
 
<pre class="header-style">
This trigger will fire when an outgoing call is made.
+
This trigger will fire when an outgoing call is placed. You can specify a particular contact that the outgoing call is to, or alternatively you can specify that the call can be to Any Contact, a Non Contact or Any Number.
 
</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 calling any number saved in your contacts
 +
** '''Non Contact''' - Fires when calling a number not in your contacts
 +
** '''Unknown Caller''' - Fires when calling private or unknown numbers
   −
'''Configuration Options'''
+
* '''Select Groups''' - Filter by contact groups (such as Favorites or Friends). The trigger fires when calling anyone within selected 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 number dialed
- An outgoing call with any number that is in your contacts is made.
     −
'''''Non Contact'''''
+
''' Magic Text '''
- An outgoing call  with any number that is not your contacts is made.
     −
'''''Unknown Caller'''''
+
When this trigger fires, the following value are available via magic text for use in subsequent actions.
- An outgoing call with an unknown number (e.g. private number) is made.
     −
* 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: Start call recording when calling business contacts
   −
You can specify a specific number to match against (or partial match).
+
  <pre class="trigger-style">Triggers
   −
* Any Number
+
Call Outgoing [Select Groups: Business]</pre>
 +
  <pre class="action-style">Actions
   −
When selecting this option the trigger will fire when any call is ended (regardless of number).
+
Start Call Recording</pre>
 +
 
 +
Example 2: Log all outgoing calls
 +
 
 +
  <pre class="trigger-style">Triggers
 +
 
 +
Call Outgoing [Any Number]</pre>
 +
  <pre class="action-style">Actions
 +
 
 +
Set Variable: call_log = [call_log] + "\n" + "OUT: " + [call_name_or_number] + " at " + [date_time]</pre>
 +
 
 +
''' Notes '''
 +
 
 +
* This trigger listens for the ACTION_NEW_OUTGOING_CALL broadcast.
 +
* When using contact-based options, the READ_CONTACTS permission is required.
 +
* The trigger fires before the call is actually placed.
 +
 
 +
''' Permissions Required '''
 +
 
 +
* PROCESS_OUTGOING_CALLS
 +
* 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_Missed|Call Missed Trigger]]
 +
* [[Trigger:_Dial_Phone_Number|Dial Phone Number Trigger]]