TriSender WhatsApp¶
What It Does¶
Automatically send WhatsApp notifications to customers and admins when orders are placed. Uses the TriSender API service to deliver professional order confirmations and alerts via WhatsApp.
When to Use It¶
Enable this plugin if you want to:
- Send automatic order confirmations to customers
- Get instant WhatsApp alerts when new orders arrive
- Keep customers updated about their orders
- Reduce "where is my order?" support requests
- Improve customer experience with instant notifications
How It Works¶
When a customer places an order, the plugin automatically sends WhatsApp messages through the TriSender service. You can customize the message templates and choose who receives notifications.
Setup Instructions¶
Step 1: Get Your TriSender API Credentials¶
- Create an account at tri-sender.com
- Log in to your TriSender dashboard
- Navigate to API Settings or Integration
- Copy your:
- API Token
- WhatsApp Channel ID
Step 2: Enable the Plugin¶
- In your store admin, go to System Settings > Plugins
- Find the TriSender WhatsApp card
- Click Configure
- Enable the plugin using the toggle switch
- Fill in all required fields (see below)
- Click Save
Step 3: Test the Plugin¶
- Click the Test button on the plugin card
- Enter a test phone number
- Send a test message
- Check if the WhatsApp message is received
If the test works, you're all set!
Configuration Fields¶
Basic Settings¶
Enabled¶
Type: Toggle Description: Turn the plugin on or off
API Token¶
Type: Text Required: Yes Description: Your TriSender API authentication token from the TriSender dashboard
Where to find it: TriSender Dashboard > API Settings
WhatsApp Channel¶
Type: Text Required: Yes Description: Your WhatsApp channel identifier from TriSender
Where to find it: TriSender Dashboard > Channels
Notification Settings¶
Notify Customers¶
Type: Checkbox Default: Enabled (checked) Description: Send WhatsApp confirmation to customers when they place an order
When to disable: If you only want admin notifications, not customer notifications
Notify Admin¶
Type: Checkbox Default: Enabled (checked) Description: Send WhatsApp alert to admin when new orders arrive
When to disable: If you don't want to receive order notifications
Admin Phone Number¶
Type: Text
Required: Yes (if admin notifications enabled)
Format: +[country code][number]
Description: The phone number that receives admin notifications
Example: +966501234567
Message Templates¶
Customer Message Template¶
Type: Text Area Description: The message sent to customers when they place an order
Available placeholders:
- {customer_name} - Customer's name
- {order_id} - Order number
- {order_total} - Total amount with currency
- {order_url} - Link to view order details
Default template:
Hello {customer_name}!
Your order #{order_id} has been received successfully.
Order Total: {order_total}
Track your order: {order_url}
Thank you for shopping with us!
Tips: - Keep it friendly and professional - Include order tracking link - Mention next steps (e.g., "We'll notify you when it ships") - Use the customer's language
Admin Message Template¶
Type: Text Area Description: The message sent to admin when new orders arrive
Available placeholders:
- {customer_name} - Customer's name
- {customer_phone} - Customer's phone number
- {order_id} - Order number
- {order_total} - Total amount with currency
- {admin_order_url} - Link to admin order details
Default template:
🔔 New Order Alert!
Order: #{order_id}
Customer: {customer_name}
Phone: {customer_phone}
Total: {order_total}
View order: {admin_order_url}
Tips: - Use emojis for quick visual scanning - Include customer contact info - Add direct link to admin panel - Keep it concise
Best Practices¶
Message Templates¶
Do: - Personalize with customer name - Include order number for reference - Provide tracking links - Keep messages under 300 characters - Use proper formatting (line breaks) - Match your brand voice
Don't: - Send generic, robotic messages - Forget to include essential info - Make messages too long - Use ALL CAPS (looks aggressive) - Include broken or invalid links
Phone Numbers¶
- Always include country code
- Remove spaces, dashes, and parentheses
- Format:
+966501234567✅ - Not:
0501234567❌ - Not:
+966 50 123 4567❌
Testing¶
- Test before going live
- Try with different phone numbers
- Verify all placeholders work
- Check message formatting
- Ensure links are clickable
Troubleshooting¶
Messages not sending?
- Verify your API token is correct
- Check your TriSender account is active
- Ensure you have sufficient TriSender credits
- Verify the WhatsApp channel is connected
- Check phone numbers include country codes
Customer not receiving messages?
- Verify the customer's phone number is correct
- Check if "Notify Customers" is enabled
- Ensure customer has WhatsApp installed
- Check TriSender delivery logs
Admin not receiving messages?
- Verify "Notify Admin" is enabled
- Check admin phone number is correct
- Ensure admin phone has WhatsApp
- Test using the test button
Placeholders not working?
- Make sure you typed them exactly:
{customer_name}not{customername} - Check for typos in placeholder names
- Use only the placeholders listed above
How Messages Are Sent¶
Messages are sent asynchronously using background jobs:
- Orders are created immediately
- WhatsApp messages are queued and sent within seconds
- If TriSender is temporarily unavailable, messages are retried automatically
- Failed messages are logged for troubleshooting
This ensures fast checkout even if WhatsApp delivery is delayed.