Skip to content

Integration Setup Guides

Step-by-step guides for connecting Agent Smith to chat platforms and ticket-event sources.

Chat Platforms

Platform Guide Status
Slack Slack Setup Production-ready
Teams Teams Setup Beta

Ticket Ingress

Tickets enter Agent Smith via one (or both) of two paths. Both feed the same TicketClaimService and the same lifecycle.

Path Latency Network requirement Setup
Webhook Sub-second Public HTTPS endpoint reachable from the platform Per-platform setup in the platform UI
Polling interval_seconds ± jitter (default 60s) Outbound only — no inbound traffic One YAML stanza per project

Pick webhooks when you have a reachable endpoint and want minimum latency. Pick polling when you run in a private network with no inbound HTTP, or want a self-healing safety net. Use both for redundancy — claims are idempotent, the first one wins.

Detailed comparison: Polling vs Webhooks.

Webhook Setup

Platform Guide Trigger config Lifecycle labels
GitHub GitHub Webhooks github_trigger Yes
GitLab GitLab Webhooks gitlab_trigger Yes
Azure DevOps Azure DevOps Webhooks azuredevops_trigger Yes
Jira Jira Webhooks jira_trigger Yes (label-mode)

Polling Setup

Platform Guide Status
GitHub Polling Setup Supported
GitLab Polling Setup Supported
Azure DevOps Polling Setup Supported
Jira Polling Setup Supported (label-mode)

Label & Tag Triggers

How user-added labels (agent-smith, security-review, etc.) map to pipelines — same model across all four platforms.

Topic Guide
Label-Based Triggers Per-platform pipeline_from_label config and matching rules

Background Reading