SocialMate icon

SocialMate

Control WhatsApp from n8n or an AI agent: send & read messages, look up contacts, manage groups, download media, queue paced batches of personalised messages, and fetch conversation memory (Get AI Context) — all through your self-hosted SocialMate server.

Actions66

Media → Get

AI-generated

Summary

Retrieve metadata for one media item from a selected WhatsApp account using its media ID. The operation returns metadata only; use Media: Download File to fetch the item's bytes.

Inputs

  • Account Name or ID — Select the WhatsApp account. It can be left empty when the API key is bound to one account; choose an account explicitly when the key can access multiple accounts.
  • Media ID (required) — The media item's ID, obtained from Media: Get Many or a media.discovered trigger event.

Output shape

A single item containing the media metadata as JSON.

Metadata includes fields such as messageId, chatId, type, mimeType, fileName, fileSize, caption, direction, dimensions or duration when available, state, downloadedAt, aiContext, needsContext, apiPath, and thumbnailApiPath. It does not include file bytes. Check state to determine whether the file is downloaded and available through Download File.

Links

Discussion