Meta WhatsApp Business API

​

Getting Started

​

Creating a Meta Business Account

1. Visit Meta Business Suite and click “Create Account”.
2. Enter your business information and complete the registration process.
3. Verify your business email address.
4. Once verification is complete, you’ll be directed to your Meta Business dashboard.

​

Setting Up WhatsApp Business API with Meta

1. In your Meta Business dashboard, navigate to “Business Settings” > “Accounts” > “WhatsApp Accounts”.
2. Click “Add” to create a new WhatsApp Business Account (WABA).
3. Follow the guided process to connect your business phone number with the WhatsApp Business API.
4. Complete the business verification process, which may include providing business documentation.
5. Set up your WhatsApp Business profile with your business information, logo, and description.

​

Business Requirements for WhatsApp Business API

1. Valid Business Identity: Your business must be officially registered and possess a clear identity that Meta can verify.
2. WhatsApp Business Policy Adherence: Ensure your business operations align with WhatsApp’s Business Policy.
3. Customer Consent: You must obtain explicit consent from customers before reaching out to them via WhatsApp.
4. Dedicated Phone Number: A dedicated phone number that will serve as your business’s WhatsApp identity.
5. Business Verification: Your business must complete Meta’s business verification process.
6. Payment Method: A valid payment method must be set up in your Business Manager account.

​

Creating API Access Tokens

1. Go to the Meta Developers Portal and create a business app if you don’t have one.
2. In your app’s dashboard, add the “WhatsApp Business API” product.
3. Navigate to “WhatsApp” > “API Setup” and follow the steps to configure your app.
4. You’ll need to generate a System User access token or a Business Integration System User access token:
   • System User Access Token: For developers accessing their own business data
   • Business Integration System User Access Token: For tech providers accessing customer data
5. Ensure your tokens have the following permissions:
   • whatsapp_business_management
   • whatsapp_business_messaging
   • business_management
6. Copy the generated token immediately and store it in a secure location.
7. Note: Access tokens are app and user-specific. Never share the token or post it publicly.

​

Creating a Comify API Key

1. Access your Comify account dashboard.
2. Navigate to the API Keys management section at https://cloud.comify.io/settings/api-keys.
3. Select “Generate API Key” if not already generated.
4. Provide a clear, descriptive name for your key (e.g., “Meta WhatsApp Integration”) to facilitate future management.
5. Copy and store this API key in a secure location. You’ll use this key in your application code to authenticate requests to the Comify platform.

​

Configuring Meta WhatsApp Integration in Comify

1. Sign in to your Comify platform dashboard.
2. Navigate to Integration Store > Add Integration > WhatsApp.
3. From the available WhatsApp service providers, select Meta.
4. Enter the WhatsApp API access token you generated earlier.
5. Provide your WhatsApp Business Account ID (found in your Meta Business Manager).
6. Configure any additional provider-specific settings according to your requirements.
7. Click Save to finalize the integration.

​

Creating WhatsApp Message Templates

1. Navigate to the Manage Templates section in your Comify dashboard.
2. Select the WhatsApp tab from the available channel options.
3. Click Create Template to begin the design process.
4. Choose from multiple template creation methods:
   • Pre-approved Templates: Select from WhatsApp’s pre-approved template categories.
   • Custom Templates: Create your own template following WhatsApp’s guidelines.
   • AI-Assisted Design: Utilize the AI Writer feature for automated content generation that follows WhatsApp’s guidelines.
5. Add variables to personalize your templates where needed (e.g., customer name, order number).
6. Submit your template for WhatsApp approval (this may take 24-48 hours).

​

Understanding WhatsApp Message Types

1. Session Messages: Responses to customer-initiated conversations (24-hour window).
2. Template Messages: Pre-approved message templates for business-initiated conversations.
3. Interactive Messages: Messages with buttons, list messages, or reply buttons.
4. Media Messages: Images, documents, videos, and other rich media content.
5. Authentication Templates: One-time passwords or verification codes.

​

Sending WhatsApp Templates

const { Comify } = require('comify-node')

const comm = new Comify('COMIFY_API_KEY')

comm.triggerComm('whatsapp_template_name',{ 
  "order_id" : "123455",
  "customer" : {
    "phoneNumber" : "919876543210",  // with country code
    "customerName" : "Comify"
  }
}, 'whatsappTemplate')

{
  "requestId": "016e9d9c-ea29-455c-bf2e-a703e96482fb",
  "message": "your request has been submitted"
}