Add agents to Slack

A Slack installation connects one Slack workspace to an Alomana workspace. People in Slack mention @Alomana or message it directly, pick an agent, and the thread continues with that agent. Each person is matched to their Alomana account by their Slack profile email.

Endpoints

Every route needs X-Space-Slug.

Responses never include the Slack bot token: credentials is null.

Install Slack

Bearer only: run these steps as the signed-in user installing the app.

1. Start the flow with the URL Slack should return to:

   curl -X POST "$CENTRAL_HUB_URL/api/v1/integrations/slack/oauth/init/" \
     -H "Authorization: Bearer $ALO_TOKEN" \
     -H "X-Space-Slug: $WORKSPACE_SLUG" \
     -H "Content-Type: application/json" \
     -d '{"redirect_uri": "https://your-app.example.com/slack/callback"}'

   {"auth_url": "https://slack.com/oauth/v2/authorize?client_id=…", "state": "RS_mm…YmM"}

2. A Slack admin opens auth_url in a browser and approves the app.

3. Slack redirects to redirect_uri with code. Send it with the state from step 1, as the same user:

   curl -X POST "$CENTRAL_HUB_URL/api/v1/integrations/slack/oauth/callback/" \
     -H "Authorization: Bearer $ALO_TOKEN" \
     -H "X-Space-Slug: $WORKSPACE_SLUG" \
     -H "Content-Type: application/json" \
     -d '{"code": "<code from the redirect>", "state": "<state from init>"}'

4. The response is the installation, with provider: "slack", display_name and access_space_slug, the workspace it serves.

Errors