@radzor/whatsapp-send

Send WhatsApp messages via the Meta Cloud API. Supports text, template, and media messages with delivery and read receipt tracking.

Messagingv0.1.0typescriptpythonServerwhatsappmessagingsmscloud-apimetanotificationsby Radzor

Install

View source on GitHub →

$npx radzor@latest add whatsapp-send

⚠ Constraints: Requires a Meta Business account with WhatsApp API access. Template messages must be pre-approved by Meta. Phone numbers must include country code without + prefix. Media URLs must be publicly accessible HTTPS URLs.

Inputs

Name	Type	Default	Description
accessToken*	string	—	Meta Cloud API access token.WHATSAPP_ACCESS_TOKEN
phoneNumberId*	string	—	WhatsApp Business phone number ID.WHATSAPP_PHONE_NUMBER_ID
apiVersion	string	v18.0	Graph API version (default: v18.0).

accessToken*string

Meta Cloud API access token.

WHATSAPP_ACCESS_TOKEN

phoneNumberId*

{ "llm": { "constraints": "Requires a Meta Business account with WhatsApp API access. Template messages must be pre-approved by Meta. Phone numbers must include country code without + prefix. Media URLs must be publicly accessible HTTPS URLs.", "usageExamples": "llm/examples.md", "integrationPrompt": "llm/integration.md" }, "name": "@radzor/whatsapp-send", "tags": [ "whatsapp", "messaging", "sms", "cloud-api", "meta", "notifications" ], "events": [ { "name": "onMessageDelivered", "payload": { "messageId": "string", "timestamp": "string", "recipientPhone": "string" }, "description": "Fired when a message is delivered to the recipient's device." }, { "name": "onMessageRead", "payload": { "messageId": "string", "timestamp": "string", "recipientPhone": "string" }, "description": "Fired when the recipient reads the message." } ], "inputs": [ { "name": "accessToken", "type": "string", "envVar": "WHATSAPP_ACCESS_TOKEN", "required": true, "description": "Meta Cloud API access token." }, { "name": "phoneNumberId", "type": "string", "envVar": "WHATSAPP_PHONE_NUMBER_ID", "required": true, "description": "WhatsApp Business phone number ID." }, { "name": "apiVersion", "type": "string", "default": "v18.0", "required": false, "description": "Graph API version (default: v18.0)." } ], "radzor": "1.0.0", "actions": [ { "name": "sendText", "params": [ { "name": "to", "type": "string", "description": "Recipient phone number in international format (e.g. 14155552671)." }, { "name": "body", "type": "string", "description": "Message text body." }, { "name": "previewUrl", "type": "boolean", "required": false, "description": "Whether to show URL previews." } ], "returns": "Promise<{ messageId: string }>", "description": "Send a plain text message." }, { "name": "sendTemplate", "params": [ { "name": "to", "type": "string", "description": "Recipient phone number." }, { "name": "templateName", "type": "string", "description": "Approved template name." }, { "name": "languageCode", "type": "string", "description": "Template language code (e.g. en_US)." }, { "name": "components", "type": "object[]", "required": false, "description": "Template component parameters (header, body, button variables)." } ], "returns": "Promise<{ messageId: string }>", "description": "Send a pre-approved template message." }, { "name": "sendMedia", "params": [ { "name": "to", "type": "string", "description": "Recipient phone number." }, { "name": "mediaType", "type": "\"image\" | \"video\" | \"audio\" | \"document\"", "description": "Type of media to send." }, { "name": "mediaUrl", "type": "string", "required": false, "description": "Public URL of the media file." }, { "name": "mediaId", "type": "string", "required": false, "description": "Previously uploaded media ID." }, { "name": "caption", "type": "string", "required": false, "description": "Optional caption for image/video/document." } ], "returns": "Promise<{ messageId: string }>", "description": "Send a media message (image, video, audio, or document)." }, { "name": "markAsRead", "params": [ { "name": "messageId", "type": "string", "description": "WhatsApp message ID to mark as read." } ], "returns": "Promise<boolean>", "description": "Mark an incoming message as read (sends blue ticks)." } ], "outputs": [ { "name": "sendResult", "type": "{ messageId: string; recipientPhone: string }", "fields": [ { "name": "messageId", "type": "string", "description": "WhatsApp message ID (wamid)." }, { "name": "recipientPhone", "type": "string", "description": "Recipient phone number." } ], "description": "Result of a send operation." } ], "runtime": "server", "version": "0.1.0", "category": "messaging", "languages": [ "typescript", "python" ], "description": "Send WhatsApp messages via the Meta Cloud API. Supports text, template, and media messages with delivery and read receipt tracking.", "dependencies": { "radzor": [], "packages": {} }, "composability": { "connectsTo": [ { "event": "onMessageDelivered", "description": "Track WhatsApp message delivery for analytics", "compatibleWith": [ "@radzor/event-tracker.action.track.eventName", "@radzor/log-aggregator.action.info.message" ] }, { "output": "sendResult", "mapField": "messageId", "compatibleWith": [ "@radzor/log-aggregator.action.info.message" ] } ] } }

@radzor/whatsapp-send

Install

Inputs

Outputs

Actions

Events

Composability

radzor.manifest.json