Configuring webhooks for incoming messages

Webhooks are how Meta delivers incoming messages to AIsoule. Without this, you won't receive customer messages.

If you used Embedded Signup

Good news — webhooks are configured automatically! You don't need to do anything manually. Skip this article.

Manual webhook setup

If you connected your account manually:

Step 1: Get your webhook details from AIsoule

1. Go to Settings → WhatsApp Accounts
2. Click on your account
3. Find the Webhook Configuration section
4. Copy:
   • Webhook URL: https://app.aisoule.com/api/webhook
   • Verify Token: (unique per account)

Step 2: Configure in Meta

1. Go to Meta App Dashboard
2. Select your app → WhatsApp → Configuration
3. Under "Webhook":
   • Callback URL: Paste the webhook URL from AIsoule
   • Verify Token: Paste the verify token from AIsoule
4. Click "Verify and Save"
5. Subscribe to webhook fields:
   • ✅ messages
   • ✅ message_deliveries (for delivery receipts)
   • ✅ message_reads (for read receipts)

Step 3: Subscribe in AIsoule

1. Go back to your account in AIsoule
2. Click "Subscribe"
3. This registers your app to receive events

Verifying it works

1. Send a message from any WhatsApp number to your business number
2. The message should appear in AIsoule's inbox within seconds
3. If not, check the webhook configuration and try again

Troubleshooting

"Verification failed" — Make sure the Verify Token matches exactly (no extra spaces).

"Messages not arriving" — Check that you subscribed to the messages field in Meta's dashboard AND clicked "Subscribe" in AIsoule.