Workspace e canali - Emailx

Un workspace è l’account cliente proprietario di contatti, campagne e attività salvate. L’API usa l’ID dell’account Emailx come workspace_id, non l’ID del collegamento interno all’agenzia.

Accesso cliente e agenzia

Una chiave cliente accede ai workspace assegnati esplicitamente. Una chiave agenzia richiede anche agency:read, lo scope della risorsa e un’assegnazione attuale al cliente. Chiama GET /workspaces prima di scegliere l’account; non provare ID adiacenti.

Salva l’identità completa

{"workspace_id": 123, "channel": "linkedin", "campaign_id": 456}

Gli ID delle campagne e delle conversazioni possono coincidere tra email e LinkedIn. Nei collegamenti CRM conserva (workspace_id, channel, id). I contatti appartengono al workspace e si cercano per email esatta; un provider ID LinkedIn è un’identità diversa.

Verifica i permessi attuali

GET /me mostra il perimetro configurato sulla credenziale. GET /workspaces restituisce il sottoinsieme attualmente accessibile. Un’assegnazione rimossa, un membro disabilitato o un workspace non disponibile possono rendere inaccessibile un ID prima valido. Il 404 privato non rivela se il record appartiene a un altro cliente.

Interpreta i dati salvati

L’inbox contiene conversazioni di campagna salvate con risposte e history_complete=false. Lo stato del mittente è un metadato salvato, non un controllo di salute in tempo reale. Le analytics mostrano totali storici, non serie giornaliere. Le ricette operative spiegano come mantenere queste distinzioni.