# Slack Chat Connector

## Quick install

See the [package README](../../../README.md). Dispatches when
`providerId === 'slack'`.

## Configuration

```typescript
const sl = new Chat('slack', {
  webhookUrl: 'https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXX',
});
```

| Field | Type | Required | Notes |
|---|---|---|---|
| `webhookUrl` | `string` | yes | Incoming Webhook URL — the URL itself is the credential |

## Auth setup

Create an Incoming Webhook at https://docs.slack.dev/messaging/sending-messages-using-incoming-webhooks. The
URL itself is the credential — anyone with it can post to the destination
channel. Treat as a secret.

## Endpoint

The webhook URL is the endpoint. Slack pinned the URL when the webhook was
created; the channel is fixed per webhook.

## Narrowed input augmentations

Standard chat input (`to` is ignored — channel comes from the webhook URL).
Block Kit and threading via `_passthrough.body`.

## Error mapping

| Vendor HTTP | Vendor signal | `providerCode` |
|---|---|---|
| 400 `no_text` / `invalid_payload` | `invalid_request` |
| 401 / 403 / 404 (revoked webhook) | `auth_failed` |
| 429 | (any) | `rate_limited` |
| 5xx | (any) | `provider_unavailable` |
| network failure | — | `provider_unavailable` |

## `_passthrough` examples

Block Kit message:

```typescript
await sl.send({
  body: 'fallback for clients that don't render blocks',
  _passthrough: {
    body: {
      blocks: [
        { type: 'section', text: { type: 'mrkdwn', text: '*Hello* world' } },
      ],
    },
  },
});
```

## Vendor docs

- API reference: https://docs.slack.dev/messaging/sending-messages-using-incoming-webhooks
- Block Kit: https://docs.slack.dev/block-kit/
- Errors: https://docs.slack.dev/messaging/sending-messages-using-incoming-webhooks