Set Up Webhooks

Learn how CubeConnect handles WhatsApp webhooks and how to track messages and events.

How CubeConnect Handles Webhooks

CubeConnect automatically manages webhook registration with Meta when you connect your WhatsApp Business account. You don't need to manually configure a webhook URL.

Customer Action → WhatsApp → Meta Webhook → CubeConnect → Your Dashboard/Flows

What Events Are Tracked

CubeConnect processes these webhook events automatically:

Incoming Messages

When a customer sends a message, CubeConnect:

1. Verifies the webhook signature
2. Stores the message in the database
3. Creates or updates the customer record
4. Triggers the active conversation flow (if any)
5. Makes the message available in the Inbox

Message Status Updates

Track your outbound messages through their lifecycle:

Status	Meaning
queued	Accepted by CubeConnect
sent	Delivered to WhatsApp servers
delivered	Reached the customer's phone
read	Customer opened and read the message
failed	Delivery failed (with error code)

Template Updates

When a template's status changes (approved, rejected, paused), CubeConnect updates it automatically in your dashboard.

Building Custom Integrations

If you want to react to events in your own application, you have several options:

Option 1: Use Conversation Flows

The easiest way to handle incoming messages is through Conversation Flows in the dashboard. Flows let you:

• Auto-reply to messages
• Collect customer data
• Route to different responses based on customer input
• Request admin approval
• Hand off to live chat

See Conversation Flows for details.

Option 2: Monitor via Inbox API

Use the polling endpoint to check for new messages:

curl "https://cubeconnect.io/api/inbox/{customer_id}/poll?since=2026-02-26T14:00:00Z" \
  -H "Cookie: your_session_cookie"

Option 3: Database Notifications

CubeConnect sends database notifications for key events:

• Admin Approval Requests - When a customer reaches an approval step
• Live Chat Requests - When a customer needs human support

These appear in the notification bell on your dashboard.

Webhook Signature Verification

CubeConnect verifies all incoming webhooks using HMAC-SHA256. If you need to implement your own verification (for custom forwarding), see Signature Verification.

Testing Webhooks

To test the full message flow:

1. Send a message to your WhatsApp Business number from a personal phone
2. Check the Inbox in your dashboard - the message should appear
3. If a conversation flow is active, verify the auto-reply was sent
4. Check the CRM > Customer Responses page for collected data

Troubleshooting

Messages not appearing in Inbox

• Verify your WhatsApp account is connected (Settings > WhatsApp)
• Check that the webhook URL is registered (this happens automatically)
• Verify the app secret is configured correctly

Status updates not coming through

• Status updates are sent by Meta and may have a slight delay
• Check the webhook events log in your Meta App Dashboard
• Ensure your WhatsApp Cloud API version is up to date

Conversation flow not triggering

• Verify a flow is assigned to the WhatsApp account
• Check that the flow is published (not draft)
• Look at the conversation session to see if it's stuck on a step