Ajustes de equipo en Digital Samba: guía de la Developer API
Tu equipo de Digital Samba es el nivel de cuenta donde viven tu subdominio, tus credenciales de API, los miembros de tu equipo y los ajustes por defecto que hereda cada sala nueva. Puedes gestionarlo todo desde el dashboard, y la mayor parte también a través de la API REST – algo muy útil cuando la configuración del equipo pasa a formar parte de tu flujo de despliegue en lugar de ser una tarea puntual.
Índice de contenidos
- ¿Cómo empezar?
- ¿Cómo añadir miembros a tu equipo?
- ¿Cómo asignar roles de equipo?
- Cómo configurar los ajustes de sala por defecto
- Preguntas frecuentes
En esta guía veremos paso a paso cómo configurar un equipo, autenticarte en la API REST de Digital Samba, añadir miembros, asignar roles de equipo y configurar los ajustes de sala por defecto – con peticiones que funcionan tal cual y puedes copiar directamente en tu terminal.
¿Cómo empezar?
En Digital Samba, un equipo es el grupo de personas que construye y gestiona la integración de Digital Samba Embedded en tu web o aplicación. Normalmente son desarrolladores, más cualquier persona que necesite crear salas, gestionar grabaciones o configurar ajustes a nivel avanzado.
Cada equipo tiene exactamente un owner, y puede tener tantos admins y members como necesites. Parte de la configuración se hace en el dashboard y el resto puede hacerse por API – aquí cubrimos ambas vías.
Contacta con nuestro equipo hoy mismo
Configura los ajustes de tu equipo con la API para desarrolladores de Digital Samba
¿Cómo se crea un equipo?
No creas el equipo como un paso aparte: se crea automáticamente en el momento en que te registras en Digital Samba, y tú te conviertes en su owner. Durante el registro se te pedirá que elijas un subdominio, que funciona como identificador único de tu equipo – piensa en él como el nombre de tu equipo.

Digital Samba usa tu subdominio para construir el dominio personalizado que aparece en cada enlace que compartes con los participantes de tus reuniones. Si eliges 'lecture-room' como subdominio, tus salas estarán en https://lecture-room.digitalsamba.com/room. Como owner del equipo, puedes editar el subdominio más adelante desde la sección Team del dashboard – solo recuerda que los enlaces de sala que ya hayas compartido dejarán de funcionar.
Cómo autenticar las peticiones a la API REST
Cada petición a la API REST de Digital Samba se autentica con dos valores: tu team ID y tu developer key. Ambos se generan al registrarte, y puedes encontrarlos en cualquier momento en la sección Team de tu dashboard.

La API acepta tanto autenticación HTTP Basic como token Bearer. En ambos casos, la credencial es tu team ID y tu developer key unidos por dos puntos y codificados en Base64:
Authorization: Bearer base64(teamId:developerKey) Authorization: Basic base64(teamId:developerKey)
La forma más sencilla de probarlo es con cURL, que se encarga de la codificación cuando usas --user. Para ver tus ajustes de equipo en acción, crea una sala con una petición POST al endpoint /rooms. El único campo obligatorio es privacy, que acepta 'public' o 'private' – si omites friendly_url, la API genera una automáticamente:
curl --request POST \
--header "Content-Type: application/json" \
--url https://api.digitalsamba.com/api/v1/rooms \
--user YOUR_TEAM_ID:YOUR_DEVELOPER_KEY \
--data '{"privacy": "public", "friendly_url": "my-standup"}'
La sala nueva hereda los ajustes de sala por defecto de tu equipo – los vemos un poco más abajo. Tu equipo incluye además tres roles de sala predefinidos (moderator, speaker y attendee); si añades más de un rol a una sala, también debes definir un default_role.
IMPORTANTE: No expongas nunca tu developer key en código frontend ni la compartas con terceros. Trátala como una contraseña. La clave no caduca nunca, pero si sospechas que se ha filtrado, puedes regenerarla en cualquier momento haciendo clic en el icono de regenerar junto al campo de la developer key en la sección Team – después tendrás que autenticarte con la clave nueva.
¿Cómo añadir miembros a tu equipo?
Para añadir miembros, abre la sección 'Team' del dashboard y haz clic en el botón 'Add members'. Pueden hacerlo tanto los owners como los admins del equipo.

El dashboard genera un enlace de invitación que puedes copiar y enviar a tus futuros compañeros. El enlace lleva a la página de registro de Digital Samba, donde los invitados se registran con el rol de member, el básico – si necesitan más acceso, puedes ascenderlos después.
Mientras esperas a que todos se unan, no necesitas crear una sala desde cero para experimentar: tu cuenta incluye una sala de demostración con la que probar tus ajustes de equipo de inmediato.

¿Cómo asignar roles de equipo?
Cada persona aparece en la sección 'Team members' con su dirección de correo, su rol y su fecha de incorporación. El rol de owner se asigna automáticamente a quien creó el equipo.

Roles de equipo y permisos
Digital Samba ofrece tres roles de equipo: owner, admin y member.
- El owner del equipo se crea automáticamente al formar un equipo nuevo, y solo puede haber uno por equipo. Su perfil está vinculado a la facturación, así que es responsable de gestionar la cuenta, mantener al día los datos de facturación y gestionar las subidas de plan. Los admins no pueden eliminarlo. La propiedad no se puede transferir desde el dashboard – si necesitas traspasar un equipo, contacta con el soporte.
- Los admins tienen el mismo nivel de acceso que el owner, salvo que no pueden gestionar la facturación ni eliminar al owner. Pueden añadir y eliminar miembros, asignar roles de equipo y configurar los ajustes de sala por defecto.
- Los members pueden hacer todo lo demás – crear salas, configurar roles, montar webhooks, gestionar grabaciones, analizar sesiones y consultar estadísticas de uso –, pero no pueden añadir ni eliminar miembros, asignar roles de equipo ni cambiar los ajustes de sala por defecto.
Un equipo puede tener un número ilimitado de admins y members, pero solo un owner. Tienes el desglose completo en nuestra documentación.
Un matiz que conviene tener claro: los roles de equipo no son lo mismo que los roles de sala. Los roles de equipo controlan lo que alguien puede hacer en el dashboard y a través de la API, mientras que los roles de sala – moderator, speaker, attendee y los roles personalizados que definas – controlan lo que los participantes pueden hacer dentro de una videollamada.
También puedes controlar qué roles de equipo pueden abrir grabaciones y descargar transcripciones y archivos. El owner siempre tiene acceso, mientras que el acceso de admins y members es personalizable – útil cuando las grabaciones contienen material que no todo el equipo debería ver.
¿Cómo ascender, degradar o eliminar miembros del equipo?
Para cambiar el rol de alguien, haz clic en el icono de tres puntos junto a su entrada en la sección Team.

Desde ahí puedes ascender a un member a admin con 'Promote', devolver a un admin a member con 'Demote' o sacar a alguien del equipo con 'Remove'. No hace falta más para gestionar la estructura de tu equipo en el día a día.
Cómo configurar los ajustes de sala por defecto
Los ajustes de sala por defecto son la plantilla con la que arranca cada sala nueva. Configúralos una vez y cada sala que crees – por API o desde el dashboard – heredará tu marca, tu idioma y las funciones que hayas elegido, manteniendo una experiencia consistente sin repetir la misma configuración en cada sala.
Merece la pena conocer la regla de herencia con precisión: las salas nuevas heredan los valores por defecto, y las existentes también, pero cualquier ajuste que hayas personalizado en una sala concreta nunca se sobrescribe. Si pones el color primario de una sala en rojo y luego cambias el valor por defecto a azul, esa sala seguirá siendo roja.
Puedes editar los valores por defecto en el dashboard – el botón 'Default room settings' está en la sección Rooms, como explicamos en nuestra guía para configurar los ajustes de sala por defecto desde el dashboard – o por API, como mostramos a continuación.
Cómo ver tus propiedades de sala por defecto actuales
Antes de cambiar nada, conviene ver qué hay configurado. Envía una petición GET al endpoint raíz:
curl --request GET \ --url https://api.digitalsamba.com/api/v1 \ --user YOUR_TEAM_ID:YOUR_DEVELOPER_KEY
La respuesta lista las propiedades de sala por defecto actuales de tu equipo. Aquí tienes un ejemplo recortado con el tipo de campos que recibirás – colores de marca, posición de la barra de herramientas, idioma de la interfaz y funciones activadas, junto con tu consumo del periodo actual:
{
"id": "c4fa4435-1381-4fd4-8bef-38a25da7eee1",
"domain": "myTeamNameHere",
"topbar_enabled": true,
"toolbar_enabled": true,
"toolbar_position": "bottom",
"toolbar_color": "#000000",
"primary_color": "#3771E0",
"background_color": "#000000",
"palette_mode": "light",
"language": "en",
"audio_on_join_enabled": true,
"video_on_join_enabled": true,
"screenshare_enabled": true,
"participants_list_enabled": true,
"chat_enabled": true,
"e2ee_enabled": false,
"join_screen_enabled": true,
"logo_enabled": false,
"recordings_enabled": true,
"virtual_backgrounds_enabled": true,
"raise_hand_enabled": true,
"used_participation_minutes": 570
}
Cómo configurar los ajustes de sala por defecto con la Developer API de Digital Samba
Para cambiar los valores por defecto, envía una petición PATCH al mismo endpoint raíz, incluyendo solo los campos que quieras modificar.
Supón que quieres una identidad de marca uniforme en todas tus videoconferencias: la barra de herramientas a la derecha en el azul de tu marca, un azul claro como color primario sobre fondo blanco, el chat activado, tu logo visible e inglés como idioma de la interfaz. Quedaría así:
curl --request PATCH \
--header "Content-Type: application/json" \
--url https://api.digitalsamba.com/api/v1 \
--user YOUR_TEAM_ID:YOUR_DEVELOPER_KEY \
--data '{
"toolbar_position": "right",
"toolbar_color": "#0000FF",
"primary_color": "#ADD8E6",
"background_color": "#FFFFFF",
"language": "en",
"chat_enabled": true,
"logo_enabled": true
}'
Puedes actualizar tantos campos como quieras en una sola petición, y la respuesta confirma el cambio. Si en algún momento quieres empezar de cero, el botón 'Reset to factory settings' del dashboard restaura los valores originales. Consulta nuestra documentación para ver la lista completa de campos configurables.
Con el equipo configurado y los valores por defecto alineados con tu marca, cada sala que crees estará lista para los participantes desde el primer momento – y como todo está disponible por API, puedes integrar la configuración del equipo en tu propio flujo de aprovisionamiento. Si quieres que tu backend reaccione a lo que ocurre en esas salas, el siguiente paso es configurar webhooks.
Empieza hoy con una cuenta gratuita y 10.000 minutos de participación al mes en videollamadas con calidad HD.
Preguntas frecuentes
¿Dónde encuentro mi developer key y mi team ID?
Ambos están en la sección Team de tu dashboard de Digital Samba y se generan al registrarte. Los usas juntos para autenticar cada petición a la API REST, como credencial Basic o como token Bearer.
¿Qué hago si mi developer key se filtra?
Regenérala desde la sección Team del dashboard haciendo clic en el icono de regenerar junto al campo de la developer key. La clave antigua deja de funcionar de inmediato, así que actualiza tu integración para autenticarte con la nueva.
¿Puedo cambiar el subdominio de mi equipo después de registrarme?
Sí. Como owner del equipo, puedes editar el subdominio en la sección Team del dashboard. Ten en cuenta que tus enlaces de sala incluyen el subdominio, así que los enlaces compartidos antes del cambio dejarán de funcionar.
¿Cuántos owners, admins y members puede tener un equipo?
Un equipo tiene siempre exactamente un owner y puede tener un número ilimitado de admins y members. La propiedad no se puede cambiar desde el dashboard – contacta con el soporte de Digital Samba si necesitas transferirla.
¿Qué diferencia hay entre roles de equipo y roles de sala?
Los roles de equipo (owner, admin, member) controlan lo que alguien puede hacer en el dashboard y a través de la API. Los roles de sala (moderator, speaker, attendee y roles personalizados) controlan lo que los participantes pueden hacer dentro de una videollamada, como compartir pantalla o silenciar a otros.
¿Cambiar los ajustes de sala por defecto afecta a mis salas existentes?
Las salas existentes heredan los nuevos valores por defecto, pero los ajustes que personalizaste en una sala concreta nunca se sobrescriben. Solo los valores que la sala todavía hereda adoptarán los nuevos ajustes.
Share this
You May Also Like
These Related Stories

Cómo configurar tus Digital Samba Rooms utilizando la API para desarrolladores y el SDK

Configura los ajustes por defecto de tus salas en Digital Samba

