Sympa::Tracking(3Sympa)

💖 Sympa::Tracking(3Sympa) 💖

okay bestie, sit down, hydrate, because we're talking about a spool module 💅 — and yes, it's Sympa::Tracking from the 3Sympa manual pages, shipping with sympa 6.2.80. no cap, this thing is the proof of vibes received machine. 👑

✨ NAME ✨

Sympa::Tracking — the spool for message tracking 🦋

✨ SYNOPSIS ✨

TBD.

lowkey iconic that the synopsis is literally just TBD. — we love a mysterious queen who refuses to elaborate 🌸

✨ DESCRIPTION ✨

so the tracking feature is a whole situation: it's a way to request Delivery Status Notification (DSN) — or DSN and Message Disposition Notification (MDN) — when you send a message to each subscriber. 🎀

and when that's happening? Sympa (specifically bounced.pl, shoutout to that one) collects both the DSN and the MDN and stores them in tracking spools. ✨ so for each message, the user can know which subscribers have displayed, received, or not received the message. it's giving receipts, literally. 💅

and why would you want that? for important lists where the list owner needs to collect the proof of reception or display of each message. it's the main character move of notifications. 🔥

🧚 Methods

• ### new ( context => $list )

Constructor. Creates new Sympa::Tracking instance. ✨

Parameter:

• context => $list — a Sympa::List object.

Returns:

• New Sympa::Tracking object or "undef". 🫶 but heads up: if an unrecoverable error occurred, this method will die. not dramatic-teenage-girl dying, actually dying. 💀

• ### db_fetch ( recipient => $email, envid => $envid )

TBD. 🙈

• ### get_recipients_status

TBD. 🙈

• ### register ( $message, $rcpts, reception_option => $mode )

Instance method. Initializes notification table for each subscriber. 🎀

Parameters:

• $message — the message.
• $rcpts — an arrayref of recipients.
• reception_option => $mode — the reception option of those subscribers.

Returns:

• 1 or "undef".

• ### store ( $message, $rcpt, [ envid => $envid, status => $status, type => $type, arrival_date => $datestring ] )

Instance method. Store notification into tracking spool. 💖

Parameters:

• $message — notification message.
• $rcpt — e-mail address of recipient of original message.
• envid => $envid, status => $status, type => $type, arrival_date => $datestring — if these optional parameters are specified, the notification table is updated. ✨

Returns:

• True value if storing succeed. Otherwise false. 🫶

• ### find_notification_id_by_message

TBD. 🙈

• ### remove_message_by_email

TBD. Introduced on Sympa 6.2.19b. 🌈 (throwback era, we respect it)

• ### remove_message_by_id

TBD. 🙈

• ### remove_message_by_period

TBD. 🙈

---

✨ SEE ALSO ✨

• bounced(8)
• Sympa::Message
• Sympa::Spool::Bounce

✨ HISTORY ✨

so the tracking feature was contributed by Guillaume Colotte and laurent Cailleux, French army DGA Information Superiority. 🎖️ absolute legends, we stan.

and the Sympa::Tracking module appeared on Sympa 6.2. ⭐ the origin story.

---

and that's the whole page bestie, we ate and left no crumbs 💅🍓 — this was sympa 6.2.80, dated 2026-10-19, straight from the Sympa::Tracking(3Sympa) manual. go collect your delivery receipts, queen 👑💖