Save WhatsApp Media to Contact Documents in Sparkforge

By Sparkforge Support Team ·Last reviewed May 3, 2026

Add to Documents stores inbound and outbound WhatsApp attachments inside a contact's Documents folder for one year, so files do not disappear when Meta's native media expiry hits.

WhatsApp media (images, videos, PDFs, audio, and other files) expires on Meta's side. Sparkforge's Add to Documents action saves any attachment to the contact's Documents folder for one year, matching the existing Email and SMS save flow.

What it does

  • Stores WhatsApp message attachments inside the contact's Documents folder.
  • Available on every inbound and outbound WhatsApp media message.
  • Retains saved files for one year from the time of saving.
  • Surfaces a success or failure toast so you know if the save worked.

Requirements

  • Active WhatsApp channel connected to Sparkforge.
  • User access to Conversations and the contact's Documents.
  • The original WhatsApp file must not have already expired on Meta's side.

Supported media and limits

  • Common WhatsApp types: images, videos, PDFs, audio, and other file attachments.
  • Available on inbound and outbound media messages in Conversations.
  • If a file expired on WhatsApp before you save it, the action will fail.

How to save WhatsApp media

  1. Open Conversations and pick a thread with WhatsApp media.
  2. On the media message, open the message actions (kebab/ellipsis).
  3. Click Add to Documents.
  4. Watch for the success toast.
  5. Open Contacts → [Contact Name] → Documents to confirm the file is there.

Troubleshooting

  • Media expired: Ask the contact to resend, then save promptly.
  • Permission denied: Check the user's access to Conversations and Contact Documents.
  • File type or size issue: Verify the file meets supported limits.
  • Network or transient error: Retry after a few seconds.

Frequently Asked Questions

Does Add to Documents work for both inbound and outbound media?
Yes. The action is available on every inbound and outbound WhatsApp media message in Conversations.
How long do saved WhatsApp files stay in Documents?
One year from the moment you save the file.
What happens if the WhatsApp file already expired?
The save action fails. Ask the contact to resend the file, then save it before Meta's expiry runs out again.
Where do I find saved files later?
Open the contact record and go to the Documents tab to view, download, or remove saved files.
Can I bulk save attachments from a single message?
Add to Documents applies per media item. If a message has multiple attachments, repeat the action for each one.

Was this article helpful?

Related Articles