Crews

Un crew es un equipo que gestiona varias páginas desde un solo sitio. Una suscripción las cubre todas, una lista de miembros decide quién está dentro, y un conjunto de roles decide qué puede tocar cada una de esas personas. Una agencia que lleva doce artistas, un sello con sus promotores, una oficina de contratación con un roster compartido: todos ellos son un crew que sostiene varias páginas, en vez de una docena de accesos separados.

Los crews son la única parte del administrador donde gestionas personas en lugar de contenido, así que esta página dedica la mayor parte de su extensión a Miembros, Roles y Pages.

Abre un crew

1. Abre Backstage.
2. Haz clic en la pestaña Crews.
3. Haz clic en el crew que quieras.

Cada tarjeta lleva el nombre del crew, una insignia de nivel, la dirección corta, cuántas plazas de página incluye el plan, y o bien Propietario o bien Miembro según lo que seas. Gestionar → te lleva dentro. Si no perteneces a ningún crew la pestaña dice Aún no hay crews, con Todavía no perteneces a ningún crew. debajo.

En el administrador no hay ningún botón que cree un crew. Un crew lo trae a la existencia la propia suscripción a Studio y aparece en esta pestaña una vez se formaliza el pago. Un crew cuya suscripción caduque después cae a Básico y conserva todo lo que tenía, pero deja de poder crecer.

Qué contiene la barra izquierda

Dos puertas deciden lo que puedes hacer

Cada pantalla de un crew está detrás de dos comprobaciones independientes, y las dos tienen que pasar.

Tu rol de crew. Un crew funciona de otra manera que una página. En una página los permisos se conceden por persona y por página, como se describe en Gestionar permisos. En un crew tienes exactamente un rol, y ese rol cubre el crew entero. Su lista de funciones es lo que lee la barra.

• El propietario del crew siempre tiene todas las funciones del crew. No hay forma de reducir al propietario, y nada en un rol puede conceder más de lo que el propietario ya tiene. Eso es lo que lee la barra. Una pantalla, Press kits, comprueba el rol del propietario en lugar de su propiedad y lo rechaza igualmente.
• Todos los demás tienen exactamente lo que lista su único rol. Nada se hereda, y nada se da por supuesto por antigüedad.
• Un miembro que no lleve ningún rol no tiene nada. La interfaz siempre pide un rol cuando añades a alguien, así que esto es raro, pero los datos lo permiten y unas cuantas pantallas lo manejan con menos elegancia que otras.

El plan del crew. Los planes de crew son Básico, Studio y Roster. La puerta de nivel acepta Studio o Roster y rechaza Basic. No hay nivel Starter para un crew, así que el nivel de entrada es Studio. Una fila está detrás de esa puerta, API, y lleva además un permiso propio. Tener el plan sin el permiso, o el permiso sin el plan, deja la fila en gris en cualquier caso. API se abre en cuanto se tienen los dos.

En gris, nunca oculta

Una fila que no puedes usar sigue visible y sigue en gris, así que siempre ves la forma de lo que un crew puede hacer incluso en las filas que tú personalmente no puedes abrir. Cuál de los dos grises es, te lo dice el ratón.

Una fila para la que te falta el plan recibe un destello en su borde derecho y el mensaje Pasa a Starter para desbloquear esta función. Esa cadena es la que usa todo el administrador, y nombra Starter incluso aquí, donde no existe tal plan de crew. En un crew, léela como Studio. El destello solo se dibuja mientras la barra está ancha.

Una fila para la que te falta un permiso no recibe destello ni explicación. Pasar el ratón por ella en la barra estrecha te repite el propio nombre de la fila, y en la barra ancha no produce ningún mensaje. Ese silencio es la señal: pregunta al propietario del crew, no a la pantalla de facturación.

Ninguno de los dos es el botón Mejorar de un crew Basic. Ese está en el bloque de estado del Panel, descrito más abajo, y abre Suscripción.

Poner en gris es navegación, no un cierre: una pantalla a la que llegas escribiendo la dirección se abre igualmente. Entonces dice lo que no puedes hacer en vez de dejar que lo intentes: un botón que necesita un permiso que te falta está desactivado, y al pasar por encima nombra el derecho que falta, por ejemplo Tu rol no te permite gestionar los miembros del crew. Un rechazo que aun así vuelve del servidor también se muestra como una frase, no como texto de base de datos.

Panel

Encabezado Panel del crew, sin botón junto al título. Está construido como el dashboard de un evento y no escribe nada.

Arriba, una tarjeta dice qué es el crew: su monograma, su nombre, una píldora con el plan y otra con su estado (Activo, Suspendido, En pausa o Pago pendiente), y después la dirección corta y Since con la fecha en que se creó. En una pantalla ancha la tarjeta muestra además Tu rol: Propietario, o el rol que tienes.

Debajo, cuatro cifras en una sola franja, cada una abre la pantalla que la explica:

La columna izquierda empieza con Próximos pasos: una fila por cada cosa que al crew todavía le falta, y solo las que puedes hacer tú. Vincula tu primera página, Suma a tu equipo, Pon a tu equipo en las páginas (páginas sin nadie asignado) y Crea tu propio rol. El botón de cada fila abre el control que lo resuelve, y el bloque desaparece cuando no queda nada. Debajo, Páginas lista las últimas páginas vinculadas, con su tipo y quién trabaja en ellas (Nadie asignado sale en ámbar), y Miembros las últimas personas en llegar, con su rol y su fecha de entrada.

La columna derecha es Navegación rápida: Miembros, Roles, Páginas, Drive, Ajustes y Suscripción como casillas.

Si el registro del crew no se puede leer, la página muestra Acceso denegado, con Volver a mis crews. Si lo que falla es la petición, muestra No se ha podido cargar este crew con Reintentar, en vez de fingir un crew vacío.

Cuando el crew necesita algo

Entre la tarjeta y las cifras aparece como mucho un bloque, el estado más urgente primero, cada uno con el botón que lo resuelve:

• Este crew está suspendido, con Tus páginas, miembros y accesos compartidos se conservan. Reactívalo para añadir páginas, invitar, compartir y gestionar miembros. El botón dice Reactivar crew, o Reanudar suscripción cuando el plan está pausado en vez de caducado. Mientras el crew está suspendido, Próximos pasos se oculta: cada paso se rechazaría con Este crew está suspendido. Reactívalo para continuar.
• El último pago ha fallado: el crew sigue funcionando mientras Stripe reintenta. Abrir facturación lleva a Suscripción.
• Este crew está en Basic: Mejorar abre Suscripción.
• Las {max} plazas de página están ocupadas: Abrir las páginas para liberar una: quita una página o revoca una invitación pendiente.

En el primero, la redacción es la parte importante. Una suspensión no elimina nada. Lo que se detiene es el crecimiento: vincular páginas, enviar invitaciones, compartir y gestionar miembros. Miembros, Roles y Páginas muestran el mismo bloque arriba mientras dura, y sus botones de añadir quedan desactivados.

Ajustes

Encabezado Ajustes del crew. La barra de pestañas contiene Ajustes, más Zona de peligro solo para el propietario.

La pestaña principal son dos tarjetas. Info del crew contiene Nombre del crew y Slug, con la línea Las páginas que invitas y a las que pides acceso ven este nombre. y la pista Solo minúsculas, números y guiones (mín. 3 caracteres) bajo la dirección corta. La tarjeta Suscripción es de solo lectura: el plan como una píldora, la fecha de Creado, y Gestionar el plan, que abre Suscripción.

Solo el propietario puede editar aquí. Un miembro con la función de ajustes puede abrir la pantalla y leerla, pero los dos campos están en gris y la tarjeta dice Solo el propietario del crew puede cambiar esto. Hay una función aparte de «editar ajustes» en el selector de permisos; esta pantalla no la consulta.

Renombra un crew o cambia su dirección corta

1. Abre Ajustes.
2. Edita Nombre del crew, hasta 100 caracteres.
3. Edita Slug: letras minúsculas, dígitos y guiones, de 3 a 50 caracteres, sin guion al principio ni al final. Una dirección corta que incumple la regla se marca bajo el campo mientras escribes, y una que ya usa otro crew se rechaza con Este slug ya lo usa otro crew.
4. En cuanto algo cambia, aparece abajo una barra con Tienes cambios sin guardar. Haz clic en Guardar, o en Descartar para recuperar los valores guardados. Ajustes del crew guardados lo confirma.

Pasar a Zona de peligro con cambios sin guardar pregunta antes ¿Salir sin guardar?, y cerrar o recargar la pestaña del navegador lanza el aviso del propio navegador.

Elimina un crew

1. Abre Ajustes y después la pestaña Zona de peligro.
2. Lee Eliminar este crew. El panel lista lo que se va con él, según lo que el crew tiene de verdad: sus páginas desvinculadas (siguen en Sway como páginas independientes, sin sus antiguas suscripciones), sus miembros que pierden su sitio, sus roles y asignaciones de páginas, y su suscripción de Stripe cuando la hay.
3. Haz clic en Eliminar crew.
4. Escribe el nombre exacto del crew, que el diálogo muestra como texto seleccionable. El botón se queda desactivado hasta que coincide, y No es el nombre exacto. dice por qué.
5. Haz clic en Eliminar crew.

Suscripción

La barra llama a esta fila Suscripción; la propia página se encabeza Suscripción y facturación. Está construida como la pantalla Suscripción de una página, descrita en Planes y facturación, y usa las palabras de Facturación. Todo lo que cambia el plan está detrás de la función de facturación del crew, que el propietario siempre tiene. Sin ella ves el plan, y una línea debajo dice Solo el propietario del crew, o un miembro cuyo rol gestiona la facturación, puede cambiar este plan.

En un crew Basic

La tarjeta del plan dice Básico y El crew conserva sus páginas, miembros y accesos compartidos, pero no puede añadir más hasta que vuelva a suscribirse. A su lado, la oferta de Studio enumera lo que está Incluido en Studio, te deja elegir Mensual o Anual con el precio debajo, y Suscribirse a Studio inicia el pago. Un crew que ya usó su prueba gratuita llega a un pago sin prueba.

En Studio o Roster

La tarjeta del plan nombra el nivel con su estado y lista seis líneas bajo Incluido en Studio (o Roster): páginas, miembros por página, almacenamiento, correo, notificaciones push y soporte. Lee ahí tus propias asignaciones en vez de en una tabla de otro sitio, ya que se mueven con el plan. Las fichas dan el Ciclo de facturación, la próxima fecha que importa, las Plazas de página como páginas en uso sobre plazas (solo Studio) y la barra Almacenamiento.

Cuando el plan te necesita, un bloque lo dice, con el botón que lo resuelve: El último pago ha fallado (Actualizar método de pago), Termina el … (Anular la cancelación), En pausa hasta el … (Reanudar ahora) o Pasa a facturación mensual el … (Mantener facturación anual). El menú de tres puntos contiene Pasar a facturación anual o Pasar a facturación mensual, Pausar la suscripción y Cancelar la suscripción, e Facturas y pago abre el portal de Stripe para facturas y métodos de pago.

Un crew Roster muestra Gestionado por tu account manager, con una línea que nombra al gestor cuando lo hay, y no tiene ni menú ni portal: todo cambio pasa por el gestor. En Studio, Pasar a Roster está junto a la tarjeta, y Consultar Roster abre el formulario de contacto, ya que Roster se presupuesta.

Cada acción se informa en la esquina de notificaciones, y la pantalla se actualiza en su sitio.

Plazas de página

Studio incluye seis plazas de página. Las plazas extra no están a la venta por ahora: cuando todas están ocupadas, quita una página o revoca una invitación pendiente para liberar una. Roster no tiene límite de plazas.

Miembros

Encabezado Miembros, con Añadir miembro arriba a la derecha.

Una franja de tres datos queda sobre la lista:

• Plazas: las personas del crew, sobre 20 en Studio (el propietario también cuenta), con un medidor que se vuelve ámbar cuando todas las plazas están ocupadas. Roster no tiene límite de plazas.
• Plan: el plan del que salen las plazas. Abre Suscripción.
• Roles: cuántos roles tiene el crew. Abre Roles.

Las columnas de la tabla son Miembro, Rol, Funciones, Se unió y Acciones, con la celda de funciones mostrando un recuento en vez de una lista. A partir de siete miembros aparecen encima un buscador (Busca un miembro o un rol…) y una píldora por cada rol que se tiene en el crew; Todos los roles quita el filtro. La pantalla Roles enlaza aquí con su rol ya elegido. En un teléfono, la tabla se convierte en una lista de personas con su rol y su fecha de entrada.

Dos filas no tienen ninguna acción, y dicen por qué: la del propietario (El propietario no se puede cambiar) y la tuya (No puedes cambiar tu propio rol).

Añade un miembro

1. Haz clic en Añadir miembro. Un panel se desliza desde la derecha.
2. Escribe en el buscador. Necesita dos caracteres y busca en todas las cuentas de Sway por nombre de usuario, no en una agenda propia, así que pide a la persona su nombre de usuario exacto. La gente que ya está en el crew no se ofrece.
3. Haz clic en la persona que quieras. El buscador se pliega sobre ella; Cambiar lo vuelve a abrir.
4. Elige una tarjeta de rol. Cada tarjeta nombra el rol, su recuento de funciones y las primeras áreas que cubre. El rol de propietario nunca se ofrece.
5. Haz clic en Añadir miembro. Miembro añadido lo confirma.

El botón se queda desactivado hasta que haya una persona y un rol elegidos, y el panel dice qué falta. Cuando todas las plazas están ocupadas, Añadir miembro está desactivado, y al pasar por encima se lee Todas las plazas de este plan están ocupadas. Mejora el plan o quita antes a alguien.

Cambia un rol, o quita a alguien

Cada fila lleva dos acciones, atenuadas hasta que apuntas a la fila.

• El lápiz abre Cambiar rol con las mismas tarjetas de rol. Guardar informa Rol del miembro actualizado, y las funciones del rol nuevo se aplican en todas partes a la vez.
• La papelera pregunta ¿Seguro que quieres quitar a {name} de este crew? y explica que la persona pierde todas las páginas a las que el crew le daba acceso. Quitar miembro lo confirma, y después Miembro quitado.

Quitar a alguien no toca los permisos que tenga sobre una página por derecho propio, que se concedieron en esa página y siguen vivos después de que se vaya.

Roles

Encabezado Roles, con Crear rol arriba a la derecha y una línea bajo el título: Cada miembro tiene un rol, y cubre todo el crew. Lo que puede hacer en una página depende de estar asignado a ella, en la pantalla Páginas.

Los roles se listan uno por fila: el nombre, un resumen que nombra las tres primeras áreas de funciones que toca seguido de un +N para el resto, y dos píldoras que cuentan los miembros que lo tienen y las funciones que lleva. La píldora de miembros abre Miembros filtrado por ese rol, y un clic en el nombre de un rol lo abre.

Los roles que vienen con el crew llevan una insignia Sistema. Sus funciones se pueden editar pero sus nombres no, y no se pueden eliminar. Abrir uno muestra El rol de sistema "{name}" no se puede renombrar, pero puedes editar sus funciones. El rol de propietario es todavía más estricto: se abre en solo lectura, como Ver rol.

Crea un rol

1. Haz clic en Crear rol. Un panel se desliza desde la derecha; arrastra su borde izquierdo para ensancharlo.
2. Escribe un Nombre del rol, hasta 50 caracteres. Un nombre que otro rol ya usa, o usaba antes de cambiarse, queda marcado: Otro rol del crew ya usa este nombre.
3. Bajo Partir de una plantilla, elige una tarjeta. En blanco (sin funciones) va primero, y después las formas de rol de serie, de menos acceso a más, cada una con su recuento de funciones. Elegir una marca sus funciones; cambiar cualquiera de ellas después convierte la selección en Personalizado.
4. Recorre Funciones. Están agrupadas por área, una línea por área con un recuento como 2/5; haz clic en un área para abrirla. Seleccionar todo y Borrar actúan sobre toda el área, y el buscador abre cada área que encuentra. Los permisos sensibles llevan un signo de aviso, en el permiso y en la línea de su área, y el total sobre la lista dice cuántos están marcados.
5. Haz clic en Crear rol.

Duplica, edita y elimina

El menú de tres puntos de cada fila contiene el resto.

Duplicar abre el panel de creación ya rellenado: las funciones del original, y su nombre seguido de (copia), o de (copy 2) cuando ese ya existe. Cámbiale el nombre, estréchalo y haz clic en Crear rol. Es la forma más rápida de construir una versión un poco más estrecha de un rol en el que ya confías.

Editar reabre el nombre y las funciones. Cuando hay personas con el rol, el panel lo dice antes que nada: miembros tienen este rol. Tus cambios se les aplican a todos en cuanto guardes.

Eliminar solo es posible mientras nadie tenga el rol. Si no, la entrada sale en gris con Lo tienen {n} miembros. Reasígnalos antes., y el menú ofrece Mostrar los {n} miembros en su lugar. Eliminar un rol sin usar pide una sola confirmación, y Eliminar rol la valida.

Las dos funciones de mensajería

Dos funciones de un rol tienen que ver con Mensajes. Responder mensajes pro permite a un miembro escribir a otras páginas en nombre del crew, leer las conversaciones del crew con ellas y responder por las páginas del roster que tiene asignadas. Moderar los canales del crew le permite eliminar cualquier mensaje en los canales del crew y renombrar o archivar cualquier canal. Los roles incluidos Propietario, Admin y Gestor llevan la primera, Propietario y Admin la segunda. Todo el crew lee y escribe en #general sin ninguna de las dos: consulta Canales del crew.

Pages

La pantalla de crew más grande, y la que merece leerse dos veces. Encabezado Páginas, con Añadir página arriba a la derecha en todas las pestañas salvo Events.

Una franja de tres datos queda sobre las pestañas:

• Plazas de página: las plazas usadas sobre el total del plan, con un medidor que se vuelve ámbar al llenarse.
• Plan: el plan del que salen las plazas. La casilla abre Suscripción.
• Compartidas con este crew: las páginas que concedieron acceso al crew sin entrar en él.

Siguen cuatro pestañas, Artistas, Salas, Promotores y Eventos, cada una con su recuento. Las páginas se muestran como tarjetas, igual que en Backstage. A partir de siete páginas en una pestaña, sobre las tarjetas aparecen un buscador (Busca una página por nombre…), un paginador y un recuento; la pestaña Events añade Todos, Próximos y Pasados.

La cuota

Dos cosas del recuento de plazas sorprenden a la gente:

• Los eventos nunca cuentan. Un evento llega al crew a través de su promotor, así que las páginas de evento se heredan en vez de vincularse. Aparecen en la pestaña Eventos con una insignia Heredada y el promotor del que vienen, su tarjeta abre el evento, y la pestaña no tiene botón Añadir página en absoluto. Desvincula el promotor para perder los eventos.
• Una invitación de propiedad pendiente ya cuesta una plaza. Una invitación que has enviado y que nadie ha contestado guarda su sitio hasta que se acepta, se rechaza, se revoca o caduca, y el medidor lo dice ( reservadas por invitaciones pendientes). Tres invitaciones olvidadas en un plan de seis plazas te dejan tres. Una solicitud de acceso nunca ocupa plaza.

Una vez las plazas están llenas, Añadir página se pone en gris y al pasar por encima se lee Todas las plazas de página están ocupadas. Quita antes una página.

Añade una página

1. Abre la pestaña de la clase de página que quieras y haz clic en Añadir página. Un panel se desliza desde la derecha.
2. Confirma la clase de página con las píldoras Tipo de entidad.
3. Escribe un nombre en el buscador. La pista enuncia su alcance: Busca cualquier página: añade las que gestionas, invita a las que gestiona otra persona o reclama una página sin gestor. Con la caja vacía solo ves las páginas que ya gestionas.
4. Haz clic en un resultado. El panel comprueba quién la lleva, mostrando Comprobando esta página..., y después dice en un solo bloque lo que ha encontrado.
5. Actúa según la respuesta. El botón del final del panel la sigue.

Para una solicitud de acceso, unas píldoras te dejan elegir exactamente qué pides: Ver bookings y Gestionar bookings. Una caja Mensaje (opcional) de hasta 500 caracteres viaja con una invitación o una solicitud.

En cualquier caso decide la administración de la propia página. Estás enviando una solicitud, no tomando nada.

Qué concede conectar una página al crew

Vincular una página la pone bajo el crew, pero no entrega a todos los miembros las llaves de ella. Pasan dos cosas.

La página hereda el plan del crew. Sus funciones, sus cuotas y su almacenamiento salen de la suscripción del crew a partir de ese momento, y por eso su propio plan de pago se cancela al entrar.

El acceso es por miembro y por página, y lo asignas tú. Un rol de crew dice qué puede hacer alguien sobre el crew. Lo que puede hacer en una página que gestiona el crew viene de estar asignado a esa página. Nadie recibe una página en la que no lo hayan puesto.

Cada tarjeta dice quién trabaja en la página ( asignados, o Nadie asignado en ámbar) y lleva un botón Equipo, que abre el equipo de la página en un panel.

1. Haz clic en Equipo en la tarjeta de la página.
2. Haz clic en Asignar miembro, o en la fila discontinua cuando todavía no hay nadie en la página.
3. Elige al miembro. Solo aparecen los miembros que aún no están en la página, y el propietario no se ofrece.
4. Deja Funciones personalizadas desactivado para darle lo que su rol de crew ya le concede. Su fila dice entonces Hereda el rol.
5. Actívalo para entregarle un conjunto distinto solo en esta página, elegido en la misma lista por áreas que los roles. La pista lo dice sin rodeos: Sustituye las funciones del rol del miembro solo para esta página. Su fila dice entonces Personalizado con un recuento.
6. Haz clic en Asignar miembro.

En la lista del equipo, el lápiz cambia esa elección después y la segunda acción le quita la página, tras Perderá el acceso a esta página. El menú de tres puntos de la tarjeta contiene Abrir página y Quitar del crew, que avisa de que todos los que el crew asignó a la página pierden ese acceso de inmediato y de que la página vuelve a su propio plan.

Como una anulación es por página, la misma persona puede ser gestora plena de un artista y un par de ojos de solo lectura en otro, sin tocar su rol de crew.

Compartidas con este crew

Las páginas que concedieron acceso a tu crew sin entrar en él se listan aparte, bajo Compartidas con este crew, con Solo acceso, nunca cuentan en tus plazas de página junto al encabezado. Cada fila muestra como píldoras los permisos que tienes allí.

El acceso compartido solo llega a las personas que asignas. Cada fila tiene su propio botón Equipo, el mismo panel de arriba: pon en él a las personas que trabajan en esa página. Lo que se les puede dar allí está limitado a lo que la página compartió.

Pedir más abre un panel para pedir permisos adicionales. Lo que ya te han concedido queda fijado y no se puede soltar desde aquí, la solicitud tiene que añadir al menos una cosa, y mientras hay una pendiente la fila dice Solicitado. Retirar una concesión existente es decisión de la administración de la página, no tuya.

Invitaciones de página

Todo lo que has enviado está bajo Invitaciones a páginas, con las columnas Página, Solicitud (Propiedad, Acceso o Más acceso), Estado, Enviada y Acciones, y una píldora de estado que dice Pendiente, Aceptada, Rechazada, Revocada o Caducada. Una invitación pendiente se puede retirar con la acción de su fila; Revocar invitación lo confirma, y una invitación de propiedad libera la plaza que ocupaba. En un teléfono, la tabla se convierte en una lista.

Press kits

Encabezada Press kits del roster. Aquí no se crea ni se edita nada: es un índice de los artistas vinculados al crew, una tarjeta por artista con Nuevo press kit, y cada acción apunta al espacio de trabajo del propio artista. Lo que lleva cada tarjeta se describe en Press kits.

Hoy se abre con un rechazo, para todo el mundo. La pantalla lee el rol de crew de quien la pidió y busca en él la gestión de los press kits del roster. El editor de Roles no ofrece ese permiso, así que ningún rol que puedas construir lo lleva, y ser dueño del crew no lo sustituye: el propietario es rechazado como todos, igual que un miembro sin ningún rol. La pantalla dice Tu rol no incluye los press kits del roster, con Abrir las páginas.

Pasada esa comprobación, la pantalla resuelve sus artistas a través de un enlace que la base de datos no tiene: un rol que llevara el permiso llegaría a No se han podido cargar los press kits del roster, y Reintentar no lo cambiaría.

Llega a un press kit a través del artista. Abre el artista desde Backstage y usa su propia pantalla Press kits, que es un editor completo y a la que no le afecta nada de esto. Construir y publicar uno se trata en Press kits.

La fila de la barra sigue el mismo permiso, así que solo el propietario del crew la ve en un estado en el que se pueda hacer clic siquiera. Para todos los demás está en gris, con el silencio al pasar el ratón descrito más arriba.

API

Encabezada API, con Docs de la API (abre la sección de API en una pestaña nueva) y un botón que sigue a la pestaña: Crear clave en las claves, Añadir webhook en los webhooks. Tres pestañas: Claves API, Solicitudes de booking, con una insignia del número de envíos todavía marcados como Nueva, y Webhooks.

Esta es una de las dos filas de crew que están detrás de la puerta de plan además de una función, y la única de ellas que se abre. En un crew Basic muestra el panel de mejora; con el plan pero sin la función de API muestra Acceso denegado, nombrando el permiso que hay que pedir al propietario del crew.

Claves API

Claves API lista cada clave con su nombre, el principio y el final de la clave, sus permisos, cuándo se creó, cuándo se usó por última vez y cuándo caduca, sus peticiones en 30 días y su estado: Activa, Caduca pronto, Suspendida, Caducada o Revocada. Una clave de navegador lleva una insignia Navegador, y una clave que sustituyó a otra lo dice bajo su nombre (Sustituye a sway_sk_..., Sustituida por sway_sk_...). A partir de siete claves aparecen encima de la lista un buscador y las píldoras Todas, Activas y Caducadas o revocadas. En un teléfono cada clave se convierte en una fila con su nombre, su estado y su último uso.

Cada clave tiene Actividad. Una clave que no está revocada tiene además Editar permisos y Revocar, y Suspender (Reanudar una vez suspendida) hasta que caduca. Las acciones quedan atenuadas hasta que apuntas a su fila.

Crea una clave

1. Haz clic en Crear clave. Un panel se desliza desde la derecha.
2. Dale un Nombre, según dónde se ejecuta.
3. Elige un Tipo de clave. Secreta es para tu servidor y puede llevar cualquier permiso. Publicable es para el navegador de un visitante: solo lista las lecturas públicas, y pide los Sitios web en los que se puede usar, una dirección completa por línea.
4. Marca sus Permisos, agrupados en Lectura, Escritura y Acceso, cada uno con una línea que dice qué abre. Las lecturas públicas vienen marcadas de entrada. Los permisos que dan datos personales o entradas gratis (read:ambassador-members, write:checkout:free) los concede solo el propietario del crew: para cualquier otra persona están bloqueados, con Solo el propietario del crew puede conceder este permiso.
5. Si marcas un permiso de embajadores, rellena Direcciones de la tienda, una por línea. Una clave con uno de esos permisos y sin dirección nunca podrá volver a iniciar la sesión de un miembro, y el panel lo dice. Las direcciones que el servidor rechazaría se marcan antes de guardar.
6. Elige una Caducidad: No caduca, 30 días, 90 días o 365 días.
7. Haz clic en Crear clave.

La clave aparece entonces una sola vez, en su propio diálogo, con un botón de copiar. El diálogo no se puede cerrar con un clic fuera ni con Escape: copia la clave, guárdala, y haz clic en He guardado la clave. No se vuelve a mostrar nunca.

Suspende, edita, revoca

Suspender es el interruptor de emergencia para una clave que sospechas: pregunta antes, y desde entonces toda petición hecha con la clave responde 403 key_suspended. No se elimina nada, y Reanudar devuelve la clave a como estaba.

Editar permisos reabre la misma lista para una clave existente, direcciones incluidas, y el cambio se aplica a esa clave al instante.

Revocar pregunta antes, dice que toda petición hecha con la clave responderá 401 desde entonces, y Revocar clave lo confirma. No hay deshacer: crea la sustituta antes de revocar una clave de la que depende un sitio. Cuando la clave se rotó a través de la API, la confirmación ofrece También revocar las claves que la sustituyeron: actívalo cuando la clave se haya filtrado, ya que quien la tuviera podría haberla rotado y quedarse con la nueva.

Actividad

Actividad abre un panel sobre una clave. Ahora mismo muestra el trabajo gastado este minuto y hoy, las peticiones de este minuto y los datos enviados hoy, cada uno contra su límite. El trabajo es lo que gastan las peticiones sin caché: las repeticiones y las respuestas 304 no cuestan nada. Cuando la clave ha quedado limitada a respuestas en caché tras un patrón inusual de peticiones, el panel lo dice. Últimas llamadas lista sus llamadas de los últimos siete días: hora, petición, estado, si respondió la caché, la dirección que llamó y la duración.

Solicitudes de booking

Solicitudes de booking muestra cada envío como una tarjeta con los artistas, la fecha del evento, la sala, el caché ofrecido, la organización y el contacto. Lo que el remitente no indicó dice No indicado. A partir de siete solicitudes aparecen encima de la lista un buscador y las píldoras Todas, Nueva, Revisada y Archivada.

Webhooks

Webhooks lista las direcciones a las que llama Sway cuando pasa algo en las páginas del crew: un pedido pagado o reembolsado, un evento publicado o cambiado, una solicitud de booking, una venta de embajador, una respuesta de formulario, un pago. Cada webhook muestra su dirección, su descripción, los eventos que escucha y su estado: Activo, Fallando (con la hora en que empezaron los fallos), En pausa o Desactivado (tras tres días de llamadas fallidas, con la forma de volver). Un webhook que envía datos personales lleva una insignia Datos personales; uno cuyo secreto acaba de cambiar dice hasta cuándo sigue funcionando el secreto anterior. Un crew puede tener diez.

Cada webhook tiene Envíos, Enviar un evento de prueba (mientras está activo), Pausar (o Activar), Editar, Nuevo secreto de firma y Eliminar.

Para añadir uno:

1. Haz clic en Añadir webhook. Un panel se desliza desde la derecha.
2. Introduce la URL del endpoint: una dirección https pública en tu servidor. El panel marca cualquier otra cosa antes de guardar.
3. Añade una Descripción si quieres, y marca los Eventos, cada uno con una línea que dice cuándo se envía; los que pueden nombrar a una persona lo dicen.
4. Deja Incluir datos personales desactivado salvo que el servidor necesite nombres y direcciones de email. Solo el propietario del crew puede activarlo; cualquiera que gestione la API puede desactivarlo.
5. Haz clic en Añadir webhook.

El secreto de firma aparece entonces una vez, en su propio diálogo, como una clave nueva: cópialo en la configuración de tu servidor y haz clic en He guardado el secreto. Nuevo secreto de firma hace lo mismo para un webhook existente, tras una confirmación, y el secreto anterior sigue firmando 24 horas para que el servidor pueda cambiar sin perder ninguna llamada.

Envíos abre las últimas llamadas del webhook: la hora, el evento, el estado (En espera, Enviando, Entregado, Fallido, No enviado, con el próximo intento para una llamada que se reintentará), el número de intentos y la respuesta, en palabras para los fallos que puedes arreglar (Sin respuesta en 10 segundos, Dirección no encontrada, Problema de certificado...). Reenviar envía una vez más una llamada terminada. Eliminar pregunta antes y borra el webhook con su secreto y su historial.

Cómo recibe y comprueba las llamadas tu servidor está documentado en Webhooks; las claves, sus permisos y todo lo que puedes llamar con ellas en la sección de API.

Dónde vive el resto