• DELIVERED
  • URL-BASED
  • AUTOMATED
  • HUMAN

How to send WhatsApp media and files with your AI

Connect Gupshup Messaging to your agent to distribute files. Once connected, your agent handles the media delivery through WhatsApp URLs.

Ask AI about this page

Short answer

How can my AI send files on WhatsApp?

Your agent uses the Gupshup Messaging MCP to push media to specific phone numbers. It works by taking a file URL and sending it as a media message. You'll see how the agent handles the delivery process below.

Media delivery outcomes

Where your files land

What happens when your agent triggers a media send.

DELIVERED

Files reach customers

The agent sends the image, video, or document via WhatsApp. The recipient gets the file directly in their chat.

URL-BASED

Uses hosted links

The agent pulls media from a URL you provide. It uses these links to populate the WhatsApp media message.

AUTOMATED

No manual uploads

Your agent handles the heavy lifting of matching the file to the recipient. You just tell it what to send and where.

HUMAN

Review required

If a file URL is missing or broken, the agent stops and asks you for the correct link before trying again.

The workflow

What your AI does when you ask for a file send.

The agent moves from your text command to a successful WhatsApp delivery.

  1. Identify the media

    Your agent looks at your request to find the specific file URL and the target phone number.

    send_media_message

  2. Format the request

    The agent prepares the data payload required by the messaging service to ensure the file type is recognized.

    send_media_message

  3. Execute the send

    The agent triggers the specific tool to push the media to the WhatsApp recipient.

    send_media_message

  4. Confirm delivery

    The agent checks that the message was sent successfully and reports back to you.

    send_media_message

Try it

Copy these to start.

Use these prompts to trigger media sends immediately.

Starting points

Replace the bracketed info with your actual file links and customer numbers.

Gupshup Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_zWJUY2HD7eK0izOG5QNTYOdA1x7SNxZUeNTNvfPq/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — Gupshup capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "gupshup-messaging-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_zWJUY2HD7eK0izOG5QNTYOdA1x7SNxZUeNTNvfPq/mcp"
    }
  }
}
Copy into chat04

  • Send this image to +1234567890 using this URL: https://example.com/photo.jpg

  • WhatsApp this PDF document to the customer at +1987654321: https://example.com/invoice.pdf

  • Send the product video to the contact in my sheet using this link: https://example.com/promo.mp4

  • Can you send the attached brochure URL to the user at +15550123?

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Start here

Connect Gupshup Messaging once, then ask.

Click the link to link your Gupshup account. Your credentials stay encrypted and secure, and you can start sending files right away.

Connect Gupshup Messaging to your AI

FAQ

How the media task behaves

  • 01

    Can the AI upload files directly from my computer?

    No. The agent requires a URL for the media file to send it via WhatsApp.

  • 02

    Does the AI decide which files to send?

    No. The agent only sends the specific files you instruct it to send via the provided URLs.

  • 03

    Can the AI delete messages sent to customers?

    No. This MCP only has the capability to send media messages.

  • 04

    Will it work with any file type?

    It works with standard image, video, and document formats supported by WhatsApp.

  • 05

    Can the AI read my WhatsApp messages?

    No. This specific tool is for sending media, not reading incoming chat history.

  • More questions about Gupshup Messaging? The Connector page answers them. See everything the Gupshup Messaging Connector can do

Connect Gupshup to Claude, Cursor, ChatGPT & more