OpenParable
Skip to content
← Back to skills

Whatsapp Send Skill

Apps & Automation
whatsapp-send-skill

Whatsapp Send Skill is an Agent Skill for apps & automation published in the zeenie-ai/OpenCompany repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Send WhatsApp messages to contacts, groups, or channels. Supports text, images, videos, audio, documents, stickers, locations, and contacts.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/zeenie-ai/OpenCompany/blob/HEAD/server/skills/social_agent/whatsapp-send-skill/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/whatsapp-send-skill, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

WhatsApp Send Tool

Send messages to WhatsApp contacts, groups, or newsletter channels.

How It Works

This skill provides instructions for the WhatsApp Send tool node. Connect the WhatsApp Send node to Zeenie's input-tools handle to enable message sending.

whatsapp_send Tool

Send messages to individual contacts, groups, or channels.

Schema Fields

FieldTypeRequiredDescription
recipient_typestringYes"phone" for individual, "group" for group chat, or "channel" for newsletter
phonestringIf phonePhone number without + prefix (e.g., 1234567890)
group_idstringIf groupGroup JID (e.g., [email protected])
channel_jidstringIf channelNewsletter JID (e.g., 120363198765432101@newsletter)
message_typestringYesMessage type (see below)
messagestringIf textText message content
media_urlstringIf mediaURL for image/video/audio/document/sticker
captionstringNoCaption for media messages
latitudefloatIf locationLatitude coordinate
longitudefloatIf locationLongitude coordinate
location_namestringNoDisplay name for location
addressstringNoAddress text for location
contact_namestringIf contactContact display name
vcardstringIf contactvCard 3.0 format string

Message Types

TypeRequired FieldsDescription
textmessagePlain text message
imagemedia_urlImage file (JPG, PNG, GIF)
videomedia_urlVideo file (MP4)
audiomedia_urlAudio file (MP3, OGG, WAV)
documentmedia_urlAny file type
stickermedia_urlSticker image (WebP)
locationlatitude, longitudeGPS coordinates
contactcontact_name, vcardContact card

Examples

Send text message to contact:

{
  "recipient_type": "phone",
  "phone": "1234567890",
  "message_type": "text",
  "message": "Hello! How are you?"
}

Send image with caption:

{
  "recipient_type": "phone",
  "phone": "1234567890",
  "message_type": "image",
  "media_url": "https://example.com/photo.jpg",
  "caption": "Check out this photo!"
}

Send to group:

{
  "recipient_type": "group",
  "group_id": "[email protected]",
  "message_type": "text",
  "message": "Hello everyone!"
}

Send to channel (newsletter):

{
  "recipient_type": "channel",
  "channel_jid": "120363198765432101@newsletter",
  "message_type": "text",
  "message": "Channel update: new features released!"
}

Channel limitations: Channels only support text, image, video, audio, and document message types. Sticker, location, and contact are NOT supported. You must be an admin/owner of the channel to send.

Send video:

{
  "recipient_type": "phone",
  "phone": "1234567890",
  "message_type": "video",
  "media_url": "https://example.com/video.mp4",
  "caption": "Check this video"
}

Send document:

{
  "recipient_type": "phone",
  "phone": "1234567890",
  "message_type": "document",
  "media_url": "https://example.com/report.pdf",
  "caption": "Here's the report"
}

Send location:

{
  "recipient_type": "phone",
  "phone": "1234567890",
  "message_type": "location",
  "latitude": 37.7749,
  "longitude": -122.4194,
  "location_name": "San Francisco",
  "address": "San Francisco, CA, USA"
}

Send contact card:

{
  "recipient_type": "phone",
  "phone": "1234567890",
  "message_type": "contact",
  "contact_name": "John Doe",
  "vcard": "BEGIN:VCARD\nVERSION:3.0\nFN:John Doe\nTEL:+1234567890\nEND:VCARD"
}

Response Format

{
  "success": true,
  "recipient": "1234567890",
  "recipient_type": "phone",
  "message_type": "text",
  "details": {
    "status": "sent",
    "preview": "Hello! How are you?",
    "timestamp": "2025-01-30T12:00:00"
  }
}

Error Response

{
  "error": "Phone number is required for recipient_type='phone'"
}

Guidelines

  1. Phone numbers: Always use without + prefix, just digits (e.g., 919876543210)
  2. Group IDs: Use JID format ending in @g.us (e.g., [email protected])
  3. Channel JIDs: Use JID format ending in @newsletter (e.g., 120363198765432101@newsletter)
  4. Media URLs: Must be publicly accessible URLs (https://)
  5. vCard format: Use vCard 3.0 specification for contact cards
  6. Message length: Text messages can be up to 4096 characters
  7. Media size: Check WhatsApp limits for media file sizes

Common Use Cases

  • Send automated notifications to contacts
  • Forward messages to groups
  • Share media files
  • Send location information
  • Share contact information

Setup Requirements

  1. Connect the WhatsApp Send node to Zeenie's input-tools handle
  2. Ensure WhatsApp is connected (green status indicator in Credentials)
  3. The recipient must have WhatsApp installed