emnify AI agent connector: manage the cellular connectivity of your fleet with your agent

Give your flespi AI agent an emnify account for zero-effort connectivity automation of your telematics fleet: SIMs, devices, policies and connectivity managed on your behalf

The emnify connector gives your flespi AI agent access to an emnify account: emnify documentation and API expertise plus direct work with the SIMs, devices, policies and connectivity of your fleet on your behalf. Use it for zero-effort connectivity automation of your telematics fleet: the SIMs of your devices stay activated, within budget and on the network, whether or not the devices send their data to flespi.

New to flespi AI agents? Read the flespi AI agents article first: what agents are, how they reason and sleep, and how approvals keep you in control. This article covers the emnify side of the story. For a fleet on Onomondo SIMs there is the Onomondo connector instead.

1. Connect the account

One configuration field, token, holds an emnify application token. In the emnify Portal open Integrations, then Application tokens, and add a token. Pick its role, set an expiry date if you want one, and copy the value the moment it appears. The Portal shows it once:

add an application token in the emnify Portal under Integrations

The token carries the role you assign to it and works in the Workspace it was created in. Administrator covers everything, User the day-to-day connectivity work, Observer a read-only view. To limit the agent, create the token in the Workspace it should manage with the narrowest role that covers the work you delegate.

Create a connector of the emnify type: open the flespi panel, navigate to AI, then Connectors, click the "+" button, pick the type and paste the token:

create an emnify AI connector in the flespi panel

Assign the connector to your agent (create one if you have none yet), choosing the rules for the account-changing emnify API calls: the default, and above it a rule per part of the API you want handled differently, from endpoints and SMS to devices to SIMs, policies, tags and bulk operations. The pencil button on the Connectors tab of the agent opens the same rules at any time:

the emnify API Mutate rules of the connector assigned to the AI agent

The token defines the ceiling. The agent works within its role and Workspace, and asks for a wider token when a task is out of reach instead of attempting calls that will fail. A revoked or expired token surfaces at the next call, and the agent asks you to reconnect the connector with a fresh one.

2. Work with the agent

The agent knows emnify: it consults the official emnify documentation and the API reference on its own, so you can discuss SIMs, devices, service and coverage policies (the service and tariff profiles of the API), data limits, network events and usage the way you would with an emnify engineer.

Reading the account is free and autonomous, through a read-only surface that physically cannot change anything: SIMs and their status, whether a device is online and on which network, its data sessions, events and monthly usage.

Hand it the SIM housekeeping of a fleet and it designs the setup, then runs it on its own: a data limit on the service policy cuts a device off at the monthly volume, scheduled checks suspend the SIMs that hit it, report the ones that went silent, and send you a weekly usage and cost summary:

the AI agent sets up the silent SIM scan and the weekly summary and designs the data cap

Cost has one lever: an Activated SIM is billed whatever its device does, a Suspended one stops accruing from the next month and reactivates at any time. So pausing a device for cost is a SIM suspension, and the agent says so before touching a status. Every change waits for your approval unless you delegate it.

Events can also reach the agent live: it gives you a webhook address to set as the destination of an emnify data stream, and reacts to each SIM event as it arrives instead of polling for it.

3. When the devices also report to flespi

When the agent also holds the flespi connector of the account the same devices report to, it reasons across both systems. It pairs a flespi device with its SIM by IMEI or phone number, and a silent tracker gets a connectivity check before a device check: SIM status, network attach, last data session, the events of the silent period. The agent tells you which side the evidence points to.

Ask, and the agent designs such checks across both accounts and runs them on its own: a tracker silent for an hour triggers the SIM diagnosis and a message with the findings, a tracker deleted from flespi suspends its SIM so you stop paying for it:

the AI agent designs the silent tracker check and the deleted tracker rule across flespi and emnify

The agent can also build a web page with the connectivity state of every SIM, reading emnify directly under a read-only token of its own.

Configuration SMS to the devices take the flespi path: an emnify modem in the flespi account, created with an application token that may list SIMs and send SMS, resolves the phone field of a device (its number or ICCID) to the endpoint, and the agent sends a bootstrap or diagnostic command to a silent tracker as a flespi device command, with the text rendered for the device protocol and the delivery logged on the device. A raw SMS text through the emnify SMS endpoint stays an emnify API write under the connector rules.

4. Approvals and logs

Every account-changing emnify API call goes through the agent approval rules as the emnify_api_mutate operation type, and by default each call becomes an approval request. Rules let you delegate the routine and keep the sensitive part under review, for example endpoint changes such as tags and policy assignment on automatic execution while SMS to devices, connectivity resets and SIM status changes still ask. You review the exact call, its path and its body before approving:

approval requests of the data limit change on the service policy

Approved, the calls run and the agent confirms the new limit against the live account:

the AI agent confirms the new data limit after the approvals

Mind what the default protects before relaxing it: SIM suspension and deletion, policy changes that apply to every device on the policy, SMS and connectivity resets sent to physical devices, data streams, users and application tokens. The agent coordinates every change with you either way. The rules only decide whether you confirm each call before it leaves.

Executed mutations land in the agent conversation history as emnify_api_mutate_executed records, and every emnify API call the agent makes on your behalf, reads included, is recorded in the connector logs with the method, path and result:

emnify connector logs with the agent reads and mutations

To put the agent in front of the people you serve rather than yourself, pair the connector with a persona: the agent takes your name, speaks their vocabulary, and under branded disclosure never mentions flespi.

A system of yours that has no connector type of its own, an ERP, a ticketing system or the intake of an authority, joins through the HTTP API connector: the agent bridges it with your emnify account, reading one side and writing the other under your approval rules.

The emnify connector is one of several an agent can hold: browse the full connector list to give your agent more capabilities, such as a Telegram or Slack chat with the agent and its approval prompts.

Subscribe to the flespi AI and MCP change log to stay in sync with any updates.


See also
A free no-code app for automating your trackers, built by a flespi AI agent. Each automation runs on standard flespi components in its own subaccount.