AgiMate Android connector

Connects your phone to your agents. Calls, Wi-Fi changes, a low battery and entering a zone become triggers for the agent, and notifications, the calendar, contacts and the camera become its tools.

Triggers and tools

The phone tells the agent what is happening to it and does what the agent asks.

Triggers

Calls

An incoming call and a missed one. Android does not give the caller's number to third-party apps, so the event does not carry it. A missed call comes with how long it rang.

Example: a call missed during a meeting → the agent reminds you in the evening to call back

Low battery

Fires when the system reports a low battery. The event carries the current percentage.

Example: the work tablet is running out → the agent says so in Telegram

Wi-Fi

Joining a network and leaving it. The event carries the network name and signal strength.

Example: the phone joined the office network → the agent sends the plan for the day

Shake

The phone was shaken. The simplest button there is, and it is always at hand.

Example: a shake → the agent reads out your next meetings

Entering and leaving a zone

The phone entered a zone or left it. The agent sets the zones itself.

Example: you left the office → the agent reminds you to stop by the shop

The connector runs in the background, there is no need to keep it open. Only the triggers you enable reach the agent.

Agent tools

Notification

An ordinary system notification with a title and text. It does not wait for an answer.

Example: "The report is ready, it's in your files"

Question

A notification with a question and up to three answer buttons. You can also reply with text right from the shade. The agent waits up to five minutes.

Example: "Move the call to 4 pm?" → Yes / No

Read aloud

The phone reads text aloud with the system speech engine.

Example: the agent tells you out loud that you need to leave in 10 minutes

Contact search

Searches the address book by name, number or email. Dumping the whole book is not possible.

Example: "Find Olga's number from accounting"

Calendar

Finds events in a time range and creates new ones. Recurring events are expanded into separate occurrences.

Example: "What do I have on Thursday?", "Book a meeting tomorrow at 10"

Camera photo

The agent asks for a photo and you confirm it in a notification. The camera does not turn on without your tap, that is an Android restriction.

Example: the agent asks you to photograph a receipt to log the expense

Zones

Add a zone with a centre and a radius, remove it or list them. Entering and leaving a zone reach the agent as triggers.

Example: "Tell me when I get to the cottage"

A call reaches the phone over WebSocket, the result goes back to the agent. The agent does not see a tool you have switched off.

How it works

The phone, the platform and the agent

Android connector
Triggers and tools
HTTP ↑ / WebSocket ↓
AgiMate
Delivers events and calls
Your agent
Decides what to do
1

The phone is linked to your account

You create an app in the dashboard and paste its key into the connector. The connector tells the platform which triggers and tools are enabled on it.

2

Something happens on the phone

A missed call, entering a zone, a shake. The connector sends the event to the platform over HTTPS.

3

The agent gets the event

The platform passes it to the agents that have access to this phone.

4

The agent calls a tool

The call reaches the phone over WebSocket. The connector runs it and sends the result back to the agent.

Interface

Three tabs. The interface is in English only for now.

Triggers

Which events the phone sends to the agent.

  • A switch for every trigger
  • Permission is asked when you switch one on
  • Recent events with their delivery status
  • Clearing the log

Tools

What the agent is allowed to do on the phone.

  • Tools grouped into sections
  • A switch for every tool
  • Permission is asked when you switch one on
  • The agent does not see a switched-off tool

Settings

The connection to the platform.

  • Device Key, the app key from the dashboard
  • Server URL, AgiMate cloud by default
  • Linking the device and checking the connection
  • Debug logs

For developers

Event and call format, requirements and permissions

Event (JSON)

This is how the connector sends an event to the platform:

{
  "id": "evt-001",
  "type": "DEVICE_EVENT",
  "name": "wifi_connected",
  "source": "android-app",
  "deviceId": "device-abc123",
  "occurredAt": "2026-07-23T12:00:00Z",
  "data": {
    "ssid": "Office-5G",
    "bssid": "00:11:22:33:44:55",
    "signalStrength": -45
  }
}
Tool call (JSON)

This is how a tool call reaches the phone:

{
  "type": "toolCall",
  "payload": {
    "id": "019f6c63-67f5-7fe8-be0f-031b9b4645ae",
    "connectorCode": "app",
    "connectionId": "01951234-abcd-ef01-2345-6789abcdef02",
    "name": "tts_speak",
    "input": { "text": "Time to leave in 10 minutes" },
    "agentSessionId": "0193b8e3-ad77-7c31-a4f0-8e7c9d2f1a77"
  }
}
Requirements and permissions
Android7.0 or later (API 24)
ConnectionWi-Fi or mobile data
Background workForeground Service
Platform linkHTTPS + WebSocket (Centrifugo)

Android permissions

  • Each permission is asked for when you enable the trigger or tool that needs it
  • INTERNET, ACCESS_NETWORK_STATE — talking to the platform
  • ACCESS_WIFI_STATE — the Wi-Fi trigger
  • READ_PHONE_STATE — the call trigger
  • ACCESS_FINE_LOCATION, ACCESS_COARSE_LOCATION, ACCESS_BACKGROUND_LOCATION — zones
  • READ_CONTACTS — contact search
  • READ_CALENDAR, WRITE_CALENDAR — calendar
  • CAMERA, FOREGROUND_SERVICE_CAMERA — camera photo
  • POST_NOTIFICATIONS — notifications and questions
  • FOREGROUND_SERVICE, FOREGROUND_SERVICE_SPECIAL_USE — background work
  • RECEIVE_BOOT_COMPLETED — starting after the phone reboots

Installation

Five steps from download to the first event

1

Download the APK

The latest version is in GitHub Releases.

Download APK
2

Allow installing from unknown sources

Android asks for it by itself the first time you open the APK. The permission goes to the app you downloaded the file with, usually the browser.

3

Install and open the connector

Open the downloaded file and confirm the installation.

4

Paste the key

In the dashboard, under Apps, create an app and copy its key. In the connector, paste it into Device Key on the Settings tab and link the device.

5

Enable triggers and tools

Tick what the agent needs and grant the permissions Android asks for.

Download the AgiMate Android connector

Free and open source. The APK is in GitHub Releases.