Meta Cloud API v21.0 Integration with Grounded RAG AI Agents is live!Explore Agents →
Comprehensive Quickstart & Integration Manual

WhatsApp Cloud API Setup & Tutorial

From Meta Developer setup to your first automated broadcast and RAG AI knowledge base, follow this guide to go live in under 15 minutes.

6 Step Checklist Meta API v20.0 Ready No Coding Required
Jump to step:
1
Step 1: Account Creation

Register & Activate Instant 7-Day Trial

Est. 2 mins

Create your workspace on Avyann ChatFlow. We verify your business email and WhatsApp phone number with dual OTP security so your instance is ready immediately.

✓
Visit the Register page and input your corporate email, business name, and active WhatsApp number.
✓
Enter the 6-digit email OTP and WhatsApp OTP sent to your device.
✓
Your 7-day full feature trial activates instantly with 1,000 complimentary test message credits.
Pro Tip: Ensure your WhatsApp phone number includes the international country code without + or leading zeros (e.g. 15550192834 or 919876543210).
2
Step 2: Meta Cloud API Setup

Connect Meta Developer App & WABA (Phase 1 BYO)

Est. 4 mins

Avyann ChatFlow utilizes Meta’s direct official WhatsApp Cloud API. You only need to copy your credentials from the Meta Developers Portal into Avyann ChatFlow Settings.

✓
Navigate to developers.facebook.com and select your WhatsApp Business App.
✓
Under WhatsApp → API Setup, obtain your Phone Number ID and WhatsApp Business Account (WABA) ID.
✓
Under Business Manager → System Users, create a permanent access token with whatsapp_business_messaging and whatsapp_business_management scopes.
✓
In Avyann ChatFlow, go to Settings → WhatsApp Integration and paste these credentials to test live handshake.
Pro Tip: Do not use the temporary 24-hour token shown on the Meta API Setup page in production. Generate a permanent System User Token.
3
Step 3: Realtime Webhooks

Configure Webhook Endpoint & Event Subscriptions

Est. 2 mins

Configure Meta to stream inbound customer messages, read receipts, and delivery callbacks straight to your Avyann ChatFlow workspace in real time.

✓
In Meta App Dashboard, navigate to WhatsApp → Configuration → Webhook.
✓
Set Callback URL to: https://api.avyannchatflow.com/api/webhook/whatsapp (or your dedicated tenant URL).
✓
Set the Verify Token matching your workspace secret configured in Settings.
✓
Subscribe to field events: messages and message_deliveries.
Meta Webhook Configuration
Callback URL: https://api.avyannchatflow.com/api/webhook/whatsapp
Verify Token: [Your workspace secret from Settings]
Pro Tip: Avyann ChatFlow verifies incoming webhook signatures using SHA256 HMAC for maximum security.
4
Step 4: Template Approval

Create & Sync Meta Message Templates

Est. 3 mins

To initiate conversations outside the 24-hour service window, Meta requires pre-approved templates with designated categories (Utility, Marketing, or Authentication).

✓
In Avyann ChatFlow, navigate to Message Templates → New Template.
✓
Select your Category: Utility (order notifications, receipts) or Marketing (promotions, product announcements).
✓
Type your body text using double curly brackets for dynamic placeholders like Hi {{1}}, your order #{{2}} is shipped.
✓
Add optional header media (image, video, PDF) and Quick Reply / Call-to-Action buttons.
✓
Click Submit to Meta. Status switches to APPROVED usually within 1–10 minutes.
Pro Tip: Utility templates enjoy higher Meta approval speeds and lower conversation fees compared to promotional marketing templates.
5
Step 5: Campaign Execution

Import Contacts & Broadcast Campaign with Smart Throttle

Est. 3 mins

Launch high-volume broadcast campaigns safely. Avyann ChatFlow paces outgoing traffic to comply strictly with your Meta phone number tier limits.

✓
Navigate to Contacts → Import CSV. Format columns as phone, name, and optional tags (e.g. vip, churn_risk).
✓
Navigate to Campaigns → Create Campaign and choose your target segment tag.
✓
Select an APPROVED template and map placeholders to contact columns (e.g. {{1}} = name).
✓
Set your dispatch rate throttle (recommended: 30–50 msgs/sec for Tier 1 numbers).
✓
Click Launch and watch the live analytics counter tick Sent → Delivered → Read.
Pro Tip: Failed messages due to invalid numbers or unreachable devices can be retried with one click from the campaign results tab.
6
Step 6: AI Knowledge Base

Ground RAG AI Agents on Custom Documents

Est. 2 mins

Let AI automatically answer inquiries, provide product specifications, and troubleshoot customer questions without hallucinations.

✓
Navigate to AI Assistant → Knowledge Base.
✓
Upload your company PDF documents, product manuals, or frequently asked questions in markdown/text.
✓
The vectorization pipeline indexes text chunks into high-dimensional semantic embeddings.
✓
Set your Human Escalation Threshold (default: 75% similarity). If customer questions fall below threshold, chat automatically transfers to human agent inbox.
✓
Toggle AI Agent to Active state. The agent responds only during customer-initiated active 24-hour windows.
Pro Tip: You can define custom persona instructions (e.g. "Speak warmly and politely, never quote unverified competitor discounts").

Frequently Asked Integration Questions

Common questions regarding Meta WhatsApp Business verification, webhooks, and billing.

Need assistance setting up Meta API?

Our technical onboarding engineers can walk your team through live credential verification.

WhatsApp SupportStart Free Trial