Validate a WhatsApp template against Meta's rules before submitting.

Use this to check for errors before creating a template.

Args: name: Template name (lowercase, underscores, starts with letter) category: MARKETING or UTILITY language: Language code (e.g. "en", "en_US", "hi") components: List of component dicts (HEADER, BODY, FOOTER, BUTTONS) template_type: TEXT, IMAGE, VIDEO, DOCUMENT, CAROUSEL, CATALOG, etc. is_lto: True if this is a Limited Time Offer template

Returns: Validation result with any errors found.

Create and submit a WhatsApp template to Meta for approval.

The template will go through Meta's review process. Check status with check_template_status after submission.

Args: name: Template name (lowercase, underscores, starts with letter, max 512) category: MARKETING or UTILITY language: Language code (e.g. "en", "en_US", "hi") components: List of component dicts. Each has a "type" (HEADER, BODY, FOOTER, BUTTONS) and type-specific fields. Example: [ {"type": "HEADER", "format": "TEXT", "text": "Hello {{1}}", "example": {"header_text": ["John"]}}, {"type": "BODY", "text": "Your order {{1}} is {{2}}.", "example": {"body_text": [["ORD-123", "confirmed"]]}}, {"type": "FOOTER", "text": "Reply STOP to opt out"}, {"type": "BUTTONS", "buttons": [ {"type": "QUICK_REPLY", "text": "Track Order"}, {"type": "URL", "text": "View Details", "url": "https://example.com/order/{{1}}", "example": ["https://example.com/order/123"]} ]} ]

Returns: JSON with template ID and status on success, or error details.

List WhatsApp message templates.

Args: limit: Max templates to return (1-100, default 20) after: Pagination cursor for next page name: Filter by template name (exact match) status: Filter by status: APPROVED, PENDING, REJECTED, PAUSED, DISABLED category: Filter by category: MARKETING, UTILITY

Returns: JSON with list of templates and pagination info.

Get full details of a WhatsApp template by name or ID.

Provide either template_name or template_id (not both).

Args: template_name: Template name to look up template_id: Meta template ID to look up directly

Returns: JSON with full template details including components.

Check the approval status of a WhatsApp template.

Use this after creating a template to see if Meta approved or rejected it.

Args: template_name: Template name to check template_id: Meta template ID to check directly

Returns: JSON with current status (APPROVED, PENDING, REJECTED, etc.)

Delete a WhatsApp template by name.

WARNING: This permanently deletes ALL language variants of the template.

Args: template_name: Name of the template to delete

Returns: JSON confirming deletion.

Send an approved template message to a phone number.

Args: to: Recipient phone number with country code (e.g. "+919876543210") template_name: Name of the approved template to send language: Language code matching the template (default "en") components: Optional list of component parameter dicts for dynamic values. Example for a template with header image and body params: [ {"type": "header", "parameters": [ {"type": "image", "image": {"link": "https://example.com/img.jpg"}} ]}, {"type": "body", "parameters": [ {"type": "text", "text": "John"}, {"type": "text", "text": "ORD-123"} ]} ]

Returns: JSON with message ID on success.

Send an approved template message to multiple phone numbers.

Messages are sent sequentially (one API call per recipient). Each result is tracked individually.

Args: to_list: List of phone numbers with country code template_name: Name of the approved template language: Language code (default "en") components: Optional parameter components (same for all recipients)

Returns: JSON with per-recipient results (successes and failures).