---
title: "Por que os dados de cada workspace vivem em uma célula por país"
description: "O Qomni guarda os dados de um workspace no seu próprio país e põe um único ponto de entrada na frente. Que problema resolve e o que custou."
version: "pt-br"
---

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

# Por que os dados de cada workspace vivem em uma célula por país

A gravação de uma chamada na Colômbia, sua transcrição no Brasil e o
registro de um agente nos Estados Unidos têm regras legais distintas. As
três coisas vivem no Qomni. A pergunta de design foi onde guardá-las, e a
resposta define quase tudo o mais: uma **célula** por país.

## O problema

Um único banco de dados para o mundo todo é a opção mais simples de operar.
Obriga a escolher um país para os dados de todos os clientes e a explicar essa
escolha a cada um deles. Com gravações de voz e conversas com
clientes, essa explicação nem sempre convence.

A alternativa habitual é uma região por cliente, escolhida no cadastro.
Põe a decisão nas mãos de quem tem menos contexto. E a faz aparecer
em todo lugar: na URL da API, na configuração do cliente, em
cada SDK.

## O que fizemos

Cada workspace nasce em uma célula (`us1`, `co1` ou `br1`): uma cópia completa
da plataforma em uma região. Na frente de todas as células há um único ponto
de entrada, o **edge**, um Worker da Cloudflare que recebe cada requisição e
a leva à célula correta.

```mermaid
flowchart LR
  C[Seu servidor] -- "sk_agents_live_co1_…" --> E[Edge]
  E -- "token de 10 s" --> CO[(Célula co1)]
  E -.-> US[(Célula us1)]
  E -.-> BR[(Célula br1)]
```

A célula nunca aparece em uma URL. Vai dentro da chave de API
(`sk_agents_live_co1_…`), e o edge a lê dali sem consultar nada. Para o
app web, sai do workspace com o qual você entrou. Seu código é o mesmo para
um cliente em Bogotá e para um em São Paulo.

## O que custou

- **Uma origem não pode confiar em ninguém além do edge.** Por isso o edge
  assina cada requisição com um token Ed25519. Vale 10 segundos, serve para uma
  única requisição e fica ligado ao host, à célula e ao IP do cliente. Uma
  origem rejeita tudo o que não traga esse token, então ninguém consegue
  pular o edge chamando uma célula diretamente.
- **Uma chave só vale na sua célula.** Usá-la em outra responde
  `421 wrong_cell`. Na prática não acontece, porque a célula da chave é
  a do workspace que a criou, mas a regra existe para que um erro de
  configuração nunca cruze dados entre países.
- **Os dados não se movem.** Um workspace fica na sua célula. Mover um
  seria mover gravações de clientes de um país para outro, e preferimos não
  ter essa ferramenta a tê-la e usá-la mal.

## O que ganhamos

Cumprir as regras de cada país é uma propriedade da arquitetura, não um
processo. Uma requisição viaja menos. E um cliente nunca precisa escolher uma
região nem lembrar dela.

Se você quer ver o percurso completo de uma requisição, está em
[O edge e as células](/pt-br/concepts/edge/).

Source: https://docs.qomni.ai/pt-br/blog/una-celda-por-pais/index.mdx
