Integrations

Connect Roux to the tools your team already uses. Pull context into interviews and push findings where they matter.

GitHub

Install the Roux GitHub App on your organization or personal account. Roux uses installation-scoped access tokens — no personal access tokens needed.

Features

Pull issue and PR context into interviews
Push research findings as GitHub issues
Select a default repository per workspace
Webhook-driven lifecycle management

Setup

1 Go to Settings → Integrations → GitHub in the Roux app.

2 Click Install GitHub App. You'll be redirected to GitHub to choose which repositories Roux can access.

3 After installation, you'll be redirected back to Roux. Select a default repository and enable the features you want.

Permissions requested

Issues	Read & write
Pull requests	Read
Metadata	Read

Linear

Connect Linear to run issue intake interviews. Roux pulls issue and project context to guide conversations and pushes synthesized insights back as comments or new issues.

Features

Issue intake framework with Linear context
Pull project and issue metadata into interviews
Auto-discover teams, projects, and labels

Setup

1 Generate a personal API key in Linear → Settings → API.

2 Go to Settings → Integrations → Linear in Roux and paste the key.

3 Select your default team and project, then enable features.

Slack

Get notified in Slack when synthesis is ready. Roux posts a summary to your chosen channel so your team stays in the loop without checking the dashboard.

Features

Synthesis-ready notifications
Channel selector from installed workspaces
Rich message formatting with key themes

Setup

1 Create a Slack app with a bot token that has chat:write, channels:read, and groups:read scopes.

2 Paste the bot token in Settings → Integrations → Slack.

3 Select the channel for notifications and enable synthesis alerts.

Webhooks

Coming soon

Subscribe to Roux events and receive payloads at your own endpoint. Get notified when responses complete, synthesis is generated, or interviews change status.

Features

Response completion events
Synthesis generation events
Interview lifecycle events
HMAC signature verification

Webhooks are under development. In the meantime, use agent tokens to poll the API for changes.

Automation example

Create an interview and distribute the share link using the agent API:

# Create an interview
curl -X POST https://roux.link/api/agent/interviews \
  -H "Authorization: Bearer roux_..." \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Q2 User Research",
    "framework": "user-research",
    "tone": "conversational",
    "status": "active"
  }'

# Response includes a share_token — build the respondent link:
# https://roux.link/i/{share_token}

# Later, retrieve synthesis:
curl https://roux.link/api/agent/synthesis?interview_id={id} \
  -H "Authorization: Bearer roux_..."