engagement_report
Build an email engagement report
Use this when the user pastes an email event export (Customer.io reporting webhook, SendGrid or Mailgun events) and wants a per-recipient engagement report, a CSV or the events with no recipient. Input tips: send the raw export text itself as events, never a file name or link; the events field lists the shapes read. Add recipients_csv or campaigns_csv only when the user gives them. Rules default to: dedup on, a 14 day window, machine opens as impressions only, bounce clears delivered. Set a rule only when the user names a different window or rule. Returns: a per-send summary, up to 500 recipient rows (csv holds every row), up to 100 exceptions, parse_errors and the rules used. A file that mixes platforms is read event by event. Only for the user's own sends: it reads event types, times and ids, and reads or returns no IP address, user agent, device or location. Next step: when events_kept is 0 or parse_errors is not empty, show the errors and ask for the raw export. Not for: sending mail or calling a mail platform API.
ruleseventsrequiredcampaigns_csvrecipients_csv