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 → Force Download

AI-generated

Summary

Queue a background download of a media item to the selected WhatsApp account’s local storage. Use this when a media item was skipped or its download failed; after the operation, poll Get until its state is downloaded, then use Download File to retrieve the bytes.

Inputs

  • Account Name or ID — Select the WhatsApp account, or leave empty to auto-select when the API key is bound to a single account. A key that can use multiple accounts requires an explicit choice.
  • Media ID (required) — The media item’s ID, from Media: Get Many or a media.discovered trigger event.

Output shape

A single JSON record

Returns the server response, documented as {success: true, state}. The request only queues the download; it returns no file bytes, and the state is typically queued while the download runs in the background. An expired WhatsApp file may not be recoverable and can end in failed. Requires SocialMate Pro.

Links

Discussion