Skip to main content
Deploy your agent to WhatsApp via the WhatsApp Business Cloud API (Meta). Once connected, users can text the business phone number and the agent will reply — with text, media attachments, and typing indicators.

​
Setting Up the WhatsApp Deployment

WhatsApp deployments use Meta’s Cloud API. You need a WhatsApp Business Account (WABA), a verified phone number, and a system-user access token with WhatsApp permissions.
1

Create a WhatsApp Business Account

In Meta Business Suite, create or select a Business Account and add WhatsApp to it. Register and verify a phone number — Noxus will send messages from this number.
2

Collect your IDs

In your Meta Business account, open the WhatsApp configuration for your app and copy:
  • Phone Number ID — unique identifier for the registered business phone number.
  • Business Account ID — the WABA ID.
3

Generate an access token

Create a system user on Meta Business and generate a permanent access token with the whatsapp_business_messaging and whatsapp_business_management scopes. Copy the token.
4

Pick a webhook verify token

Choose any long random string — this is the Webhook Verify Token. You will give it to both Noxus and Meta so they can authenticate each other on incoming webhook requests.
5

Enter credentials in Noxus

Back in Noxus, create a new WhatsApp connection and fill in the four fields:
  • Phone Number ID
  • Business Account ID
  • Access Token
  • Webhook Verify Token
Click Connect — Noxus will call the Facebook Graph API (v22.0) to verify the phone number and the access token.
6

Configure the webhook in Meta

On your WhatsApp configuration page in Meta, set the Callback URL to the webhook URL shown in Noxus and paste the same Webhook Verify Token you used above. Subscribe to the messages webhook field so the agent receives incoming messages.
Your WhatsApp Business Account must be approved by Meta for production messaging. Until it is, WhatsApp caps you at a limited number of test recipients and test conversations.

​
Deployment Settings

Once your WhatsApp connection is established, configure how the agent behaves. Settings are organized into the sections below.

​
Deployment

A published version is required before you can set a deployment to Online. Switch to Offline to edit configuration.

​
Configuration

​
Conversation Triggers

A new conversation starts when all specified fields match an incoming message. Leave a field empty to match any value.

​
Reply Behavior

WhatsApp does not support threads or reactions, so the Thread reply mode and the Batch messages / Quiet period settings are not available on this channel.

​
Rate Limits

​
Display