WhatsApp Integration

Communicate with your customers via WhatsApp using the WhatsApp Business API.

Requirements

For WhatsApp integration:

• A verified phone number
• WhatsApp Business account
• Meta Business account (optional)

Setup Steps

1. Connecting WhatsApp

1. Go to Settings > Channels > WhatsApp
2. Click the Connect WhatsApp button
3. Scan the QR code with your phone
4. Wait for the connection confirmation

2. Profile Settings

Configure your WhatsApp Business profile:

• Business name
• Category
• Description
• Address
• Email
• Website

3. Welcome Message

Automatic welcome message for first-time contacts:

Hello! Welcome to DOLU.ai.
How can I help you?

4. Away Message

Automatic reply outside business hours:

We are currently outside business hours.
We will get back to you as soon as possible.
Business hours: Weekdays 09:00 - 18:00

Message Types

Text Messages

You can send and receive regular text messages.

Media Messages

Supported formats:

Type	Formats	Max Size
Image	JPG, PNG	5 MB
Video	MP4	16 MB
Audio	MP3, OGG	16 MB
Document	PDF, DOC	100 MB

Location

You can send and receive location information.

Contacts

Contact cards can be shared.

Message Templates

Use approved templates for WhatsApp Business API:

Template Types

1. Informational: Order updates, appointment reminders
2. Marketing: Campaigns and promotions (approval required)
3. Authentication: OTP and verification codes

Creating a Template

1. Go to Settings > Message Templates
2. Create a New Template
3. Select the category
4. Write the content

5. Add variables: {{1}}, {{2}}

6. Submit for approval

Example Template:

Hello `{{1}}`,

Your order `{{2}}` has been shipped.

Tracking number: `{{3}}`

DOLU.ai

24-Hour Rule

An important rule in WhatsApp Business API:

• You can send free replies within 24 hours after the customer sends a message
• After 24 hours, you can only send approved templates

Labels

Label conversations in WhatsApp:

• New customer
• Preparing for shipment
• Awaiting payment
• Completed

Bulk Messaging

Send bulk messages with approved templates:

1. Go to Marketing > Campaigns
2. Create a New Campaign
3. Select the target audience
4. Select the template
5. Set the schedule
6. Send

Prohibited Content

Content that should not be sent on WhatsApp:

• Spam and unsolicited messages
• Misleading content
• Illegal products
• Hate speech
• Adult content

Troubleshooting

QR Code Not Scanning

• Check your phone camera
• Increase screen brightness
• Refresh the page

Connection Lost

• Make sure your phone is connected to the internet
• Reconnect WhatsApp
• Re-open the session

Message Not Sending

• Check the number format (+90XXXXXXXXXX)
• Check internet connection
• Make sure the WhatsApp account is active

API Usage

# Send message
POST /api/v1/messages/whatsapp
{
  "to": "+905551234567",
  "message": "Hello!"
}

# Template message
POST /api/v1/messages/whatsapp/template
{
  "to": "+905551234567",
  "template": "order_update",
  "parameters": ["John", "12345", "ABC123"]
}

Best Practices

1. Respond quickly: Pay attention to the 24-hour rule
2. Be personal: Use the customer's name
3. Keep it short: Avoid long messages
4. Use media: Visuals are effective
5. Timing: Send messages at appropriate hours