| 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]] |