AgiMate for Android

An agent on your phone: intercepts notifications, calls, and device events — and passes them to your AI agents for processing.

Two operating modes

The app works in two directions: sends events from the device and receives commands from the backend.

Device triggers

Wi-Fi connection

Fires when connecting to or disconnecting from a Wi-Fi network. Can filter by network name.

Example: employee arrives at office → AI launches morning briefing

Battery level

Fires when charge drops below threshold or when plugged into charger.

Example: charge < 15% on work tablet → alert in Telegram

Incoming call

Fires on incoming, missed, or ended calls. Sends number and duration.

Example: missed call → AI sends SMS 'Will call back in 5 minutes'

App notification

Intercepts notifications from selected apps. Sends title, text, and app name.

Example: Ozon notification 'New order' → AI processes the order

All triggers run in the background — no need to keep the app open.

Remote actions

Push notification

Send a push notification to the device with a custom title and text from the backend.

Example: AI detects anomaly → push 'Attention: unusual activity at 14:32'

Text-to-Speech (TTS)

Speak text aloud via system Text-to-Speech. Works even with screen locked.

Example: critical alert → phone says 'Attention, stock of item X is below minimum'

Commands arrive instantly via WebSocket connection to the backend.

How it works

Architecture of interaction between the app, backend, and your AI

Android App
Triggers + actions
HTTP ↑ / WebSocket ↓
AgiMate Backend
API Gateway + WebSocket
Your AI / n8n
Logic and automation
1

App registers with the backend

On first launch, the app authenticates with a device key and establishes a WebSocket connection.

2

Trigger fires on the device

An event (Wi-Fi, battery, call, notification) is intercepted in the background.

3

Data is sent to the backend via HTTP

The app sends a JSON with event type and data to the API Gateway.

4

Backend calls webhook or n8n

The event is routed to subscribers: webhooks, n8n workflows, or AI agent.

5

AI sends a command back

The response command (push, TTS) arrives on the device via WebSocket instantly.

App interface

Three main screens — simple and intuitive

Triggers screen

List of all triggers with on/off toggles.

  • Toggle triggers with a single tap
  • Configure parameters for each trigger
  • Status indicator: active / inactive
  • Log of recent trigger events

Actions screen

History of received commands and their execution status.

  • Real-time incoming command log
  • Status: completed / error
  • Test push and TTS sending
  • WebSocket connection indicator

Settings

Backend connection and app configuration.

  • Enter device key
  • Backend URL (default: AgiMate cloud)
  • Auto-start on device boot
  • Permission management

For developers

Technical documentation on data formats and requirements

Trigger format (JSON)

Each trigger sends an event in the following format:

{
  "type": "device.wifi_connected",
  "deviceId": "abc-123",
  "timestamp": "2025-01-15T14:30:00Z",
  "data": {
    "ssid": "Office-5G",
    "bssid": "00:1A:2B:3C:4D:5E"
  }
}
Action format (JSON)

Commands are sent to the device in the following format:

{
  "action": "notify",
  "payload": {
    "title": "Attention",
    "body": "Stock of item X is below minimum",
    "priority": "high"
  }
}
Requirements and permissions
Android8.0+ (API 26)
APK size~5 MB
ConnectionWi-Fi or mobile data
Background workForeground Service
ProtocolHTTPS + WSS

Android permissions

  • INTERNET — network communication
  • ACCESS_NETWORK_STATE — Wi-Fi monitoring
  • READ_PHONE_STATE — call information
  • RECEIVE_BOOT_COMPLETED — auto-start
  • POST_NOTIFICATIONS — sending notifications
  • FOREGROUND_SERVICE — background operation

Installation

Five simple steps from download to your first trigger

1

Download the APK

Download the latest APK version from GitHub Releases.

Download APK
2

Allow installation from unknown sources

Settings → Security → Unknown sources (or allow for your browser).

3

Install and open the app

Run the APK file, wait for installation, and open AgiMate.

4

Enter the device key

Create a key in Dashboard → Mobile Devices and paste it in the app settings.

5

Enable the triggers you need

Select triggers, grant the required permissions — done!

Download AgiMate for Android

Open-source. Free. Full control over your data.