GitHub logo
GitHub
GitHub is a non-chat channel. Messages live in their own session, not merged into the canonical chat.

​
At a glance

Familynon-chat
Setup sourceGitHub app
InboundWebhook / long-poll / socket — see below
Outboundqorven channels send --channel github or auto-reply from the agent loop
MediaText + attachments (where the transport supports it)
Group chatsGroup handling →

​
Setup

1

Create the channel binding in Settings → Channels

In the web UI: Settings → Channels → Add channel → GitHub. Paste the credentials from GitHub app.
2

Configure the webhook URL (if the provider pushes events)

Qorven exposes POST /v1/webhooks/github on the web listener. Use your public URL (or a tunnel like Cloudflare / ngrok for dev).
3

Assign a Qor

Bind this channel to one Qor. That Qor receives every inbound message. You can always delegate onward.
4

Test with one message

Send a message from GitHub. Watch it appear in the web UI canonical chat with the GitHub badge.

​
Routing & overrides

By default, every inbound GitHub message is routed to the Qor bound to this channel. You can override:
  • By sender — route VIP senders to a different Qor
  • By keyword — “URGENT” → escalation Qor
  • By group — if it’s a group chat, use group-scoped settings
See Channel routing →.

​
Common issues

  • Check qorven channels status github — is the binding active?
  • Check the webhook URL is reachable from the internet (provider needs to hit it)
  • Check /var/log/qorven/channels.log for webhook 4xx/5xx entries
  • Rate limits: every channel has a per-tenant quota; see quotas
  • Check the Qor has the send_message tool in its allowlist
  • Check the LLM isn’t emitting malformed tool calls — qorven logs --filter agent.loop.tool_error
  • Check the channel binding’s credentials haven’t expired (OAuth channels rotate tokens)
  • Usually webhook retries. Qorven dedupes by (channel, external_id) but some providers send different IDs on retry. Open an issue with logs.
Logo displayed under nominative fair use. See trademarks & attribution for owner, source library, and removal requests.

All channels

Catalog + concepts.

One Qor, one chat

How chat-family channels merge.

Channel routing

Custom routing rules.

qorven channels CLI

Scripted channel management.