Sign inGet Started

Spazio di lavoro

Il tuo spazio di lavoro è l'unità operativa in Bird. Contiene i tuoi domini, le chiavi API, gli invii e l'accesso del team. La dashboard è organizzata per spazio di lavoro, e ogni azione avviene all'interno del tuo spazio di lavoro. Il tuo account è legato a una singola regione e contiene le informazioni di fatturazione.

Per rinominare lo spazio di lavoro corrente, apri Settings > General, modifica Name ed esci dal campo per salvare. Per la modifica serve l'autorizzazione a gestire quello spazio di lavoro.

Per creare un altro spazio di lavoro, apri la pagina Workspaces della tua organizzazione e scegli Create workspace. Inserisci Workspace name e conferma. La disponibilità dipende dall'accesso della tua organizzazione e dal suo limite di spazi di lavoro. Se la creazione è disabilitata, controlla il motivo indicato. Passare a uno spazio di lavoro esistente non ne crea uno nuovo.

Regioni

Il tuo account è vincolato a una sola regione, attualmente us1 (Stati Uniti) o eu1 (Unione Europea). La regione viene scelta al momento della registrazione e non può essere modificata: i tuoi dati e l'infrastruttura di invio risiedono lì, e il traffico API viene indirizzato all'host di quella regione, https://us1.platform.bird.com o https://eu1.platform.bird.com. La regione è incorporata nel prefisso di ogni chiave API (bk_us1_...), quindi le richieste si instradano automaticamente. Consulta URL di base e regioni per le regole di instradamento e per sapere cosa succede a una richiesta che raggiunge la regione sbagliata.

Come una richiesta trova il tuo spazio di lavoro

L'API di Bird usa rotte piatte (/v1/email/messages, /v1/sms/messages) senza segmento dello spazio di lavoro nel percorso. Il contesto è trasportato dalla credenziale: una chiave API è legata al tuo spazio di lavoro, il che fissa anche la sua organizzazione e la sua regione, quindi una richiesta non ha bisogno di nulla oltre alla chiave stessa. Una richiesta che indica un contesto in contraddizione con la propria chiave viene rifiutata come malformata (400) anziché reinterpretata silenziosamente.

Se la richiesta viene poi autorizzata è una questione separata, a cui rispondono gli scope delle chiavi per le chiavi API e i ruoli per le persone che lavorano nella dashboard.

Chiusura di un'organizzazione

La chiusura di un'organizzazione è permanente e deliberatamente difficile da effettuare per errore. Un proprietario la richiede e Bird invia via email un link di conferma. Finché non confermi seguendo quel link, non cambia nulla. Per chiudere il tuo account utente anziché un'organizzazione, consulta Chiudere il tuo account.

Una volta confermata:

  • Il blocco è immediato. Il tuo account scompare dalla dashboard, le sue chiavi API smettono di autenticarsi e vengono revocate, l'invio si interrompe e qualsiasi abbonamento attivo viene cancellato.
  • Segue una finestra di grazia di 7 giorni. Dati, configurazione e appartenenze ai team vengono conservati intatti. L'email di chiusura contiene un link di annullamento: seguendolo entro la finestra si ripristina l'accesso. Tutto viene recuperato tranne le chiavi API, che sono state revocate al momento del blocco e devono essere riemesse.
  • Dopodiché la cancellazione è irreversibile. Trascorsa la finestra, il processo di pulizia recupera tutto: domini, soppressioni, endpoint webhook, template, appartenenze, dati. Nulla può essere recuperato una volta iniziata la cancellazione.

Passaggi successivi

Continua con la documentazione, le guide e gli esempi per questo argomento.