Trigger: Call Incoming

The Call Incoming trigger fires when a standard phone call is incoming (i.e., the phone is ringing). This allows you to automate actions when receiving calls, such as sending auto-reply messages, or logging call attempts.

Options

Select Contacts - Trigger for incoming calls from 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 incoming calls from contacts in specific groups
- Choose one or more contact groups (e.g., Favorites, Family, Work)
Specify Number - Trigger for incoming calls from 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 incoming call regardless of the caller

Special Contact Types

When selecting contacts, the following special options are available:

Any Contact - Triggers for incoming calls from numbers saved in your contacts
Non Contact - Triggers for incoming calls from numbers not in your contacts
Unknown Caller - Triggers for incoming calls from 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: Increase Ringer for Important Contacts

Triggers

Call Incoming (Group: Family)

Actions

Volume Change: Ring to 100%

Example 2: Log Unknown Caller Attempts and Reject Call

Triggers

Call Incoming (Unknown Caller)

Actions

Write to File: Unknown caller at {hour}:{minute}:{second}
Notification: Incoming call from unknown number
Call Reject

Notes

This trigger fires when the phone starts ringing, before the call is answered
The trigger uses a PhoneStateListener to monitor incoming call state
For actions during an active call, use the Call Active trigger instead
Contact exclusion allows you to trigger for "all calls except" certain contacts

Permissions Required

Read Phone State - Required to monitor incoming calls
Read Call Log - Required for call information access
Read Contacts - Required for contact-based filtering (when using contacts)

See Also