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

• Call Active Trigger
• Call Ended Trigger
• Call Missed Trigger
• Call Outgoing Trigger