WA-AKGInstall

Summary

Send a media file to a WhatsApp recipient

Inputs

• sessionId (required) — Session ID to use for this request
• jid (required) — WhatsApp JID of the recipient (e.g., 628xxx@s.whatsapp.net for a user, xxxxx@g.us for a group)
• mediaUrl (required) — Direct URL to the image, video, audio, or document (e.g. https://domain.com/image.jpg)
• mediaType (required) — The type of media to send. This determines how WhatsApp will render the message.
• additionalFields — Additional custom fields for the media request (e.g., caption, document filename).

Output shape

object representing the response from the WhatsApp API for the sent media (typically includes a message ID and status)

Returns a single record; on error the node may output an error object if continueOnFail is disabled.

Examples

Example 1: Send a promotional image to a user

sessionId = mySession, jid = 12345@s.whatsapp.net, mediaUrl = https://example.com/promo.jpg, mediaType = image, additionalFields.caption = "Check out the new collection!"

Example 2: Upload a PDF document to a group

sessionId = botSession, jid = 56789@g.us, mediaUrl = https://example.com/report.pdf, mediaType = document, additionalFields.docFileName = "Annual Report.pdf"

Example 3: Send a custom sticker to a contact

sessionId = session123, jid = 98765@s.whatsapp.net, mediaUrl = https://example.com/sticker.webp, mediaType = image, additionalFields.packName = "My Stickers", additionalFields.stickerAuthor = "John"

Links

• n8n community nodes installation guide