Concept et fiche techniqueConcept and technical sheet

Vos unités disponibles, toujours à jour.Your available units, always up to date.

Votre CRM sait quelle unité vient d'être réservée. seee le reflète dans le sélecteur d'unités et le module « Voir meublé », sans ressaisie. Cette page décrit la synchronisation prévue : rien de ceci n'est encore construit.Your CRM knows which unit was just reserved. seee mirrors it in the unit selector and the "seee it furnished" module, with no re-entry. This page describes the planned sync: none of it is built yet.

ConceptConnecteurs à venirConnectors planned
Flux de donnéesData flow

Le CRM ⇄ seee ⇄ votre siteCRM ⇄ seee ⇄ your website

CRM ⇄ API seee ⇄ sélecteur et module · CRM ⇄ seee API ⇄ selector and module CRM Salesforce, HubSpot, monday, Zoho, Pipedrive, REST, CSV Source de vérité : statut, prixSource of truth: status, price API seee Unités, statuts, historiqueUnits, statuses, history Correspondance des champsField mapping Règles de conflitConflict rules Propriétaire : rendus, styles,Owns: renders, styles, maquettes 3D, statistiques3D models, analytics Sélecteur d'unitésUnit selector Plan d'étage, statuts en directFloor plan, live statuses sur votre siteon your website Module « Voir meublé »"seee it furnished" Rendus par pièce et par style,Renders per room and style, en marque blanchewhite-label statuts, prixstatus, price webhook, pull, CSV leads, unité vueleads, unit viewed (optionnel)(optional) vues, clicsviews, clicks CRM ⇄ API seee ⇄ sélecteur et module · CRM ⇄ seee API ⇄ selector and module CRM Salesforce, HubSpot, monday, Zoho,Pipedrive, REST, CSV Source de vérité : statut, prixSource of truth: status, price statuts, prixstatus, price webhook, pull, CSV leads (optionnel)leads (optional) API seee Unités, statuts, correspondance, conflitsUnits, statuses, mapping, conflicts Propriétaire : rendus, styles,Owns: renders, styles, maquettes 3D, statistiques3D models, analytics vues, clics ↑views, clicks ↑ SélecteurSelector Plan d'étage,Floor plan, statuts en directlive statuses Voir meubléseee it furnished Rendus par pièceRenders per room et par styleand style
Modes de synchronisationSync modes

Trois façons de brancher votre CRMThree ways to connect your CRM

01 · Push

Webhook

Le CRM envoie un événement à seee dès qu'un statut ou un prix change. Le sélecteur se met à jour en quelques secondes.The CRM sends an event to seee as soon as a status or price changes. The selector updates within seconds.

DélaiDelay
quelques secondesa few seconds
SécuritéSecurity
signature HMAC SHA-256HMAC SHA-256 signature
PourFor
CRM qui émettent des webhooksCRMs that emit webhooks
02 · Pull

Lecture planifiéeScheduled pull

seee interroge l'API du CRM toutes les 5 minutes et ne garde que les unités modifiées. Sert aussi de filet si un webhook se perd.seee queries the CRM's API every 5 minutes and keeps only the changed units. Also a safety net if a webhook is lost.

DélaiDelay
5 minutes au plus5 minutes at most
AccèsAccess
clé en lecture seuleread-only key
PourFor
CRM sans webhooks, réconciliationCRMs without webhooks, reconciliation
03 · Import

CSV ou Google SheetCSV or Google Sheet

Pour les équipes qui tiennent leur grille dans un tableur : dépôt d'un CSV, ou lecture d'une feuille partagée chaque heure.For teams that keep their price list in a spreadsheet: upload a CSV, or read a shared sheet every hour.

DélaiDelay
au dépôt, ou toutes les heureson upload, or hourly
ContrôleCheck
aperçu des changements avant d'appliquerpreview of changes before applying
PourFor
petits projets, démarrage rapidesmall projects, quick start
Correspondance des champsField mapping

Ce que seee lit de votre CRMWhat seee reads from your CRM

Les noms côté CRM sont des exemples de champs personnalisés : on les associe une fois, au branchement.CRM-side names are examples of custom fields: they are mapped once, at setup.

Champ seeeseee fieldTypeExemple côté CRMCRM-side exampleObligatoireRequiredNote
unit_idtextestringUnit_Number__c · unit_numberouiyesClé de rapprochement, ex. « 405 »Matching key, e.g. "405"
floorentierintegerFloor__couiyesPlace l'unité sur le plan d'étagePlaces the unit on the floor plan
typetextestringUnit_Type__c · modelouiyesRelie l'unité à son modèle et à ses rendusLinks the unit to its model and renders
area_sqftnombrenumberArea_Sqft__cnonnopi² ; m² convertisq ft; m² converted
pricemontant (CAD)amount (CAD)List_Price__c · amountnonnoVente ; masqué si videSale; hidden if empty
rentmontant / moisamount / monthMonthly_Rent__cnonnoLocation ; masqué si videRental; hidden if empty
statusénumérationenumStatus__c · dealstageouiyesVoir la correspondance des statutsSee status mapping
plan_urlURLFloor_Plan_URL__cnonnoPlan de vente PDF ou image ; seee en tire la maquetteSales plan PDF or image; seee builds the model from it
updated_atISO 8601LastModifiedDate · hs_lastmodifieddateouiyesOrdonne les changements (règle 03)Orders changes (rule 03)

Correspondance des statutsStatus mapping

Valeur dans le CRM (exemples)CRM value (examples)Statut seeeseee statusDans le sélecteurIn the selector
Available · Open · LibreDisponibleAvailableCliquable, rendus « Voir meublé » actifsClickable, "seee it furnished" renders on
Hold · Option · Deposit received · RéservéeRéservéeReservedVisible, marquée réservée, rendus encore visiblesVisible, marked reserved, renders still visible
Firm · Closed won · Acte signéVendueSoldGrisée, prix masquéGreyed out, price hidden
Leased · Lease signed · Bail signéLouéeLeasedGrisée, loyer masquéGreyed out, rent hidden
Off market · RetiréeMasquéeHiddenNon affichéeNot shown
Valeur inconnueUnknown valuestatut précédent gardéprevious status keptAlerte dans le journal de synchroAlert in the sync log
Règles de conflitConflict rules

Qui a le dernier motWho has the last word

  1. Le CRM fait foi pour le statut, le prix et le loyer.The CRM is the source of truth for status, price and rent.Une valeur venue du CRM remplace toujours celle de seee.A value from the CRM always replaces seee's.
  2. seee possède les rendus, les styles, les maquettes 3D et les statistiques.seee owns renders, styles, 3D models and analytics.Le CRM ne les écrase jamais ; seee peut lui renvoyer leurs liens, si vous le voulez.The CRM never overwrites them; seee can send their links back to it, if you want.
  3. Le changement le plus récent gagne.The most recent change wins.Chaque événement porte updated_at ; un événement plus ancien que la valeur enregistrée est ignoré, même s'il arrive en retard.Each event carries updated_at; an event older than the stored value is ignored, even if it arrives late.
  4. Chaque événement ne compte qu'une fois.Each event counts only once.L'identifiant event_id rend les renvois sans effet.The event_id makes replays harmless.
  5. Un changement fait dans seee est marqué « manuel ».A change made in seee is flagged "manual".Il est renvoyé au CRM si l'écriture est permise ; sinon, la synchro suivante le remplace et le journal l'indique.It is sent back to the CRM if writing is allowed; otherwise the next sync replaces it and the log says so.
  6. Une unité inconnue n'est jamais créée automatiquement.An unknown unit is never created automatically.Elle attend en quarantaine qu'on l'associe à une unité du plan.It waits in quarantine until it is matched to a unit on the plan.
  7. La lecture des 5 minutes réconcilie le reste.The 5-minute pull reconciles the rest.Elle rattrape tout webhook perdu ; l'expiration des réservations reste gérée par le CRM.It catches any lost webhook; reservation expiry stays with the CRM.
ConnecteursConnectors

Prévus, pas encore construitsPlanned, not built yet

Salesforce

Objet personnalisé « Unité » ; Platform Events ou lecture planifiée.Custom "Unit" object; Platform Events or scheduled pull.

À venirPlanned
HubSpot

Objet personnalisé ou étapes de transaction ; webhooks d'application.Custom object or deal stages; app webhooks.

À venirPlanned
monday CRM

Tableau « Unités » (un élément par unité, colonne Statut) ; webhooks et API GraphQL de monday.com."Units" board (one item per unit, Status column); monday.com webhooks and GraphQL API.

À venirPlanned
Zoho CRM

Module personnalisé ; notifications ou lecture planifiée.Custom module; notifications or scheduled pull.

À venirPlanned
Pipedrive

Produits ou transactions ; webhooks.Products or deals; webhooks.

À venirPlanned
REST / webhook génériqueGeneric REST / webhook

Pour un CRM maison ou un logiciel de vente immobilière : l'API ci-dessous.For an in-house CRM or real-estate sales software: the API below.

À venirPlanned
CSV · Google Sheets

Gabarit de colonnes fourni ; aperçu des changements avant d'appliquer.Column template provided; preview of changes before applying.

À venirPlanned
API RESTREST API

Un aperçu de l'API prévueA preview of the planned API

Ébauche de spécification, sujette à changement.Draft spec, subject to change. Aucun de ces points d'accès n'existe aujourd'hui. L'adresse api.seee.studio est indicative.None of these endpoints exist today. The api.seee.studio address is indicative.

GET/v1/projects/{project_id}/units

Liste les unités d'un projet. Filtres : status, floor, type, updated_since.Lists a project's units. Filters: status, floor, type, updated_since.

GET /v1/projects/les-cedres/units?status=available&floor=4
Authorization: Bearer <project_key>

200 OK
{
  "project_id": "les-cedres",
  "units": [
    {
      "unit_id": "405",
      "floor": 4,
      "type": "A",
      "area_sqft": 680,
      "price": 398000,
      "rent": 1940,
      "currency": "CAD",
      "status": "available",
      "plan_url": "https://example.com/plans/type-a.pdf",
      "renders_url": "https://api.seee.studio/v1/units/405/renders",
      "updated_at": "2026-11-20T14:02:11Z"
    }
  ],
  "next_cursor": null
}

PATCH/v1/units/{unit_id}

Met à jour le statut, le prix ou le loyer d'une unité. Les rendus et les styles ne sont pas modifiables par cette route.Updates a unit's status, price or rent. Renders and styles cannot be changed through this route.

PATCH /v1/units/405?project_id=les-cedres
Authorization: Bearer <project_key>
Content-Type: application/json

{
  "status": "reserved",
  "source": "crm",
  "updated_at": "2026-11-20T14:05:37Z"
}

200 OK
{ "unit_id": "405", "status": "reserved", "previous_status": "available", "applied": true }

POST/v1/hooks/{project_id} webhook entrantincoming webhook

Ce que le CRM (ou votre intergiciel) envoie à seee. Signé avec l'en-tête X-Seee-Signature (HMAC SHA-256 du corps, secret propre au projet).What the CRM (or your middleware) sends to seee. Signed with the X-Seee-Signature header (HMAC SHA-256 of the body, per-project secret).

{
  "event_id": "evt_01JD3K8Q2V",
  "type": "unit.status_changed",
  "occurred_at": "2026-11-20T14:05:37Z",
  "project_id": "les-cedres",
  "unit": {
    "unit_id": "405",
    "status": "reserved",
    "previous_status": "available",
    "price": 398000,
    "updated_at": "2026-11-20T14:05:37Z"
  },
  "crm": { "name": "hubspot", "record_id": "18392041" }
}

Statuts de l'API : available, reserved, sold, leased, hidden. Réponses : 202 accepté, 200 déjà traité (même event_id), 409 plus ancien que la valeur enregistrée, 401 signature invalide.API statuses: available, reserved, sold, leased, hidden. Responses: 202 accepted, 200 already processed (same event_id), 409 older than the stored value, 401 invalid signature.