Twilio WhatsApp Message Sender

Send WhatsApp messages programmatically using Twilio's official WhatsApp Business API.

Overview

This Apify actor provides a reliable, legitimate method for sending WhatsApp messages. It uses Twilio's API, which is WhatsApp's approved business solution, eliminating the risks of IP blocking or account bans associated with unofficial methods.

Key Features

• Official API: Uses the sanctioned WhatsApp Business API.
• Reliable Delivery: Enterprise-grade infrastructure ensures messages are sent.
• No Authentication Hassles: No QR codes or session management required after initial setup.
• Safe from Blocks: Works from any server, including Apify's cloud.
• Media Support: Send text, images, videos, and documents.
• Status Tracking: Receive delivery and read receipts.
• Compliant: Fully adheres to WhatsApp's Terms of Service.

How to Use

1. Set Up Twilio

1. Create a free account at twilio.com/try-twilio.
2. Set up the WhatsApp Sandbox for free testing by following the guide at console.twilio.com/us1/develop/sms/try-it-out/whatsapp-learn. You'll need to send a join <code> message to the provided number.
3. From your Twilio Console dashboard, note your Account SID, Auth Token, and WhatsApp sandbox number (format: whatsapp:+14155238886).

2. Configure the Actor

Provide the following required input to the actor:

{
  "twilioAccountSid": "ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "twilioAuthToken": "your_auth_token_here",
  "twilioWhatsAppNumber": "whatsapp:+14155238886",
  "toPhoneNumber": "whatsapp:+15551234567",
  "message": "Your message here"
}

Note for Sandbox: The recipient (toPhoneNumber) must have already joined your sandbox.

3. Production Use

For sending to any number without sandbox restrictions:
1. Apply for WhatsApp Business API access via your Twilio Console.
2. Submit your business details for approval.
3. Once approved, replace the sandbox number with your dedicated WhatsApp Business number.
4. Standard pay-as-you-go messaging rates apply. See twilio.com/whatsapp/pricing.

Input Parameters

Example with Media:

{
  "twilioAccountSid": "ACxxxxxxxx",
  "twilioAuthToken": "your_token",
  "twilioWhatsAppNumber": "whatsapp:+14155238886",
  "toPhoneNumber": "whatsapp:+15551234567",
  "message": "Check this out!",
  "mediaUrl": "https://example.com/image.jpg"
}

Output

The actor saves each message result to the dataset with the following structure:

{
  "phoneNumber": "whatsapp:+15551234567",
  "message": "Your message here",
  "status": "sent",
  "timestamp": "2025-01-05T10:30:00.000Z",
  "messageSid": "SMxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "twilioStatus": "queued"
}

Twilio vs. Unofficial Methods