Español (Latinoamérica) Deutsch English (United States) Français 日本語 简体中文
search shadow

Menu

Artículos en esta sección

Portal para desarrolladores de Revizto Seguir

Avatar
Mallory McClure
  • Actualización

El portal para desarrolladores permite a los propietarios de la cuenta y a los administradores gestionar las integraciones de la API de Revizto. Puede añadir y gestionar aplicaciones OAuth para integraciones con la API de Revizto, activar aplicaciones preconfiguradas administradas por Revizto como Revizto MCP Server, controlar qué integraciones están disponibles para los miembros de la cuenta de la organización y gestionar correos electrónicos de notificación de la API.

El portal para desarrolladores usa OAuth 2.0, que permite a los usuarios autorizar una integración de terceros mediante un flujo estándar de inicio de sesión y aprobación de Revizto.

Las integraciones existentes basadas en códigos de acceso siguen siendo admitidas por compatibilidad con versiones anteriores. Las nuevas integraciones deben usar el portal para desarrolladores y el registro de aplicaciones OAuth.

Ver también:

Permisos requeridos

Los usuarios con el rol de propietario de la cuenta o de administrador de la cuenta pueden ver y gestionar aplicaciones desde el portal para desarrolladores. Puede ver su rol en la cuenta en la página Información de la cuenta/Gestionar información de la cuenta en Revizto Workspace. Consulte Roles de cuenta y licencia para obtener más información. 

Los usuarios estándar pueden ver las aplicaciones que están activas en la cuenta desde Integraciones de la aplicación; sin embargo, no pueden añadir aplicaciones, editar aplicaciones, ver secretos de cliente ni gestionar la configuración.

Los derechos de acceso del usuario de Revizto se aplican a la integración, lo que significa que esta solo puede acceder a los datos a los que el usuario de Revizto autorizado tiene permitido acceder.

Acceder al portal para desarrolladores

Los propietarios de la cuenta y los administradores pueden gestionar aplicaciones OAuth desde el Portal para desarrolladores en Revizto Workspace. Desde aquí, puede añadir y gestionar aplicaciones personalizadas, habilitar o deshabilitar aplicaciones preconfiguradas, gestionar correos electrónicos de notificación de la API y ver las integraciones disponibles.

Para acceder al portal para desarrolladores:

  1. Inicie sesión en ws.revizto.com.
    • Si es miembro de varias cuentas, asegúrese de seleccionar la cuenta correcta.

  2. Abra el menú desplegable Herramientas y seleccione Gestionar información de la cuenta. Si no ve Gestionar información de la cuenta, consulte Permisos requeridos. 

  1. Haga clic en Portal para desarrolladores.

Integraciones de la aplicación para usuarios estándar

Los usuarios estándar no tienen acceso al portal para desarrolladores, pero pueden ver las aplicaciones de su cuenta desde Integraciones de la aplicación en Revizto Workspace. 

Integraciones de la aplicación ofrece una vista general de lo disponible, lo que incluye:

  • Aplicaciones personalizadas activas.
  • Aplicaciones preconfiguradas activas.
  • Descripciones de las aplicaciones.

Si bien los usuarios estándar pueden ver información general de las aplicaciones en Integraciones de la aplicación, la información se limita únicamente a los datos básicos sobre lo que está disponible en la cuenta. No muestra detalles adicionales ni funciones administrativas, entre ellas:

  • Aplicaciones inactivas (personalizadas o preconfiguradas).
  • Los ID de cliente de las aplicaciones.
  • Los secretos de cliente de las aplicaciones.
  • Las URI de redireccionamiento de las aplicaciones.
  • Acciones de gestión de aplicaciones.

Si espera que una aplicación esté disponible y no la ve en Integraciones de aplicaciones, comuníquese con el propietario de la cuenta o el administrador.

Para acceder a Integraciones de la aplicación:

  1. Inicie sesión en ws.revizto.com.
    • Si es miembro de varias cuentas, asegúrese de seleccionar la cuenta correcta.

  2. Abra el menú desplegable Herramientas y seleccione Información de la cuenta.

  1. Haga clic en Integraciones de la aplicación.

Tipos de aplicaciones

En el portal para desarrolladores, hay dos tipos de aplicaciones: aplicaciones preconfiguradas y aplicaciones personalizadas. 

Aplicaciones preconfiguradas

Las aplicaciones preconfiguradas son administradas por Revizto o por asociados de Revizto y no necesitan ser añadidas por un propietario de la cuenta o un administrador. Los propietarios de la cuenta y los administradores no pueden ver ni editar el ID de cliente, el secreto de cliente ni las URI de redireccionamiento de una aplicación preconfigurada; solo pueden activar o desactivar la aplicación. Las aplicaciones preconfiguradas están desactivadas de forma predeterminada y deben activarse antes de que los miembros de la cuenta puedan usarlas. 

Entre las aplicaciones preconfiguradas se incluye Revizto MCP Server, que permite a los usuarios conectar sus cuentas de Revizto a una herramienta de IA de su elección. Para establecer una conexión con un asistente de IA, los propietarios de la cuenta o los administradores deben primero activar la aplicación Revizto MCP Server en el Portal para desarrolladores. Para obtener más información sobre cómo configurar el servidor Revizto MCP, consulte Conectar las herramientas de IA a Revizto MCP Server.

Aplicaciones personalizadas

Las aplicaciones personalizadas, por su parte, son aplicaciones añadidas a la cuenta por un propietario de la cuenta o un administrador. La aplicación personalizada se configura en el portal para desarrolladores y el propietario de la cuenta o los administradores deben gestionar los componentes necesarios para establecer la conexión entre Revizto y la integración de terceros. 

La configuración de aplicaciones personalizadas incluye los siguientes componentes: URI de redireccionamiento, un ID de cliente, un secreto de cliente y correos electrónicos de notificación de la API.

URI de redireccionamiento

Una URI de redireccionamiento es la dirección de retorno a la que Revizto envía al usuario después de que se apruebe o cancele la autorización de OAuth. La dirección la proporciona la integración del tercero y puede denominarse URL de retorno en la documentación de la integración.

Cada URI de redireccionamiento utilizado en la integración de terceros debe registrarse en el portal para desarrolladores. Al configurar una aplicación personalizada, Revizto valida las URI de redireccionamiento según los siguientes parámetros:

  • Hay al menos una URI de redireccionamiento. También se admiten varias URI de redireccionamiento. 
  • El protocolo, el dominio y la ruta coinciden exactamente. 
  • Las mayúsculas y minúsculas coinciden. 
  • Las URI de redireccionamiento de producción usan HTTPS (excepto para localhost).
  • El puerto debe coincidir para las URI que no sean de localhost (el puerto no se valida para localhost).
  • Cualquier barra final debe coincidir exactamente como parte de la URI.
  • las URI no contiene comodines.
  • Durante la autorización de OAuth, la URI de redireccionamiento utilizada en la integración de terceros coincide exactamente con una de las URI de redireccionamiento registradas para la aplicación en el Portal para desarrolladores.
  • No hay URI de redireccionamiento duplicadas en la misma aplicación personalizada. 

Por ejemplo:

  • https://app.example.com/oauth/revizto/callback
  • https://integrations.company.com/revizto/oauth/callback
  • http://localhost:3000/oauth/revizto/callback

Si la autorización falla debido a una discrepancia de la URI de redireccionamiento, verifique la configuración de la integración de terceros y las URI de redireccionamiento guardadas en la aplicación en el Portal para desarrolladores.

ID de cliente y secreto de cliente

Cuando se añade una aplicación personalizada, Revizto crea las credenciales de ID de cliente y de secreto de cliente, que actúan como credenciales de identidad para la integración de terceros.

  • ID de cliente: Visible y copiable en el Portal para desarrolladores. La integración de terceros lo usa para identificar la aplicación de OAuth. 
  • Secreto del cliente: Se muestra inmediatamente después de añadir una aplicación, o después de volver a generar el secreto de cliente. Después de cerrar el cuadro de diálogo de credenciales, el secreto de cliente no se puede volver a ver ni copiar. 

Después de recibir el secreto de cliente, asegúrese de guardarlo de inmediato de forma segura en la integración de terceros o en el administrador de secretos de su empresa.

Si se pierde el secreto de cliente, se puede volver a generar siguiendo los pasos de Volver a generar secretos de cliente. Después de la regeneración, el secreto de cliente anterior dejará de funcionar de inmediato y deberá actualizar la integración de terceros con el nuevo secreto de cliente.

Correos electrónicos de notificación de la API

Los correos electrónicos de notificación de la API en las aplicaciones personalizadas son los contactos técnicos de la aplicación y de su cuenta. Estos correos electrónicos pueden gestionarse al añadir o editar una aplicación personalizada. 

Revizto envía a estos correos electrónicos actualizaciones importantes relacionadas con la API, tales como:

  • Cambios en la API.
  • Avisos de obsolescencia.
  • Avisos de cambios incompatibles.
  • Actualizaciones del Portal para desarrolladores y de las integraciones con OAuth.

Siempre que sea posible, use un buzón compartido para que su organización siga recibiendo actualizaciones de la API independientemente de los cambios de personal. 

Activar y desactivar aplicaciones

Los propietarios de la cuenta y los administradores pueden activar y desactivar tanto las aplicaciones preconfiguradas como las personalizadas. El estado de la aplicación se aplica en toda la cuenta. Los usuarios estándar solo verán las aplicaciones activas en Integraciones de la aplicación.

Cuando una aplicación está desactivada, los miembros de la cuenta no podrán usar la integración de terceros para acceder a Revizto y se bloquearán todo el acceso existente y los nuevos intentos de autorización OAuth. Cuando se reactive una aplicación, es posible que los usuarios deban volver a autorizarla iniciando sesión nuevamente con su cuenta de usuario de Revizto.

Para activar o desactivar una aplicación:

  1. Vaya al Portal para desarrolladores en Revizto Workspace.
  2. Busque la aplicación que desea activar o desactivar.

  3. En la columna Activo de la aplicación, ponga el conmutador en encendido o apagado (azul indica activo).

  1. En el cuadro de diálogo de confirmación, haga clic en Activar o Desactivar para confirmar que desea proceder. 

    También puede activar o desactivar una aplicación personalizada usando el conmutador en la parte superior del panel de edición de la aplicación y siguiendo los mismos pasos de confirmación. 

La activación o desactivación se producirá de inmediato; sin embargo, los miembros de la cuenta pueden necesitar actualizar para ver el cambio.

Añadir aplicaciones personalizadas

Una aplicación personalizada es una aplicación OAuth añadida a una cuenta de organización. Las aplicaciones personalizadas pueden usarse para integraciones creadas por su organización, configuradas por su equipo de integración o configuradas por un sistema de terceros que necesita credenciales OAuth de su cuenta de Revizto.

Para añadir una aplicación personalizada:

Antes de añadir una aplicación personalizada, confirme que tiene las URI de redireccionamiento de la integración de terceros con la que conectará a Revizto.

  1. Vaya al Portal para desarrolladores en Revizto Workspace.

  2. Haga clic en + Añadir aplicación personalizada. 

  1. En el campo Nombre de la aplicación, ingrese el nombre de la aplicación.
  2. En el campo URI de redireccionamiento, ingrese una o más URI de redireccionamiento. Cada URI debe cumplir los parámetros descritos anteriormente en URI de redireccionamiento. 
  3. En el campo Descripción, ingrese una descripción de la aplicación si es necesario.
  4. En el campo Contactos de notificación de la API, ingrese los correos electrónicos de los usuarios que deban recibir comunicaciones relacionadas con la API de parte de Revizto, incluidos los cambios que afecten a sus integraciones.

  5. Haga clic en Añadir en la parte inferior del panel Añadir aplicación personalizada.

  1. En la ventana Credenciales de la aplicación, copie el ID de cliente y el Secreto del cliente. Después de cerrar la ventana, no podrá acceder nuevamente al secreto de cliente, así que asegúrese de guardar la información en un lugar seguro. 

  2. Haga clic en Aceptar. 

  1. Añada el ID de cliente y el secreto de cliente recién creados a la integración de terceros para completar la conexión.

Después de guardar la aplicación personalizada, se activará automáticamente y se guardará en Aplicaciones personalizadas. 

Editar aplicaciones personalizadas

Los propietarios de la cuenta y los administradores pueden editar el nombre, la descripción, las URI de redireccionamiento y los correos electrónicos de notificación de la API en las aplicaciones personalizadas. Se pueden editar tanto las aplicaciones personalizadas activas como las inactivas. Si necesita obtener un nuevo secreto de cliente, consulte Volver a generar secretos de cliente.

Para editar una aplicación personalizada:

  1. Vaya al Portal para desarrolladores en Revizto Workspace.
  2. Haga clic en la aplicación personalizada que desea editar.

  3. En el panel de edición de la aplicación, edite los campos que desea cambiar.

    Si cambia una URI de redireccionamiento, también debe actualizar la configuración de la integración de terceros; de lo contrario, los intentos de autorización de OAuth que usen la URI original fallarán.

  1. Haga clic en Actualizar en la parte inferior del panel de edición de la aplicación.

Eliminar aplicaciones personalizadas

Los propietarios de la cuenta y los administradores pueden eliminar aplicaciones personalizadas. Solo se pueden eliminar las aplicaciones inactivas. Eliminar una aplicación la elimina de forma permanente de las integraciones de aplicaciones disponibles en la cuenta.

Para eliminar una aplicación personalizada:

  1. Vaya al Portal para desarrolladores en Revizto Workspace.
  2. Desactive la aplicación personalizada que desea eliminar.
  3. En la columna Acciones de la aplicación, haga clic en Eliminar .
  4. En la ventana Eliminar aplicación, ingrese el nombre de la aplicación en el campo de confirmación exactamente como aparece en la ventana.

  5. Haga clic en Eliminar.

    También puede eliminar una aplicación personalizada inactiva haciendo clic en Eliminar en la parte superior del panel de edición de la aplicación y siguiendo los mismos pasos de confirmación. 

La aplicación se eliminará de inmediato y se revocará todo el acceso existente. Si desea volver a añadir la misma integración de terceros en el futuro, deberá añadir una nueva aplicación personalizada.

Volver a generar secretos de cliente

Si el secreto de cliente de una aplicación personalizada se pierde, se expone o necesita cambiarse, se puede volver a generar. Cuando se vuelve a generar un secreto de cliente:

  • El secreto de cliente anterior deja de funcionar de inmediato.
  • El nuevo secreto de cliente se muestra solo una vez.
  • Se debe actualizar la integración de terceros con el nuevo secreto de cliente para que siga funcionando.

Para volver a generar un secreto de cliente:

  1. Vaya al Portal para desarrolladores en Revizto Workspace.
  2. Busque la aplicación personalizada cuyo secreto de cliente desea volver a generar.
  3. En la columna Acciones de la aplicación, haga clic en Ver credenciales .

  4. En la ventana Credenciales de la aplicación, haga clic en Volver a generar secreto junto a Secreto de cliente.

  1. En la ventana de confirmación, haga clic en Volver a generar secreto nuevamente para confirmar que desea proceder. 
  2. En la ventana Credenciales de la aplicación, copie el nuevo Secreto de cliente. Después de cerrar la ventana, no podrá acceder nuevamente al secreto de cliente, así que asegúrese de guardar la información en un lugar seguro. 

  3. Haga clic en Aceptar.

  1. Añada el secreto de cliente recién creado a la integración de terceros para restablecer la conexión.

Resolución de problemas

P: No puedo añadir una aplicación personalizada.

R: Solo los propietarios de la cuenta y los administradores pueden añadir aplicaciones personalizadas. Pídale al propietario de la cuenta o al administrador que actualice su rol en la cuenta o que añada la aplicación por usted.


 

P: Perdí el secreto de cliente de una aplicación personalizada.

R: El secreto de cliente puede volver a generarse siguiendo los pasos de Volver a generar secretos de cliente. Una vez vuelto a generar, copie y guarde de inmediato el nuevo secreto de cliente en un lugar seguro y actualice la integración de terceros.


 

P: Los miembros de la cuenta no pueden autorizar su cuenta de Revizto en la integración de terceros.

R: Confirme lo siguiente:

  • El estado de la aplicación relacionada es Activo.
  • La integración de terceros usa el ID de cliente correcto.
  • La integración de terceros usa el secreto de cliente actual.
  • La URI de redireccionamiento en la integración de terceros coincide exactamente con una URI de redireccionamiento que figure en la información de la aplicación.
  • El usuario tiene acceso a la cuenta de Revizto.


 

P: Los miembros de la cuenta podían conectarse a una aplicación antes, pero ya no pueden.

R: Confirme lo siguiente:

  • El estado de la aplicación sigue siendo Activo.
  • La aplicación no fue eliminada.
  • El secreto de cliente no se volvió a generar sin actualizar la integración de terceros.


 

P: No veo la aplicación Revizto MCP Server en mis aplicaciones disponibles. 

R: La aplicación Revizto MCP Server es una aplicación preconfigurada y debe activarse para la cuenta. Pídale al propietario de la cuenta o al administrador que confirme que la aplicación Revizto MCP Server está activa en el Portal para desarrolladores.

Artículos relacionados