La grabación de una llamada en Colombia, su transcripción en Brasil y el registro de un agente en Estados Unidos tienen reglas legales distintas. Las tres cosas viven en Qomni. La pregunta de diseño fue dónde guardarlas, y la respuesta define casi todo lo demás: una celda por país.
El problema
Una sola base de datos para todo el mundo es la opción más simple de operar. Obliga a elegir un país para los datos de todos los clientes y a explicar esa elección a cada uno de ellos. Con grabaciones de voz y conversaciones con clientes, esa explicación no siempre convence.
La alternativa habitual es una región por cliente, elegida al registrarse. Pone la decisión en manos de quien menos contexto tiene. Y la hace aparecer en todas partes: en la URL de la API, en la configuración del cliente, en cada SDK.
Lo que hicimos
Cada workspace nace en una celda (us1, co1 o br1): una copia completa
de la plataforma en una región. Delante de todas las celdas hay un solo punto
de entrada, el edge, un Worker de Cloudflare que recibe cada petición y
la lleva a la celda correcta.
La celda nunca aparece en una URL. Va dentro de la clave de API
(sk_agents_live_co1_…), y el edge la lee de ahí sin consultar nada. Para la
app web, sale del workspace con el que entraste. Tu código es el mismo para
un cliente en Bogotá y para uno en São Paulo.
Lo que costó
- Un origen no puede confiar en nadie que no sea el edge. Por eso el edge firma cada petición con un token Ed25519. Vale 10 segundos, sirve para una sola petición y va ligado al host, a la celda y a la IP del cliente. Un origen rechaza todo lo que no traiga ese token, así que nadie puede saltarse el edge llamando a una celda directamente.
- Una clave sólo vale en su celda. Usarla en otra responde
421 wrong_cell. En la práctica no ocurre, porque la celda de la clave es la del workspace que la creó, pero la regla existe para que un error de configuración nunca cruce datos entre países. - Los datos no se mueven. Un workspace se queda en su celda. Mover uno sería mover grabaciones de clientes de un país a otro, y preferimos no tener esa herramienta antes que tenerla y usarla mal.
Lo que ganamos
Cumplir las reglas de cada país es una propiedad de la arquitectura, no un proceso. Una petición viaja menos. Y un cliente nunca tiene que elegir una región ni acordarse de ella.
Si quieres ver el recorrido completo de una petición, está en El edge y las celdas.
Recibe un aviso con cada artículo nuevo
Una nota de ingeniería cada vez que publicamos; nada más.