Common issues

Quick solutions for the most frequently encountered problems.

Onboarding

Embedded Signup popup does not appear

• Allow pop-ups for this site in your browser settings
• Disable ad blockers, since they sometimes block the Meta SDK
• Try a different browser (Chrome recommended)
• Check that your Meta Business Manager account is not restricted

Cannot see my WhatsApp number during signup

• Make sure you are logging in with the Facebook account that owns the Business Manager where the WABA exists
• If the number is on another provider (Interakt, Gupshup, etc.), it must be released first
• Verify you have Admin access (not just Employee) on the Business Manager

Onboarding stuck on “Connecting”

• Look for an incomplete Meta pop-up and finish it
• Refresh the page and try again. The flow is idempotent
• If the phone number requires OTP verification, check your phone for the code

Messaging

Messages not being received

1. Go to Settings → Numbers and verify the webhook shows “Subscribed”
2. Check the number's registration status, which should be “registered”
3. Verify the webhook URL in Meta App Dashboard matches your API URL
4. Try the Repair button on the onboarding page to re-register

Messages failing to send (delivery errors)

• Error 131047: Recipient has not messaged you in the last 24 hours. Use a message template instead.
• Error 131026: Message template does not exist or is not approved. Check the Templates page.
• Error 133005: Phone number already registered with a different PIN. Clear two-step verification in WhatsApp Manager → Phone numbers.
• Error 80007: Rate limit exceeded. Wait a few minutes and retry.

AI agent not replying

1. Check that AI is enabled on the channel (Settings → Numbers → AI toggle)
2. Check that the conversation ownership is “AI” (not paused or human)
3. Verify an AI agent exists and is enabled (Agents page)
4. Check that the AI provider API key is configured (OpenAI or Anthropic)
5. Check your plan limits: the Free plan has 100 messages/month

Billing

Payment completed but plan not upgraded

1. Go to Billing and click the refresh icon, which syncs with Razorpay
2. Wait up to 30 seconds for the webhook to process
3. If still stuck, the Razorpay webhook may not be configured correctly. Check that the webhook URL in Razorpay Dashboard points to https://your-api-domain/api/v1/billing/webhook/razorpay

402 Payment Required when creating agents/campaigns

• Your plan limits have been reached. Check your current plan on the Billing page.
• Free plan: 1 agent, 100 messages, no KB. Starter: 3 agents, 5K messages.
• If you just upgraded, wait 10-15 seconds for the subscription to activate.

Templates

Template rejected by Meta

• Avoid promotional language in Utility templates
• Do not include URLs in the body unless they are example URLs in the header
• Use proper placeholder format: {{1}}, {{2}}
• Ensure sample values are provided for all variables
• Check Meta's template guidelines

Account

Cannot log in

• Use the Forgot password link on the login page
• If you signed up with Google, use the Continue with Google button
• Clear browser cache and cookies, then try again

Session expired frequently

• Access tokens expire after 30 minutes. The app auto-refreshes them.
• If you are logged out frequently, check that your browser allows cookies and localStorage.