System Configurations

Scope
This section describes how to configure third-party integrations required for authentication and messaging services — including WhatsApp OTP via Meta and Google reCAPTCHA API keys.

---

​

⚙️ System Config Overview

Before deploying your production environment, ensure that all third-party configurations are properly set up.
Each integration below has a specific purpose:

---

​

💬 WhatsApp Configurations

​

🧩 Step 1. Create a Meta (Facebook) Developer App

Go to Meta for Developers
Click Create App → on the “Add Use Cases” screen scroll down and select Other → choose Business as the app type → Next.
Fill in the following:

• App Name: e.g. Your Project Name WhatsApp
• Contact Email: your business email
• Business Account: select your company (or create one)
  Then click Create App

✅ You’ll now see your App Dashboard.

---

​

💬 Step 2. Add the WhatsApp Product

In the left menu, scroll to Add Product → find WhatsApp → click Set Up.
✅ The WhatsApp Business Platform is now linked to your app.

---

​

☎️ Step 3. Connect Your Business Phone Number

Open App Dashboard → Products → WhatsApp → Getting Started.
Click Add phone number and fill in:

• Display Name: the name users will see (e.g. Your Project Name)
• Business Name, Website, and Email
• Enter your Phone Number (must not already be linked to any WhatsApp account)
• Verify with the 6-digit code sent to your phone

✅ Once verified, your number appears under your WhatsApp Business Account.

---

​

🏢 Step 4. Confirm Your Business Information

Visit Business Settings
→ Business Info
Ensure the following are filled correctly:

• Legal Name
• Business Address
• Business Email
• Website URL

(Verification documents are not required yet, but must match your business details.)

---

​

🔑 Step 5. Create a Permanent Access Token

This token allows your backend to send WhatsApp messages through API. A. Create a System User Go to Business Settings → System Users
Click Add → Add System User

• Name: yourproject_api_user
• Role: Admin

B. Assign Permissions and Link App

• Click your new System User
• Add Assets → Apps → your app → grant Full Control
• Add Assets → WhatsApp Accounts → your WhatsApp Account → grant Full Access
• Refresh the browser page

C. Generate Token

• Click Generate New Token
• Choose your App
• Enable:
  • whatsapp_business_management
  • whatsapp_business_messaging
• Enable Never Expires
• Copy the generated token and store it securely.

✅ This is your Permanent Access Token.

---

​

🧾 Step 6. Find Your Account Identifiers

Return to your app: Developers → Your App → WhatsApp → Getting Started
Copy:

• WhatsApp Business Account ID
• Phone Number ID

✅ Both are required for integration.

---

​

💡 Step 7. Create an OTP Template

Go to Message Templates
Click Create Template and choose:

• Category: Authentication
• Type: Copy Code
• Name: otp_login
• Language: English (US)

Body Example: {{1}} is your verification code. Do not share this code. It expires in 10 minutes. Click Submit → wait for Approved status.
✅ Copy the Template Name and Language Code.

---

​

🧰 Step 8. Share These Details with Developers

Share securely: Use encrypted email or password manager.