Changes

no edit summary
Line 1: Line 1: −
This trigger will fire when an outgoing call is placed.
+
<pre class="header-style">
 +
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>
   −
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.
+
''' Options '''
 +
 
 +
* '''Select Contacts''' - Choose specific contacts from your contact list. You can select multiple contacts and optionally exclude them instead of matching.
 +
** '''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
 +
 
 +
* '''Select Groups''' - Filter by contact groups (such as Favorites or Friends). The trigger fires when calling anyone within selected groups.
 +
 
 +
* '''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 Number''' - Fires regardless of the number dialed
 +
 
 +
''' 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: Set call volume to the maximum when making a work call.
 +
 
 +
  <pre class="trigger-style">Triggers
 +
 
 +
Call Outgoing [Select Groups: Business]</pre>
 +
  <pre class="action-style">Actions
 +
 
 +
Set Volume: Call (100%)</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]]