​

Slack configuration

​

Auth modes

​

What to register (Slack)

​

Bot token (recommended)

1. api.slack.com/apps → Create New App.
2. OAuth & Permissions → add Bot Token Scopes (chat:write, channels:read, etc.).
3. Install to Workspace → copy Bot User OAuth Token (xoxb-...).
4. php artisan sanvex:setup slack --bot-token="xoxb-...".

​

User token

​

OAuth2 (multi-workspace installs)

1. Same Slack app → OAuth & Permissions.
2. Add Redirect URLs matching SLACK_REDIRECT_URI.
3. Copy Client ID and Client Secret from Basic Information.
4. Implement OAuth in your app; store tokens with SlackKeyBuilder::setOAuthCredentials().

​

Environment variables

​

config/sanvex.php (optional)

'slack' => [
    'auth_type' => env('SLACK_AUTH_TYPE', 'api_key'),
    'oauth' => [
        'client_id' => env('SLACK_CLIENT_ID', ''),
        'client_secret' => env('SLACK_CLIENT_SECRET', ''),
        'redirect_uri' => env('SLACK_REDIRECT_URI', env('APP_URL') . '/sanvex/slack/callback'),
        'success_redirect' => env('SLACK_SUCCESS_REDIRECT', '/'),
    ],
],

​

Stored credential keys (sv_accounts)

​

CLI

php artisan sanvex:setup slack --bot-token="xoxb-..."
php artisan sanvex:setup slack --api-key="xoxp-..."

​

Built-in Sanvex OAuth routes

​

What the driver reads at runtime