Criar e gerenciar espaços de trabalho
Este artigo aborda como criar, configurar e gerenciar seus espaços de trabalho.
Artigos da seção
O que é um espaço de trabalho?
Tudo o que você faz na Braze acontece dentro de um espaço de trabalho. Os espaços de trabalho são um ambiente compartilhado para você acompanhar e gerenciar o engajamento de apps móveis ou websites relacionados. Eles agrupam apps iguais ou muito parecidos, como as versões para Android e iOS do seu app móvel.
Criar um espaço de trabalho
Etapa 1: Planeje
Antes de começar, trabalhe com sua equipe e com seu gerente de integração da Braze para definir a melhor configuração de espaço de trabalho para o seu caso de uso. Para saber mais sobre como planejar seus espaços de trabalho na Braze, confira nosso guia Primeiros passos: Espaços de trabalho.

Prática recomendada: Use projetos do Firebase dedicados para cada espaço de trabalho
A Braze permite fazer upload do mesmo JSON de conta de serviço do Firebase em vários espaços de trabalho. No entanto, todos os espaços de trabalho que usam o mesmo ID de projeto do Google compartilham o limite de frequência padrão do Firebase Cloud Messaging, de 600.000 mensagens por minuto. Remetentes de alto volume podem receber erros de “Quota Exceeded” ao lançar Campaigns simultaneamente em vários espaços de trabalho.
Para isolar a entregabilidade e o gerenciamento de cotas, use projetos do Firebase separados e dedicados para cada espaço de trabalho da Braze.
Etapa 2: Adicione seu espaço de trabalho
Você pode criar novos espaços de trabalho ou alternar entre os existentes no menu suspenso de espaços de trabalho, no cabeçalho global.
- Selecione o menu suspenso de espaços de trabalho e, em seguida, selecione Criar espaço de trabalho.

- Dê um nome ao seu espaço de trabalho.

Vale a pena adotar uma convenção de nomenclatura para que outras pessoas da sua empresa encontrem seu espaço de trabalho com facilidade. Por exemplo: “Upon Voyage US – Production” e “Upon Voyage US – Staging”.
- Selecione Criar. A Braze pode levar alguns segundos para criar seu espaço de trabalho.

Você será direcionado à página Configurações do app para começar a adicionar suas instâncias do app. Você pode acessar essa página a qualquer momento em Configurações > Configurações do app.

Etapa 3: Adicione suas instâncias do app
Chamamos de “instâncias do app” os diferentes sites e apps reunidos em um espaço de trabalho.
- Na página Configurações do app, selecione + Adicionar app.
- Dê um nome à sua instância do app e selecione em qual plataforma ou plataformas essa instância do app está. Se você selecionar várias plataformas, a Braze cria uma instância do app para cada plataforma.

- Selecione Adicionar app para confirmar.
Chaves de API do app
Depois de adicionar sua instância do app, você terá acesso à chave de API dela. A chave de API é usada nas solicitações entre sua instância do app e a API da Braze. Ela também é importante para integrar o SDK da Braze ao seu app ou website.


Você precisa criar instâncias do app separadas para cada versão do seu app em cada plataforma. Por exemplo, se você tiver versões Free e Pro do seu app no iOS e no Android, crie quatro instâncias do app no seu espaço de trabalho (app Free para iOS, app Free para Android, app Pro para iOS e app Pro para Android). Assim, você terá quatro chaves de API, uma para cada instância do app.
Versão do SDK em tempo real
A versão do SDK em tempo real exibida na página Configurações do app para um app específico é a versão mais alta do app que representa pelo menos 5% do total de sessões diárias e teve pelo menos 500 sessões no último dia.
Esse campo aparece depois que você integra o SDK da Braze ao seu app ou website. Se houver uma versão mais recente do SDK da Braze disponível para sua plataforma, isso será indicado aqui com a tag “Nova versão disponível”.

Etapa 4: Repita conforme necessário
Repita as etapas 2 e 3 para configurar quantos espaços de trabalho seu plano exigir. Como prática recomendada, sugerimos criar um espaço de trabalho de teste para testes de integração e de Campaigns.

Adicione um espaço de trabalho de teste
Você pode testar o app isolando completamente determinados usuários da sua instância de produção. Crie um novo espaço de trabalho e, ao publicar seu aplicativo, altere a chave de API usada pela Braze para que corresponda à do seu espaço de trabalho de produção, e não à do seu espaço de trabalho de teste.
Gerenciar espaços de trabalho
Adicionar favoritos
Você pode adicionar espaços de trabalho favoritos para acessar ainda mais rápido os espaços de trabalho que você mais usa.

Para adicionar espaços de trabalho favoritos:
- Selecione o menu suspenso do seu perfil e, em seguida, selecione Gerenciar sua conta.
- Na seção Perfil da conta, localize o campo Espaços de trabalho favoritos.
- Selecione seus espaços de trabalho na lista.
- Selecione Salvar alterações.
Não há limite para o número de espaços de trabalho que você pode favoritar. Mesmo assim, recomendamos manter essa lista curta por conveniência.
Renomear espaços de trabalho
Para renomear seu espaço de trabalho:
- Acesse Configurações > Configurações do app.
- Passe o mouse sobre o nome do seu espaço de trabalho e selecione Editar.
- Dê um novo nome ao seu espaço de trabalho e, em seguida, selecione Salvar.

Excluir espaços de trabalho e instâncias do app
Para excluir seu espaço de trabalho ou instância do app:
- Acesse Configurações > Configurações do app.
- Selecione Excluir espaço de trabalho para excluir o respectivo espaço de trabalho ou selecione o ícone de lixeira ao lado da respectiva instância do app.
Não é possível excluir instâncias do app ou espaços de trabalho que estejam sendo usados para direcionar usuários ou que tenham mais de 1.000 usuários. Se você tentar fazer isso, receberá uma mensagem de erro. Para prosseguir com a exclusão, abra um caso de suporte que inclua um link do dashboard e o nome da instância do app ou do espaço de trabalho a ser excluído.

Tenha cuidado ao excluir espaços de trabalho! Depois que um espaço de trabalho é excluído, não é possível recuperá-lo.

Perguntas frequentes
Devo criar um novo espaço de trabalho quando lanço um app atualizado?
Depende se você está atualizando seu app ou criando um app totalmente novo.
Atualizar seu app
Se você está atualizando seu app, separe as versões antiga e nova criando uma nova instância do app no mesmo espaço de trabalho. Assim, você direciona os usuários da nova versão ao selecionar esse app durante a segmentação. Para enviar mensagens aos usuários que ainda estão na versão antiga, use filtros para direcionar a versão anterior do app.
Se você criar um novo espaço de trabalho, seus usuários vão existir em dois lugares: no espaço de trabalho antigo e no novo. Eles também podem ter o mesmo token por push. Com isso, usuários que já fizeram upgrade podem receber uma mensagem de marketing destinada apenas aos usuários do espaço de trabalho antigo.
Lançar um novo app
Se você está lançando um app totalmente novo na loja de apps, crie um novo espaço de trabalho. Nesse caso, os dados históricos e os perfis de usuário da versão antiga do app não vão existir no novo espaço de trabalho. Então, quando os usuários existentes fizerem upgrade para a nova versão, um novo perfil será criado para eles, sem nenhum dos dados comportamentais do app antigo.
Tenho várias instâncias do app em um espaço de trabalho. Como garanto que minha mensagem seja direcionada a um único app?
Para garantir que sua mensagem seja direcionada apenas a um app específico, adicione um Segment que direcione somente os usuários das instâncias do app escolhidas. Isso é especialmente importante quando um usuário pode ter dois tokens por push para instâncias diferentes do app no mesmo espaço de trabalho. Nesse caso, ele poderia receber uma notificação de um app diferente daquele que está usando. Não é a experiência ideal!
Por padrão, um Segment direciona todos os apps e sites do espaço de trabalho. Para configurar um Segment que direcione apenas um app ou site:
- Crie um Segment com um nome significativo. Na Braze, usamos o formato “All Users ({Name} {Platform})”. Por exemplo, “All Users (Upon Voyage iOS)”.
- Em Apps e sites direcionados, selecione Usuários de apps específicos.
- No menu suspenso Apps específicos, selecione seu app ou site.

Depois, adicione esse Segment à sua mensagem e, se necessário, refine ainda mais seu público com outros Segments e filtros.
Campaigns
Para Campaigns, adicione seu Segment na etapa Públicos-alvo do criador.
Canvas
No Canvas, adicione seu Segment às etapas de Mensagem, na seção Validações de entrega. As validações de entrega confirmam se o seu público atende aos critérios de entrega no momento do envio da mensagem. Lembre-se de especificar validações de entrega para cada etapa de Mensagem, para garantir que ela seja entregue ao app correto. Não é necessário segmentar no nível de entrada.
Expanda para ver as etapas no fluxo de trabalho original do Canvas
No fluxo de trabalho original do Canvas, adicione seu Segment no nível do componente do Canvas, na seção Público. Não é necessário segmentar no nível de entrada.
Próximas etapas
Depois de criar seu espaço de trabalho, configure-o:
- Configurações do espaço de trabalho para configurar chaves de API, preferências de e-mail, configurações de push e muito mais.
- Gerenciar usuários da empresa para adicionar usuários e atribuir permissões para este espaço de trabalho.