Webhook

This is a shipped standalone native-serve surface: outbound POST delivery is implemented, the signed inbound webhook service is implemented, and the runtime stays on channels serve webhook instead of gateway supervision today.

At A Glance

Field	Value
Catalog id	`webhook`
Config key	`webhook`
Implementation status	`runtime_backed`
Transport	`generic_webhook`
Aliases	`http-webhook`
Default send target kind	`endpoint`

Minimal Config

[webhook]
enabled = true
payload_format = "json_text"
payload_text_field = "text"
endpoint_url_env = "WEBHOOK_ENDPOINT_URL"
signing_secret_env = "WEBHOOK_SIGNING_SECRET"

Smoke Test

loong channels send webhook --text "hello from loong"
loong channels serve webhook --bind 127.0.0.1:7401

Command Surface

Operation	Command	Usage or status
http post send	`channels send webhook`	Usage: loong channels send webhook [OPTIONS] —text <TEXT>
inbound webhook service	`channels serve webhook`	Usage: loong channels serve webhook —bind <HOST:PORT> [—path <PATH>]

Required Fields For Send

Requirement	Config paths	Env pointer paths	Default env
channel enabled	`webhook.enabled` `webhook.accounts.<account>.enabled`	none	none
endpoint url	`webhook.endpoint_url` `webhook.accounts.<account>.endpoint_url`	`webhook.endpoint_url_env` `webhook.accounts.<account>.endpoint_url_env`	`WEBHOOK_ENDPOINT_URL`

Required Fields For Serve

Requirement	Config paths	Env pointer paths	Default env
channel enabled	`webhook.enabled` `webhook.accounts.<account>.enabled`	none	none
signing secret	`webhook.signing_secret` `webhook.accounts.<account>.signing_secret`	`webhook.signing_secret_env` `webhook.accounts.<account>.signing_secret_env`	`WEBHOOK_SIGNING_SECRET`

Gateway And Ownership

This surface ships a real built-in inbound service, but it remains a standalone native-serve lane today. Use channels serve webhook directly; it does not join gateway run or the gateway-owned reply-loop contract yet.

Operator Notes

channels serve webhook requires --bind because the local listener address stays operator-owned instead of coming from static config.
Use [outbound_http] allow_private_hosts = true when you intentionally post to a loopback or private bridge endpoint.
Treat this as a native serve lane, not as an outbound-only sink.

Continue to Channel Guides for the full shipped channel matrix.
Continue to Channels for the conceptual surface model.
Continue to Channel Setup for the shared public setup contract.

Overview

Get Started

Use Loong

Build On Loong

Reference

Webhook

Webhook

At A Glance

Minimal Config

Smoke Test

Command Surface

Required Fields For Send

Required Fields For Serve

Gateway And Ownership

Operator Notes

​Webhook

​At A Glance

​Minimal Config

​Smoke Test

​Command Surface

​Required Fields For Send

​Required Fields For Serve

​Gateway And Ownership

​Operator Notes

​Related Docs

Webhook

At A Glance

Minimal Config

Smoke Test

Command Surface

Required Fields For Send

Required Fields For Serve

Gateway And Ownership

Operator Notes

Related Docs