Espacio de trabajo
Tu espacio de trabajo es la unidad de trabajo en Bird. Contiene tus dominios, claves API, envíos y acceso de equipo. El panel está organizado por espacio de trabajo, y cada acción ocurre dentro de tu espacio de trabajo. Tu cuenta está vinculada a una sola región y contiene tu información de facturación.
Regiones
Tu cuenta está fijada a exactamente una región, actualmente us1 (Estados Unidos) o eu1 (Unión Europea). La región se elige al registrarte y no se puede cambiar: tus datos e infraestructura de envío residen ahí, y el tráfico API se dirige al host de esa región, https://us1.platform.bird.com o https://eu1.platform.bird.com. La región está incorporada en cada prefijo de clave API (bk_us1_...), de modo que las solicitudes se enrutan solas. Consulta URLs base y regiones para las reglas de enrutamiento y lo que ocurre con una solicitud que llega a la región incorrecta.
Cómo una solicitud encuentra tu espacio de trabajo
La API de Bird usa rutas planas (/v1/email/messages, /v1/sms/messages) sin segmento de espacio de trabajo en la ruta. La credencial lleva el contexto: una clave API está vinculada a tu espacio de trabajo, lo que fija también su organización y región, así que una solicitud no necesita nada más que la propia clave. Una solicitud que indica un contexto en contradicción con su clave se rechaza como mal formada (400) en lugar de reinterpretarse silenciosamente.
Si la solicitud está permitida es una cuestión aparte, resuelta por los alcances de clave para claves API y por los roles para las personas que trabajan en el panel.
Cerrar una cuenta
Cerrar tu cuenta es permanente y deliberadamente difícil de hacer por accidente. El cierre de cuenta lo inicia el propietario desde la configuración de la cuenta y genera un correo de confirmación. Hasta que confirmes siguiendo el enlace que Bird te envía, nada cambia.
Una vez confirmado:
- El bloqueo es inmediato. Tu cuenta desaparece del panel, sus claves API dejan de autenticar y se revocan, el envío se detiene y cualquier suscripción activa se cancela.
- Sigue una ventana de gracia de 7 días. Los datos, la configuración y las membresías de equipo se conservan intactos. El correo de cierre incluye un enlace de cancelación; si lo sigues dentro de la ventana, se restaura el acceso. Todo vuelve excepto las claves API, que fueron revocadas en el bloqueo y deben volver a emitirse.
- Después, la purga es irreversible. Pasada la ventana, la limpieza se ejecuta y recupera todo: dominios, supresiones, endpoints de webhook, plantillas, membresías, datos. Nada se puede recuperar una vez que la purga comienza.
Próximos pasos
- Autenticación y claves API: cómo las claves se vinculan a un espacio de trabajo
- Usuarios, equipos y roles: roles del espacio de trabajo y control de acceso, incluidos los roles a nivel de cuenta para facturación
- URLs base y regiones: hosts regionales y enrutamiento
Recursos relacionados
Continúa con la documentación, guías y ejemplos sobre este tema. Los recursos están en inglés.