# Customer Support

> Unified read surface across helpdesk, chat, and omnichannel support platforms. 24 platform adapters are listed below.

Unified read surface across helpdesk, chat, and omnichannel support platforms. 24 platform adapters are listed below.

**Enterprise + majors:** [Zendesk](https://docs.opensteward.dev/integrate/customer-support/zendesk/) — enterprise reference (per-tenant subdomain), [Salesforce Service Cloud](https://docs.opensteward.dev/integrate/customer-support/salesforce-service/), Freshdesk — Freshworks (per-tenant subdomain), [Zoho Desk](https://docs.opensteward.dev/integrate/customer-support/zoho-desk/), [Kustomer](https://docs.opensteward.dev/integrate/customer-support/kustomer/), Gladly — omnichannel

**Chat + conversational:** [Intercom](https://docs.opensteward.dev/integrate/customer-support/intercom/) — conversation-first, [Drift](https://docs.opensteward.dev/integrate/customer-support/drift/), Tidio, Gist

**E-commerce:** Gorgias, Re:amaze

**SMB + shared inbox:** [Help Scout](https://docs.opensteward.dev/integrate/customer-support/helpscout/) — email-first SMB, Front, HappyFox, [GrooveHQ](https://docs.opensteward.dev/integrate/customer-support/groove/), Mojo Helpdesk — K-12 + government

**Regional + open-source-cloud:** Crisp — France, [LiveChat](https://docs.opensteward.dev/integrate/customer-support/livechat/) — Poland, [Hiver](https://docs.opensteward.dev/integrate/customer-support/hiver/) — Gmail-on-top India, HelpCrunch — Ukraine, Chatwoot — India open-source-cloud, Customerly — Italy, [Trengo](https://docs.opensteward.dev/integrate/customer-support/trengo/) — Netherlands omnichannel

## Canonical schema

| Resource | Purpose |
|---|---|
| `Ticket` | Top-level conversation / case. Status, priority, channel-normalised, requester, assignee, tags, optional parentTicketId for merges. |
| `Message` | Body text inside a ticket. Public reply or internal note. Text included verbatim; attachment content refused. |
| `Contact` | Customer identity. PII-minimal (email + name + phone only). |
| `User` | Agent identity. |
| `Tag` | Taxonomy. |
| `Team` | Agent group. |
| `Macro` | Canned response template. Returns `[]` on platforms without this surface. |

## Refused at the schema level

- Attachment content (bytes) — not exposed
- Voice / call recording audio + transcripts — not exposed
- AI-generated summaries / suggested replies
- Contact PII beyond name + email + phone
- Satisfaction-survey free-text (only numeric rating)
- Pre-consent visitor session transcripts

## Internal-note posture

Messages of `type: 'internal'` pass through body text as-is. Operators are responsible for downstream PII redaction — adapter does no automatic redaction (same posture as docsign audit-trail descriptions).

## Channel normalisation

Canonical `Ticket.channel`: `email | chat | voice | social | web | sms | api | other`. Platform-specific raw values live in `metadata.rawChannel`.

## Endpoints

| Verb | Path | Notes |
|---|---|---|
| GET | `/v1/customer-support/tickets` | List tickets |
| GET | `/v1/customer-support/tickets/{id}` | Get one |
| GET | `/v1/customer-support/messages?ticket_id=…` | List messages on a ticket |
| GET | `/v1/customer-support/contacts` | List customers |
| GET | `/v1/customer-support/users` | List agents |
| GET | `/v1/customer-support/tags` | List tags |
| GET | `/v1/customer-support/teams` | List teams |
| GET | `/v1/customer-support/macros` | List canned responses (may be empty) |

## Authentication

Tenant mode (`Authorization: Bearer oi_…`). Each `/v1/customer-support/*` request requires `connection_id` (UUID from OAuth callback). Per-tenant subdomain platforms (Zendesk, Freshdesk, Gorgias) require an additional `tenantSubdomain` field at connection creation.
