vicket
Commencer
Concepts / Nº 02

Organisations & sites

Une organisation est le tenant racine. Un site est une surface client à votre marque à l'intérieur de cette org. Toute autre ressource (tickets, statuts, priorités, articles, FAQ, workflows) est rattachée à l'une ou à l'autre.

Organisation

L'org porte la facturation, les membres, le RBAC et le catalogue de ressources. Créez-en une par entreprise. Les agences qui gèrent le support de plusieurs clients créent une org pour l'agence, puis un site par client.

{
  "id": "b3a1c9d4-...",
  "slug": "acme",
  "name": "Acme Inc.",
  "created_at": "2026-04-12T09:31:00Z"
}

Le slug est immuable une fois créé et apparaît dans chaque chemin de l'API dashboard : /v1/orgs/{slug}/.... Côté org : membres, équipes, rôles, statuts, priorités, templates, workflows et centre d'aide.

Site

Un site représente un produit, une app ou une propriété client. Chaque site a sa propre clé publiable, sa propre liste d'origins, son propre routage email et sa propre file de tickets. Deux produits sous la même org prennent deux sites pour que les tickets ne se mélangent pas.

{
  "id": "f4e2b8a1-...",
  "org_id": "b3a1c9d4-...",
  "slug": "acme-app",
  "name": "Acme App",
  "origins": ["https://app.acme.com", "https://staging.acme.com"]
}

Qui vit où

RessourcePortéeNotes
Membres & équipesOrgLes équipes déterminent quels tickets un agent voit
StatutsOrgCatalogue partagé, rattachable à des sites précis
PrioritésOrgCatalogue partagé, calculées par ticket via le scoring
TemplatesOrgActivés par site ; pilotent le formulaire public
TicketsSiteAppartiennent toujours à exactement un site
Articles & FAQOrgVisibles partout, ou limités à un site via site_id
Clés de site (pk_)SiteUne clé active par site, rotation depuis le dashboard

Le rattachement au site est appliqué côté serveur sur chaque lecture et écriture. Une clé de site pour acme-app ne peut jamais voir ni modifier les données de acme-marketing, même si l'URL de la requête est fausse.

La suite