Send a text message to a WhatsApp user.

Args:

• to (string): Recipient phone number in international format

• body (string): Message text (max 4096 chars)

• preview_url (boolean): Show URL preview (default: false)

Returns: Message ID and delivery status.

Examples:

• "Send hello to +353851234567" → to="+353851234567", body="hello"

Send an approved template message. Templates are the only way to initiate conversations outside the 24-hour window.

Args:

• to (string): Recipient phone number

• template_name (string): Approved template name

• language_code (string): Template language (default: "en_US")

• components (string, optional): JSON string of template components for dynamic values

Returns: Message ID and delivery status.

Examples:

• "Send welcome template to user" → template_name="hello_world", language_code="en_US"

Send an image to a WhatsApp user via a public URL.

Args:

• to (string): Recipient phone number

• image_url (string): Public URL of the image

• caption (string, optional): Image caption (max 1024 chars)

Returns: Message ID and delivery status.

Send a document (PDF, DOCX, etc.) to a WhatsApp user via a public URL.

Args:

• to (string): Recipient phone number

• document_url (string): Public URL of the document

• filename (string, optional): Display filename

• caption (string, optional): Document caption

Returns: Message ID and delivery status.

Send a location pin to a WhatsApp user.

Args:

• to (string): Recipient phone number

• latitude (number): Latitude (-90 to 90)

• longitude (number): Longitude (-180 to 180)

• name (string, optional): Location name

• address (string, optional): Location address

Returns: Message ID and delivery status.

Send a contact card to a WhatsApp user.

Args:

• to (string): Recipient phone number

• first_name (string): Contact first name

• last_name (string, optional): Contact last name

• phone (string): Contact phone number

• email (string, optional): Contact email

Returns: Message ID and delivery status.

Send a reaction emoji to an existing message.

Args:

• to (string): Phone number of the conversation

• message_id (string): wamid of the message to react to

• emoji (string): Emoji character (e.g. '👍')

Returns: Confirmation of reaction sent.

Send a message with up to 3 reply buttons.

Args:

• to (string): Recipient phone number

• body_text (string): Main message body

• buttons (string): JSON array of buttons: [{"id":"btn1","title":"Yes"},{"id":"btn2","title":"No"}]

• header_text (string, optional): Header text

• footer_text (string, optional): Footer text

Returns: Message ID and delivery status.

Send a message with a menu list of options.

Args:

• to (string): Recipient phone number

• body_text (string): Main message body

• button_text (string): Text on the list menu button

• sections (string): JSON array of sections with rows

• header_text (string, optional): Header text

• footer_text (string, optional): Footer text

Returns: Message ID and delivery status.

Mark a received WhatsApp message as read (shows blue checkmarks).

Args:

• message_id (string): The wamid of the message to mark as read

Returns: Confirmation.

Retrieve the WhatsApp Business Profile for the configured phone number.

Returns: Business profile fields: about, address, description, email, websites, vertical, and profile picture URL.

Update the WhatsApp Business Profile fields.

Args:

• about (string, optional): About text (max 139 chars)

• address (string, optional): Business address

• description (string, optional): Description (max 512 chars)

• email (string, optional): Contact email

• websites (string, optional): JSON array of website URLs

• vertical (string, optional): Industry vertical

Returns: Confirmation of update.

List message templates for the WhatsApp Business Account. Requires WHATSAPP_BUSINESS_ACCOUNT_ID env var.

Args:

• limit (number): Max results (default: 20, max: 100)

• status (string, optional): Filter by APPROVED, PENDING, or REJECTED

Returns: List of templates with name, status, category, language, and components.