Difference between revisions of "Trigger: Call Outgoing"

(Created page with "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...")
 
 
(10 intermediate revisions by 3 users not shown)
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]]

Latest revision as of 22:15, 5 January 2026

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.

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.

Triggers

Call Outgoing [Select Groups: Business]
Actions

Set Volume: Call (100%)

Example 2: Log all outgoing calls

Triggers

Call Outgoing [Any Number]
Actions

Set Variable: call_log = [call_log] + "\n" + "OUT: " + [call_name_or_number] + " at " + [date_time]

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