X-Asena

WhatsApp Business API Platform

Build messaging workflows with the official WhatsApp API

X-Asena is an open-source Node.js server that connects your application to WhatsApp Business Cloud API. Handle messages, automate responses, and share media — all through a clean webhook interface.

Get StartedView Source
Terminal
$ git clone https://github.com/Neeraj-x0/X-Asena-CloudConnect.git
$ cd X-Asena-CloudConnect && npm install
$ npm start
✓ Server running on port 3001

Features

Everything you need to integrate WhatsApp messaging into your applications.

Real-time Messaging

Send and receive messages instantly with read receipts and delivery status.

Automated Responses

Configure auto-replies for common queries to reduce response times.

Media Support

Share images, documents, audio, and video files with customers.

Secure by Default

Built on official WhatsApp Business API with end-to-end encryption.

Webhook Integration

Receive real-time notifications for incoming messages and status updates.

Simple API

Clean REST endpoints make it easy to integrate with any system.

Requirements

Before getting started, ensure you have the following:

Node.js v14 or higher
WhatsApp Business API access (via Meta Business Suite)
Facebook Developer account
A verified business and phone number

Note: WhatsApp Business API access requires Meta approval. See the official documentation to get started.

Installation

Get the server running in under a minute.

1

Clone the repository

git clone https://github.com/Neeraj-x0/X-Asena-CloudConnect.git
2

Navigate to directory

cd X-Asena-CloudConnect
3

Install dependencies

npm install
4

Start the server

npm start

Environment Configuration

Create a .env file in your project root with these variables:

.env
# Server
PORT=3001
# Webhook verification
WEBHOOK_VERIFY_TOKEN=your_custom_token
# WhatsApp Cloud API
API_URL=https://graph.facebook.com/v21.0/YOUR_PHONE_NUMBER_ID
GRAPH_API_TOKEN=your_api_token

Configuration Details

WEBHOOK_VERIFY_TOKEN
A secret string you create. Meta will use this to verify webhook requests are legitimate.
API_URL
Your WhatsApp phone number ID from the Meta Developer Dashboard. Format: https://graph.facebook.com/v21.0/PHONE_ID
GRAPH_API_TOKEN
Your permanent access token from the Meta Developer Portal. Found under WhatsApp → Configuration.

Start Building

X-Asena is open source and free to use. Contributions are welcome.

View on GitHubReport an Issue