Returns a flat array across the profile's Instagram, Facebook, and WhatsApp
conversations, oldest first by occurredAt. Uses the
aggregate response contract.
Query parameters
platform"instagram" | "facebook" | "whatsapp"- Return one provider's messages only.
facebookcovers every connected Facebook Page's Messenger conversations. Anything else, includingtiktokandyoutube, returns422 unsupported_platform. accountIduuid- Narrow to one connected account.
profileIduuid- Required unless you pass accountId, which names its profile. If you pass both, they must agree.
Message fields
idstring- Adeli's identifier for this message.
providerIdstring | null- The provider's message id.
direction"inbound" | "outbound"- Relative to the connected account.
type"text" | "template" | "unsupported"unsupportedcovers media and other payloads Adeli does not normalize.senderstring | null- Set on inbound messages — the provider-scoped participant id (an IGSID on Instagram, a PSID on Facebook).
recipientstring | null- Set on outbound messages.
statusstring- Provider delivery state, such as
receivedorsent. occurredAtISO 8601- When the provider recorded the message. Sort on this.
If a provider sync fails, Adeli still returns the messages it has already
persisted and reports the failure in errors, which makes the response 207.
Errors — 401 unauthorized, 400 invalid_request,
422 unsupported_platform, 404 profile_not_found, 404 account_not_found,
502 provider_error.