Skip to main content

WhatsApp Integration

The WhatsApp Integration enables you to communicate with customers through WhatsApp Business API, manage message templates, send automated messages, and track conversations within your CRM.

Overview

WhatsApp Integration provides:

  • Two-way messaging with customers
  • Pre-approved message templates
  • Automated messaging workflows
  • Media sharing capabilities
  • Conversation tracking and analytics
  • Compliance with WhatsApp Business policies

Getting Started

Prerequisites

  • WhatsApp Business Account
  • Facebook Business Manager access
  • Verified business phone number
  • Business verification completed
  • API access approved

Initial Setup

  1. Navigate to Settings > Integrations > WhatsApp
  2. Click Connect WhatsApp Business
  3. Follow the authorization flow:
    • Log in to Facebook Business Manager
    • Select your WhatsApp Business Account
    • Grant necessary permissions
    • Verify phone number
    • Complete configuration

Account Configuration

  • Display Name: Your business name on WhatsApp
  • Business Description: About your business
  • Industry: Select your category
  • Business Hours: Availability schedule
  • Away Message: Auto-reply when offline

WhatsApp Templates

Understanding Templates

WhatsApp requires pre-approved templates for business-initiated conversations:

  • Marketing messages
  • Transactional updates
  • Appointment reminders
  • Customer support follow-ups

Creating Templates

Accessing Template Manager

  1. Go to WhatsApp > Templates
  2. Click Create New Template
  3. Choose template category:
    • Marketing: Promotional content
    • Transactional: Order/appointment updates
    • OTP: One-time passwords

Template Components

Header (Optional):

  • Text: Up to 60 characters
  • Image: JPEG/PNG
  • Video: MP4
  • Document: PDF

Body (Required):

  • Main message content
  • Up to 1024 characters
  • Support for variables: {{1}}, {{2}}
  • Formatting: bold, italic

Footer (Optional):

  • Additional information
  • Up to 60 characters

Buttons (Optional):

  • Quick Reply: Pre-defined responses
  • Call to Action: URL or phone number
  • Up to 3 buttons per template

Template Best Practices

  • Clear, concise messaging
  • Proper variable placeholders
  • Compliance with policies
  • No promotional content in transactional templates
  • Test before submission

Template Approval Process

  1. Submit template for review
  2. Facebook reviews (24-48 hours)
  3. Status updates:
    • Pending: Under review
    • Approved: Ready to use
    • Rejected: Needs modification
  4. Edit and resubmit if rejected

Managing Templates

Template List View

  • Template name and category
  • Approval status
  • Language versions
  • Usage statistics
  • Last modified date

Template Actions

  • Edit: Modify draft templates
  • Clone: Create variations
  • Delete: Remove unused templates
  • Translate: Add language versions
  • Preview: See customer view

Sending WhatsApp Messages

Individual Messages

From Contact Profile

  1. Open contact record
  2. Click Send WhatsApp
  3. Choose:
    • Template message
    • Direct message (if 24-hour window open)
  4. Personalize variables
  5. Send or schedule

Message Composer

  • Template selection
  • Variable personalization
  • Media attachments
  • Preview before sending
  • Delivery scheduling

Bulk WhatsApp Campaigns

Creating Campaigns

  1. Go to Campaigns > Create New
  2. Select WhatsApp as channel
  3. Choose audience segment
  4. Select approved template
  5. Personalize variables
  6. Schedule delivery

Campaign Features

  • Audience segmentation
  • A/B testing templates
  • Scheduled delivery
  • Time zone optimization
  • Delivery reports

WhatsApp Automation

Trigger Types

  • Form Submission: Auto-response
  • Lead Status Change: Updates
  • Appointment Booking: Confirmations
  • Purchase Events: Order updates
  • Custom Triggers: Business-specific

Automation Builder

  1. Create new automation
  2. Set trigger conditions
  3. Add WhatsApp action
  4. Select template
  5. Map variables
  6. Test and activate

WhatsApp Conversations

24-Hour Messaging Window

  • Customer initiates: 24-hour window opens
  • Business can send any message type
  • Window extends with each customer response
  • After 24 hours: Only templates allowed

Conversation Management

Conversation View

  • Message thread display
  • Customer information sidebar
  • Quick actions toolbar
  • Template shortcuts
  • Media preview

Conversation Features

  • Rich Media: Images, videos, documents
  • Location Sharing: Maps integration
  • Contact Cards: Share contact info
  • Voice Messages: Audio recordings
  • Read Receipts: Delivery confirmation

Team Collaboration

  • Assign conversations to agents
  • Internal notes on threads
  • Conversation tags
  • Transfer between teams
  • Supervisor monitoring

WhatsApp Business Features

Business Profile

  • Company information display
  • Catalog integration
  • Business hours
  • Location details
  • Website links

Quick Replies

Set up instant responses for:

  • Greetings
  • Away messages
  • FAQs
  • Common inquiries
  • Business hours

Labels

Organize conversations with:

  • Custom label creation
  • Color coding
  • Filter by labels
  • Bulk labeling
  • Label analytics

Media Handling

Supported Media Types

  • Images: JPEG, PNG (5MB max)
  • Videos: MP4, 3GPP (16MB max)
  • Documents: PDF, DOC, XLS (100MB max)
  • Audio: MP3, OGG, AMR (16MB max)

Media Management

  • Automatic compression
  • CDN delivery
  • Preview generation
  • Virus scanning
  • Storage optimization

Compliance and Policies

WhatsApp Business Policy

  • No spam or bulk messaging
  • Respect opt-out requests
  • Accurate business information
  • Appropriate content only
  • Template compliance

Opt-in Requirements

  • Explicit consent needed
  • Clear opt-in process
  • Easy opt-out mechanism
  • Consent documentation
  • Regular list cleaning

Message Categories

  • Utility: Transaction updates
  • Authentication: Security codes
  • Marketing: Promotional (requires explicit opt-in)

Analytics and Reporting

Message Analytics

  • Sent, delivered, read rates
  • Template performance
  • Response rates
  • Media engagement
  • Click-through rates

Conversation Metrics

  • Active conversations
  • Response times
  • Resolution rates
  • Customer satisfaction
  • Agent performance

Campaign Performance

  • Reach and engagement
  • Conversion tracking
  • ROI analysis
  • A/B test results
  • Audience insights

Integration Features

CRM Integration

  • Automatic contact syncing
  • Conversation history in CRM
  • Activity timeline updates
  • Custom field mapping
  • Workflow triggers

Marketing Automation

  • Journey builder integration
  • Lead scoring updates
  • Behavior tracking
  • Campaign attribution
  • Cross-channel orchestration

Support System

  • Ticket creation from WhatsApp
  • Conversation context
  • Agent handoff
  • Knowledge base integration
  • SLA tracking

Troubleshooting

Common Issues

Message Delivery Failures

  • Check template approval
  • Verify phone number format
  • Confirm opt-in status
  • Review account status

Template Rejections

  • Review rejection reason
  • Check policy compliance
  • Remove promotional content
  • Verify variable usage

Connection Problems

  • Re-authenticate account
  • Check API limits
  • Verify webhook configuration
  • Review error logs

Best Practices

Message Timing

  • Respect time zones
  • Business hours delivery
  • Avoid late night messages
  • Consider cultural factors

Content Strategy

  • Value-driven messaging
  • Personalization
  • Clear call-to-action
  • Mobile-optimized content

List Management

  • Regular consent verification
  • Engagement monitoring
  • Inactive user cleaning
  • Preference management

Advanced Features

WhatsApp Flows

  • Interactive message flows
  • Form collection in chat
  • Appointment booking
  • Survey deployment
  • Lead qualification

Catalog Integration

  • Product showcase
  • In-chat shopping
  • Inventory sync
  • Order processing
  • Payment integration

Multi-agent Support

  • Team inbox
  • Skill-based routing
  • Workload distribution
  • Performance tracking
  • Quality monitoring

API and Webhooks

Webhook Events

  • Message received
  • Message delivered
  • Message read
  • Status updates
  • Error notifications

API Capabilities

  • Send messages
  • Manage templates
  • Upload media
  • Download messages
  • Update business profile

Rate Limits

  • Business-initiated: Based on tier
  • Customer-initiated: Unlimited
  • Media uploads: Per-file limits
  • API calls: Hourly limits