Skip to main content

Webhooks

ClawCentral automatically handles inbound webhooks for all supported messaging channels. No local server, port binding, or webhook configuration is required — everything is managed in the cloud.

Channel Webhooks​

Each messaging platform you connect delivers messages to ClawCentral via a dedicated inbound webhook URL:

https://<your-tenant>.clawcentral.io/webhooks/<platform>

For example:

  • https://<your-tenant>.clawcentral.io/webhooks/telegram
  • https://<your-tenant>.clawcentral.io/webhooks/whatsapp
  • https://<your-tenant>.clawcentral.io/webhooks/slack
  • https://<your-tenant>.clawcentral.io/webhooks/discord
  • https://<your-tenant>.clawcentral.io/webhooks/teams
  • https://<your-tenant>.clawcentral.io/webhooks/google-chat
  • https://<your-tenant>.clawcentral.io/webhooks/matrix
  • https://<your-tenant>.clawcentral.io/webhooks/zalo
  • https://<your-tenant>.clawcentral.io/webhooks/bluebubbles

These endpoints are configured automatically when you connect a channel via Admin UI → Channels. See Channels for setup instructions for each platform.

How Inbound Webhooks Work​

When an external platform sends a message to your webhook URL:

  1. ClawCentral verifies the platform's signature or token.
  2. The message is routed to your agent for processing.
  3. The agent's response is delivered back to the originating channel.

All of this happens in ClawCentral's cloud — there is no local process required and the webhook endpoint is always live.

Triggering Automation from External Systems​

To trigger your agent from an external system or custom integration, you have two main approaches:

1. Schedule-based triggers (Cron)​

Use ClawCentral's built-in cron scheduler to run the agent on a time-based schedule. Configure via Admin UI → Settings → Cron. See Cron Jobs for full details.

2. Message-channel triggers​

Send a message to any of your connected channels from an external system. For example:

  • POST a message to your Telegram bot
  • Send a Slack message to your bot's channel
  • Use Discord's bot API to send a message

The channel webhook delivers it to ClawCentral, which triggers your agent as normal.

Security​

ClawCentral verifies all inbound webhook payloads using each platform's native signature or token mechanism before processing:

  • Telegram: webhook secret token
  • Discord: Ed25519 signature
  • Slack: HMAC-SHA256 signing secret
  • WhatsApp: X-Hub-Signature-256
  • Teams: JWT (Bot Framework JWKS)
  • Google Chat: OIDC JWT
  • Matrix: application service token
  • Zalo: HMAC-SHA256 MAC header
  • BlueBubbles: shared secret

Webhook credentials are stored securely in ClawCentral's cloud storage and never exposed to clients.

See Also​

  • Channels — connecting and configuring messaging platforms
  • Cron Jobs — scheduled cloud-managed automation
  • Cron vs Heartbeat — choosing the right automation mechanism