> ## Documentation Index
> Fetch the complete documentation index at: https://docs.emailx.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Workspace e canali

> Mantieni ogni record collegato al cliente e al canale corretti.

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

```json theme={null}
{"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](https://docs.emailx.ai/it/overview/workflows.md) spiegano come mantenere queste distinzioni.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.