Espaço de trabalho

Seu espaço de trabalho é a unidade de trabalho no Bird. Ele contém seus domínios, chaves API, envios e acesso de equipe. O dashboard é organizado por espaço de trabalho, e toda ação acontece dentro do seu espaço de trabalho. Sua conta está vinculada a uma única região e contém suas informações de faturamento.

Para renomear o espaço de trabalho atual, acesse Settings > General, edite Name e saia do campo para salvar. A edição exige permissão para gerenciar esse espaço de trabalho.

Para criar outro espaço de trabalho, acesse a página Workspaces da sua organização e escolha Create workspace. Preencha Workspace name e confirme. A disponibilidade depende do acesso e do limite de espaços de trabalho da sua organização. Quando a criação estiver desativada, verifique o motivo exibido. Alternar para um espaço de trabalho existente não cria um novo.

Regiões

Sua conta está fixada em exatamente uma região, atualmente us1 (Estados Unidos) ou eu1 (União Europeia). A região é escolhida no cadastro e não pode ser alterada: seus dados e infraestrutura de envio ficam lá, e o tráfego API vai para o host dessa região, https://us1.platform.bird.com ou https://eu1.platform.bird.com. A região está embutida em cada prefixo de chave API (bk_us1_...), então as requisições se roteiam sozinhas. Consulte URLs base e regiões para as regras de roteamento e o que acontece com uma requisição que chega à região errada.

Como uma requisição encontra seu espaço de trabalho

A API de Bird usa rotas planas (/v1/email/messages, /v1/sms/messages) sem segmento de espaço de trabalho no caminho. A credencial carrega o contexto: uma chave API está vinculada ao seu espaço de trabalho, o que também define sua organização e região, então uma requisição não precisa de nada além da própria chave. Uma requisição que indica um contexto em contradição com sua chave é rejeitada como malformada (400), em vez de ser reinterpretada silenciosamente.

Se a requisição é então permitida é uma questão separada, respondida por escopos de chave para chaves API e por papéis para pessoas que trabalham no dashboard.

Encerramento de uma organização

O encerramento de uma organização é permanente e foi projetado para ser difícil de fazer por acidente. Um proprietário solicita o encerramento, e o Bird envia por e-mail um link de confirmação. Nada muda até você confirmar seguindo esse link. Para encerrar sua própria conta de usuário em vez de uma organização, consulte Encerrar sua conta.

Após a confirmação:

• O bloqueio é imediato. Sua conta desaparece do dashboard, suas chaves API deixam de autenticar e são revogadas, os envios param e qualquer assinatura ativa é cancelada.
• Em seguida, há um período de carência de 7 dias. Dados, configurações e associações de equipe são mantidos intactos. O e-mail de encerramento contém um link de cancelamento, e seguir esse link dentro do período restaura o acesso. Tudo volta, exceto as chaves API, que foram revogadas no bloqueio e precisam ser emitidas novamente.
• Depois, a exclusão é irreversível. Ao fim do período, a limpeza é executada e remove tudo: domínios, supressões, endpoints de webhook, templates, associações e dados. Nada pode ser recuperado depois que a exclusão começa.

Próximos passos

• Autenticação e chaves API: como as chaves se vinculam a um espaço de trabalho
• Usuários, equipes e papéis: papéis e controle de acesso do espaço de trabalho, incluindo papéis de nível de conta para faturamento
• URLs base e regiões: hosts regionais e roteamento