Whatsapp Business Poster

Send automated WhatsApp messages via the official Cloud API. Perfect for customer notifications, appointment reminders, order updates, and marketing campaigns.

Features

• Text Messages: Send plain text with optional link previews
• Template Messages: Use pre-approved WhatsApp templates with variables
• Media Messages: Send images, documents, and videos
• Interactive Messages: Create button-based replies and list menus
• Multi-Recipient: Send to multiple phone numbers in one run
• Demo Mode: Test the actor without sending real messages

Setup

1. Create a Meta Business Account

1. Go to Meta Business Suite
2. Create or select your business
3. Navigate to WhatsApp > Getting Started

2. Set Up WhatsApp Business API

1. In Meta Business Suite, go to WhatsApp > API Setup
2. Create a System User with WhatsApp permissions
3. Generate a permanent access token
4. Note your Phone Number ID from the API settings

3. Verify Recipients

WhatsApp Business API requires recipients to:

• Have WhatsApp installed
• Have opted in to receive messages from your business (for marketing)
• Be in your customer database for transactional messages

Usage Examples

Simple Text Message

{
  "accessToken": "EAA...",
  "phoneNumberId": "123456789",
  "recipientPhone": "+1234567890",
  "messageType": "text",
  "textMessage": "Hello! Your order has been shipped."
}

Template Message

{
  "accessToken": "EAA...",
  "phoneNumberId": "123456789",
  "recipientPhone": "+1234567890",
  "messageType": "template",
  "templateName": "appointment_reminder",
  "templateLanguage": "en_US",
  "templateComponents": "[{\"type\":\"body\",\"parameters\":[{\"type\":\"text\",\"text\":\"John\"},{\"type\":\"text\",\"text\":\"Tomorrow at 3 PM\"}]}]"
}

Image with Caption

{
  "accessToken": "EAA...",
  "phoneNumberId": "123456789",
  "recipientPhone": "+1234567890",
  "messageType": "image",
  "mediaUrl": "https://example.com/promo.jpg",
  "mediaCaption": "Check out our latest offers!"
}

Interactive Buttons

{
  "accessToken": "EAA...",
  "phoneNumberId": "123456789",
  "recipientPhone": "+1234567890",
  "messageType": "interactive",
  "interactiveType": "button",
  "interactiveBody": "Would you like to confirm your appointment?",
  "interactiveButtons": "[{\"type\":\"reply\",\"reply\":{\"id\":\"confirm\",\"title\":\"Yes, Confirm\"}},{\"type\":\"reply\",\"reply\":{\"id\":\"cancel\",\"title\":\"Cancel\"}}]"
}

Multi-Recipient Broadcast

{
  "accessToken": "EAA...",
  "phoneNumberId": "123456789",
  "recipientPhones": ["+1234567890", "+0987654321", "+1122334455"],
  "messageType": "template",
  "templateName": "weekly_newsletter"
}

Output

Each message result includes:

{
  "recipientPhone": "+1234567890",
  "messageId": "wamid.HBgLMTIz...",
  "status": "sent",
  "messageType": "text",
  "content": "Hello! Your order has been shipped.",
  "sentAt": "2024-01-15T10:30:00.000Z"
}

Pricing

• Message Sent: $0.01 per message (plus WhatsApp conversation fees)

Message Templates

WhatsApp requires pre-approved templates for:

• Marketing messages
• Messages outside the 24-hour conversation window
• Business-initiated conversations

Create templates in Meta Business Suite > WhatsApp > Message Templates.

Rate Limits

WhatsApp Business API has rate limits based on your tier:

• Tier 1: 1,000 business-initiated conversations/day
• Tier 2: 10,000 business-initiated conversations/day
• Tier 3: 100,000 business-initiated conversations/day
• Tier 4: Unlimited

Error Handling

Common errors:

• Invalid phone number: Ensure international format (+country code)
• Template not found: Verify template name and language code
• Rate limit exceeded: Wait or request tier upgrade
• Media URL inaccessible: Use public, HTTPS URLs

Support

For issues or feature requests, visit johnrippy.link

---

Built by John Rippy | johnrippy.link