Skip to main content

​
Webhook

This is a shipped config-backed outbound surface. Generic webhook serve runtime is not implemented yet

​
At A Glance

FieldValue
Catalog idwebhook
Config keywebhook
Implementation statusconfig_backed
Transportgeneric_webhook
Aliaseshttp-webhook
Default send target kindendpoint

​
Minimal Config

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

​
Smoke Test

loong webhook-send --text "hello from loong"

​
Command Surface

OperationCommandUsage or status
http post sendwebhook-sendUsage: loong webhook-send [OPTIONS] —text <TEXT>
inbound webhook servicewebhook-servegeneric webhook serve runtime is not implemented yet

​
Required Fields For Send

RequirementConfig pathsEnv pointer pathsDefault env
channel enabledwebhook.enabled
webhook.accounts.<account>.enabled		nonenone
endpoint urlwebhook.endpoint_url
webhook.accounts.<account>.endpoint_url		webhook.endpoint_url_env
webhook.accounts.<account>.endpoint_url_env		WEBHOOK_ENDPOINT_URL

​
Gateway And Ownership

This surface is a direct-send delivery lane. It does not join multi-channel-serve or the gateway-owned reply-loop contract today.

​
Operator Notes

  • Use [outbound_http] allow_private_hosts = true when you intentionally post to a loopback or private bridge endpoint.
  • 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.