Skip to content

Operations

Data and privacy

Content retention, what the daily purge deletes, ZIP export, deleting the content or the organization, and the fixed deadlines.

Everything lives under Settings → Data and privacy. Messajo keeps conversation content only for as long as the organization chooses, and the owner can export or delete everything at any time (LGPD and GDPR).

The owner or an admin chooses for how many days content is kept: from 7 up to the instance ceiling (RETENTION_MAX_DAYS, 730 by default). Without a choice, 90 days apply (RETENTION_DEFAULT_DAYS). Outside that range, the API returns 422 retention_out_of_range.

  • The deadline counts from when the data was stored in Messajo, not from the message’s original date. The 6 months of history imported under coexistence are stored on the import day and count from there.
  • Before saving a shorter deadline, the panel shows how many messages and files the next purge removes and from which date content is kept.
  • Lowering it is irreversible: whatever passed the deadline is gone in the next purge.

The purge runs every day at 02:40 UTC. For each organization, whatever is older than the deadline goes:

Removed Rule
Messages and their media files the organization’s deadline
Conversations with no remaining message and contacts with no conversation the organization’s deadline
Recipients and imports of finished campaigns the organization’s deadline (the campaign stays, with its numbers)
Instagram comments, story insights and finished publications the organization’s deadline
Events, deliveries and API request logs the smaller of 30 days and the deadline

What stays: organization, members, connections, API keys, destinations, templates and audit log. Header media used by a still-active campaign only goes after the campaign ends. If storage fails while deleting a file, it stays marked and the next purge tries again: nothing is orphaned.

These do not change with retention:

Data Deadline
Raw event received from Meta 7 days
Connection signup events 90 days
Audit log 365 days
Export and deletion requests (the record, not the file) 1 year
Export file 7 days

Owner only, with 2FA turned on.

  1. Under Export data, choose whether you want the media files (the ZIP gets much bigger) and click Request export.
  2. Messajo builds the ZIP in the background and emails you when it is ready. The email links to the panel, never to the file.
  3. Under Requests, click Download. The link is valid for 15 minutes and every download is recorded in the audit log.

The file is available for 7 days. After that, 410 data_export_expired. Up to 3 exports per 24 hours (429 data_request_limit) and one of each kind at a time (409 data_request_in_progress).

The ZIP contains manifest.json and one file per kind of data, in NDJSON (one JSON object per line): organization, members, invitations, connections, contacts and identities, conversations, messages (messages/YYYY-MM.ndjson), media (plus media/ with the files, if requested), templates, campaigns and recipients, destinations, deliveries, events, API keys, audit log and Instagram data. Tokens, secrets, password or key hashes, 2FA codes and sessions are never included.

Delete content removes messages, media, contacts, conversations, campaigns, events, deliveries and logs. The organization, members, connections, keys, destinations, templates and audit log stay. To confirm, type the organization’s slug. It cannot be undone; an email tells you when it is done.

Under Settings → Organization → Delete organization, the owner confirms with the slug. The deletion runs in the background:

  1. disconnects every connection from Meta;
  2. deletes all content and files;
  3. deletes the organization, members, keys and the rest.

The panel shows Deletion in progress until it ends, and the requester gets an email. If a step fails, the request becomes failed and Try again continues from the step where it stopped. The request record is kept for 1 year as proof of deletion.