Customer Support
Unified read surface across helpdesk, chat, and omnichannel support platforms. 24 platform adapters are listed below.
Enterprise + majors: Zendesk — enterprise reference (per-tenant subdomain), Salesforce Service Cloud, Freshdesk — Freshworks (per-tenant subdomain), Zoho Desk, Kustomer, Gladly — omnichannel
Chat + conversational: Intercom — conversation-first, Drift, Tidio, Gist
E-commerce: Gorgias, Re:amaze
SMB + shared inbox: Help Scout — email-first SMB, Front, HappyFox, GrooveHQ, Mojo Helpdesk — K-12 + government
Regional + open-source-cloud: Crisp — France, LiveChat — Poland, Hiver — Gmail-on-top India, HelpCrunch — Ukraine, Chatwoot — India open-source-cloud, Customerly — Italy, Trengo — Netherlands omnichannel
Canonical schema
Section titled “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
Section titled “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
Section titled “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
Section titled “Channel normalisation”Canonical Ticket.channel: email | chat | voice | social | web | sms | api | other. Platform-specific raw values live in metadata.rawChannel.
Endpoints
Section titled “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
Section titled “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.
opensteward.dev ·Plans and free license ·Terms ·Privacy ·support@opensteward.dev
© 2026 Falco Consulting AB. Built from open-steward/opensteward@a3961d8. This site sets no cookies, runs no analytics and loads nothing from other sites, except platform logos from Brandfetch on the Platforms page.