mailerpress/get-contact-stats returns rolled-up engagement for a contact: total opens, total clicks, total unsubscribes, attributed WooCommerce revenue and the last-activity timestamp.
An optional campaign ID narrows it to one campaign.
At a glance
| Ability | mailerpress/get-contact-stats |
| Toolset | MailerPress — toolset/mailerpress |
| Group | MailerPress › Contacts |
| Requires | AcrossAI Pro, plus MailerPress active on the site |
| Capability | manage_options |
| Safety | Read-only — changes nothing |
| Repeatable | Idempotent — running it twice leaves the same result |
| Ships in | AcrossAI Pro 0.9.16 and later |
How it works
The last-activity timestamp is the most operationally useful field. It is the single number that distinguishes an engaged contact from a dormant one, and it is what a re-engagement segment is usually built on.
Attributed revenue is the one that carries weight in a commercial conversation and the one to treat carefully. It attributes a WooCommerce purchase to a click in an email, which is one model of attribution among several — a customer who would have bought anyway is counted the same as one persuaded.
It also requires the WooCommerce integration and tracking to have been on at send time. Zero revenue on a site without those is a configuration fact rather than a performance one.
Narrowing to one campaign turns this into a per-campaign per-contact view, which is how you check whether one specific send reached and moved one specific person.
Input
| Name | Type | Required | What it is |
|---|---|---|---|
contact_id | integer | Yes | The contact. |
campaign_id | integer | No | Narrow to one campaign. |
What comes back
| Name | Type | What it is |
|---|---|---|
stats | object | Total opens, clicks, unsubscribes, attributed revenue and last activity. |
success | boolean | Whether the call completed. |
message | string | A one-line summary of what happened, suitable for showing a human. |
error_code | string | Present only on failure — a stable machine-readable reason, such as a missing field, a wrong field type or an unmet confirmation. |
Example
Ask your assistant:
How engaged is this contact?
It resolves to one call:
{
"ability": "mailerpress/get-contact-stats",
"parameters": {
"contact_id": 118
}
}Worth knowing
- Last activity is the field that separates engaged from dormant.
- Revenue attribution credits a click, which is one model among several.
- Zero revenue without WooCommerce and tracking is configuration, not performance.
- Read-only.
Related abilities
- MailerPress Get Contact Activity — the timeline behind it
- MailerPress Pro List Segments — build a re-engagement audience
Get the plugins:
AcrossAI Abilities Manager · AcrossAI MCP Manager
Browse the rest: Every ability, by category