Modyo Docs

# Configuración de reino

En la sección de Configuración de reino, puedes personalizar la interacción entre los usuarios y la plataforma de Modyo.

Aquí puedes modificar tanto la experiencia visual del usuario como la configuración relacionada con el registro, control de acceso y personalización. Es importante tener precaución al realizar modificaciones en esta sección, ya que puedes afectar el correcto funcionamiento de la plataforma.

# General

En esta sección puedes configurar aspectos generales del reino, como:

  • Título
  • Identificador: La URL de las vistas de perfil, inicio de sesión, registro y recuperación de contraseña del reino.
  • Deshabilitar credenciales: Al marcar esta casilla, desactivas las credenciales de Modyo en el reino y permites únicamente el acceso a través de SSO.

Peligro

Antes de habilitar la opción de deshabilitar las credenciales de Modyo en el reino, asegúrate de tener configurado un proveedor de identidad SSO para el reino. De lo contrario, los usuarios no podrán iniciar sesión.

  • Después de iniciar sesión, redirigir a: Te permite elegir una URL específica a la cual dirigir al usuario, una vez que haya ingresado al reino. Si no activas la opción de "Forzar redirección", el usuario será redirigido a la URL ingresada solo si no es posible volver a la URL desde la que inició sesión.
  • Forzar la redirección a: Al activar esta opción, el usuario siempre será redirigido a la URL especificada en el campo de redirección del inicio de sesión, sin importar desde dónde inició la sesión.
  • Activación de la cuenta:
    • Directa: Los usuarios que se registren pueden iniciar sesión directamente.
    • E-mail de activación: Los usuarios que se registren deben activar su cuenta mediante un enlace enviado a su correo electrónico previo a poder iniciar sesión.
    • Moderada: Los usuarios que se registren deberán esperar a que un administrador del reino active su cuenta para poder iniciar sesión.
    • Deshabilitada: No se pueden registrar nuevos usuarios en el reino. Los usuarios ya registrados y activados aún pueden iniciar sesión.
  • Imagen de Avatar por defecto: Imagen que se muestra en el avatar de los usuarios que no tienen una imagen personalizada.
  • Habilitar Soft login: Activando esta opción puedes acceder a tu cuenta sin introducir tus credenciales cada vez. Recibirás un código de seguridad en tu email para ingresar fácilmente sin necesidad de contraseñas.
  • Formulario de registro: Aquí puedes habilitar o deshabilitar diferentes atributos en el formulario de registro, como el segundo apellido, confirmación de correo electrónico, avatar de usuario, fecha de nacimiento, género y número de teléfono.
  • Eliminar reino: Elimina el reino. Este proceso se realiza en segundo plano y es posible que no veas el reino desaparecer inmediatamente después de ejecutar la acción. Para confirmar la eliminación, debes ingresar el nombre completo del reino.

# Redireccionar Login

En Modyo puedes personalizar la página de login a la que acceden tus usuarios una vez que ingresen a tu sitio.

Para redireccionar el login sigue estos pasos:

  1. Haz click en Canales en el menú lateral.
  2. Selecciona Sitios.
  3. Elige el sitio en él que deseas trabajar.
  4. En el menú lateral, haz click en Plantillas.
  5. En la plantilla header busca la línea que contiene la información de login.
  6. Redirecciona a la página deseada utilizando este código: login?redirect_to=/tu-pagina donde "/tu-pagina" es la URL de la página a la que deseas redirigir el login.
  7. Haz click en Guardar.
  8. Haz click en Publicar.

Tip

Modyo está programado para que la información de login esté en el encabezado del sitio. Si tu sitio está programado de manera diferente, utiliza el ícono de lupa para encontrar el término login en tus plantillas.

Atención

La dirección de login tiene que ser una página dentro de tu misma cuenta. No puedes redireccionar el login a una URL externa.

# Apariencia

En esta sección, puedes personalizar la apariencia del reino.

# Color primario

El color primario es el que se muestra en los principales botones relacionados con la sesión, como el ingreso, registro, modificaciones de contraseña y otros atributos. Para modificarlo, ingresa el código HEX del color deseado y haz click en el botón Guardar ubicado en la parte superior de la pantalla.

# Mostrar el logo de la cuenta

Da click en el botón subir para cargar un logo personalizado. El logo se desplegará sobre los formularios respectivos de estas vistas.

# CSS personalizado

Para usar una hoja de estilos CSS personalizada en las vistas de sesión, sigue estos pasos:

  1. Copia el código CSS que deseas utilizar.
  2. Abre el editor que se encuentra en la ventana.
  3. Pega el código CSS en el editor.
  4. Haz clic en el botón Guardar para guardar los cambios.

Haz click en el ícono de Gestor de Archivos para subir archivos vinculados en el código CSS.

Es importante tener en cuenta que el editor no genera automáticamente el enlace del archivo después de subirlo. Después de cargar el archivo, haz click en el botón de pegado que se encuentra en el lateral de cada archivo para generar su enlace. Luego, copia este enlace y pégalo en el código CSS.

Tip

Si tienes problemas con los códigos de teclado al editar el CSS, haz click en el ícono de teclado sobre el editor para desplegar atajos de teclado que facilitarán la edición.

# Correos

Modyo te permite configurar la dirección de envío y la apariencia de los correos que envías a los usuarios del reino.

Para ajustar la dirección del remitente que envía tu correo, ingresa la dirección en el campo "Correo por defecto" y haz click en el botón Guardar.

Aquí puedes también habilitar, deshabilitar y personalizar el envío de los correos automáticos en respuesta a acciones específicas realizadas por los usuarios. Para habilitar o deshabilitar el envío de un correo, haz click en el botón Habilitado/Deshabilitado junto a cada función y da click en el botón Guardar.

En caso de activarlas, se envía un correo cuando:

  • Correo de Activación: Un usuario ha completado su registro, para que confirme sus datos.
  • Correo de Bienvenida: Un usuario se ha registrado en un sitio específico.
  • Agregado por el Admin: Un administrador crea un usuario manualmente.
  • Recuperación de Contraseña: Un usuario solicita recuperar su contraseña.
  • Esperando Confirmación: El usuario ha sido confirmado, pero requiere activación manual por parte de un administrador.
  • Confirmación: El usuario ha sido confirmado y activado.
  • Verificación de actualizaciones de correo: Se ha llevado a cabo un cambio en la dirección de correo.

Footer personalizado: Permite personalizar el pie de página de todos los correos mencionados anteriormente.

Para habilitar o deshabilitar el envío de un correo, haz click en el botón Habilitado/Deshabilitado junto a cada función y da click en el botón Guardar.

# Personalizar correos

Puedes también introducir códigos personalizables en cada correo, estos códigos permiten que la plataforma incluya la información del usuario en el campo designado, al momento del envío.

Peligro

Es fundamental que cada correo incluya los códigos personalizables que permiten que la plataforma incluya la data aleatoria del usuario que solicita el envío.

Para ello, inserta en el código los atributos que están debajo del editor y pégalo en la parte correspondiente del código.

Cada vez que hagas un cambio en el código, debes hacer click en el botón Guardar ubicado en la parte superior de la pantalla.

# Proveedores de identidad

Para facilitar el acceso a la plataforma, puedes configurar el inicio de sesión y el registro a través de servicios estándar.

Los servicios compatibles con el ingreso a Modyo son:

  • Google
  • SAML
  • Oauth2
  • OpenID Connect
  • Keycloak
  • Azure Active Directory

Debes contar con la correcta configuración del servicio asociado para que Modyo pueda conectarse con él. Asegúrate de completar todos los campos requeridos.

Para más información sobre las integraciones consulta la sección de Proveedores de Identidad

# Integraciones

Modyo permite integrar con otros servicios y aplicaciones.

# Zendesk

Para integrar con Zendesk necesitas:

  • Nombre de la integración
  • Shared secret de Zendesk
  • URL de la integración: e.g. mysubdomain.zendesk.com

# Salesforce

Una integración de Salesforce con Modyo te permite vincular tus usuarios de Modyo con tus contactos de Salesforce.

Para llevar a cabo esta integración debes:

  1. Habilitar el uso de la API de Salesforce en Modyo. Esto te permite crear, actualizar o borrar contactos de Salesforce directamente desde Modyo.
  2. Habilitar la API de Modyo en Salesforce. De esta manera, puedes crear, actualizar o borrar usuarios de Modyo desde Salesforce.

# Habilitar el uso de la API de Salesforce en Modyo.

Para habilitar el uso de la API de Salesforce en Modyo, primero debes crear un Connected App en Salesforce. Sigue esta guía para obtener información detallada sobre cómo crear un Connected App y obtener las credenciales necesarias para utilizar la API de Salesforce desde una aplicación externa.

En Salesforce debes obtener:

  • Consumer Key Haz click en el botón Copy debajo de la llave en Salesforce para copiarla.
  • Private Key Para encontrar este texto en Salseforce, da click en el botón Seleccionar archivo en el documento en formato .crt y copia el texto. El texto debe verse así:
-----BEGIN PRIVATE KEY-----

MIIEvwIBADANBgkqhkiG9w0BAQEFAASCBKkwggSlAgEAAoIBAQC9ZT/LC/DtmxCm
......
......
S/nw7vM0Lsv3Ri3BURATfMXx+Q==

-----END PRIVATE KEY-----
  • Correo electrónico de un usuario con acceso al Connected App Confirma en Salesforce si un usuario tiene acceso al Connected App en Setup > User > Profile.

Una vez que hayas obtenido esta información en Salesforce, accede a Modyo y realiza estos pasos:

  1. Ingresa al reino que deseas vincular.
  2. Accede a la configuración del reino.
  3. Haz click en Integraciones.
  4. Haz click en + Add y selecciona la integración de Salesforce.
  5. Ingresa un nombre para la integración. Puede ser cualquier texto de al menos 3 caracteres de largo.
  6. En el campo Sujeto, utiliza el correo electrónico de un usuario que tienen acceso al Connected App en Salesforce.
  7. En Issuer ingresa tu Consumer Key.
  8. En el campo Private Key ingresa, en formato texto, el certificado usado al crear el Connected App.

Tip

Si las credenciales que ingresaste no son válidas, el sistema te alertará y te solicitará que las ingreses nuevamente.

Una vez que hayas ingresado correctamente las credenciales, puedes seleccionar los campos que deseas sincronizar entre usuarios y contactos.

La integración con Modyo requiere sincronizar tres campos obligatorios con sus equivalentes correspondientes de Salesforce:

  • Email
  • First name
  • Last name

Puedes además vincular otros campos. Toma en consideración que:

  • Los campos de Modyo se muestran a la izquierda y los campos de Salesforce a la derecha.
  • Los campos deben coincidir en tipo (texto, fecha, número, etc.) para poder ser vinculados. Si existe alguna discrepancia en el tipo de dato entre los campos de Modyo y Salesforce, se muestra una alerta en la interfaz para informarte de la incompatibilidad.
  • No puedes vincular un campo más de una vez.
  • Si un campo no ha sido vinculado, no se realizará ninguna sincronización para ese campo específico.
  • Puedes vincular campos personalizados o custom de Modyo. Para ello, primero debes crear el campo custom en Modyo y el campo tiene que estar habilitado para ser utilizado en la sincronización.

Una vez que hayas vinculado los campos, selecciona el tipo de sincronización:

  • Siempre usar Salesforce: Esta opción usa los datos desde Salesforce para actualizar (crear, actualizar, borrar) los usuarios de Modyo. En este caso, no se envía información de usuario de Modyo a Salesforce. La sincronización es unidireccional, y la información fluye únicamente desde Salesforce hacia Modyo.
  • Siempre usar Modyo: Al seleccionar esta opción se envían datos de usuarios de Modyo a Salesforce para actualizar contactos en Salesforce. No se actualizan usuarios de Modyo con información de Salesforce. La sincronización es unidireccional y la información fluye únicamente desde Modyo hacia Salesforce.
  • Bidireccional: Esta opción envía información de Modyo a Salesforce y se usa información de Salesforce en Modyo, lo que permite actualizar contactos y usuarios respectivamente. En este caso, los usuarios y contactos se mantienen actualizados con la información más reciente disponible.
  • No sincronizar: Al seleccionar esta opción, desactivas la integración, evitando que se sincronicen usuarios y contactos entre Modyo y Salesforce. Esta opción puede ser útil si necesitas pausar la sincronización por alguna razón.

Attention

Si seleccionas la modalidad de vinculación Siempre usar Modyo o bidireccional, pero no completas el segundo paso que se explica a continuación, los usuarios de Modyo no se enviarán a Salesforce.

Para completar el segundo punto y habilitar el uso de la API de Modyo desde las clases Apex de Salesforce, sigue esta guía (opens new window).

Una vez que hayas completado los dos pasos, al hacer un cambio a un usuario de Modyo la modificación se ve reflejada en Salesforce y lo mismo de Salesforce a Modyo, según la configuración de vinculación seleccionada.

Para asegurar la correcta sincronización de datos entre Modyo y Salesforce y mantener la integridad y consistencia de la información entre ambas plataformas existen las siguentes especificaciones:

  • Se permite utilizar un único "issuer" por cuenta, lo que significa que entre reinos no se pueden repetir.
  • Actualización de contacto en Salesforce:
    • Si la configuración de vinculación lo permite, al actualizar un contacto en Salesforce, Modyo busca el usuario correspondiente utilizando el campo "secondary_user_id".
    • Si el usuario de Modyo no existe, se crea uno nuevo, y si ya existe, se actualiza según los campos sincronizados.
    • Si el usuario de Modyo no existía previamente, su "secondary_user_id" se define como el ID del contacto de Salesforce.
  • Actualización de usuario en Modyo:
    • Al actualizar un usuario de Modyo, se busca al contacto correspondiente en Salesforce utilizando su "ID de contacto".
    • Si el usuario de Modyo es nuevo o no tiene "secondary_user_id", se crea un nuevo contacto en Salesforce y se actualiza el campo "secondary_user_id" con el ID del contacto recién creado.
  • Creación de contacto en Salesforce:
    • Un contacto en Salesforce solo requiere del campo "Last Name" para ser creado.
    • Cuando se crea un contacto solo con "Last Name", en Modyo se completarán el "username" y el "first name" con placeholders o marcadores de posición que indican que fueron creados producto de la vinculación.
  • Creación de usuario en Modyo:
    • Un usuario de Modyo se puede crear sin "Last Name", pero este campo, al ser requerido en Salesforce, se envia con un placeholder que indica que fue creado a partir del proceso de vinculación.
  • Los tipos primitivos de campos de Salesforce disponibles para vincular, son:
    • Boolean
    • Date
    • Datetime
    • Decimal
    • Double
    • ID
    • Integer
    • Long
    • Object
    • String
  • Los campos no incluidos en la lista, por ejemplo, referencias o campos compuestos, están deshabilitados en la vista de vinculación de campos. Esto indica que no están disponibles para vinculación.

# Habilitar la API de Modyo en Salesforce.

Para llevar a cabo este proceso, revisa la guía de desarrollador de Connect REST API de Salesforce (opens new window)

Importante

En caso de no llevar a cabo este segundo paso, la información y cambios que lleves a cabo en Salesforce no los verás reflejados en Modyo.

# Cliente OAuth

Utiliza un cliente de autenticación para enviar los tokens de acceso de tu integración a tus recursos; necesitas los siguientes valores:

  • Nombre
  • URI de redirección: el URI al que el servidor de autenticación redirigirá al usuario después de una autenticación exitosa.
  • URI de cierre de sesión: URI al que el servidor de autenticación redirigirá al usuario después de cerrar la sesión.
  • Descripción
  • Confidencial: Existen dos tipos de clientes OAuth, confidencial o públicos. Selecciona la opción confidencial si tu aplicación puede autenticarse de manera segura con el servidor de autenticación. Los clientes públicos suelen ser aplicaciones que se ejecutan en dispositivos móviles o navegadores.
  • Scopes: Si tu servicio de autenticación OAuth2 usa múltiples espacios o ambientes para separar a los usuarios y quieres usar uno en específico en esta integración, defínelo en este campo.

# Miembros del equipo

Modyo permite seleccionar los miembros del equipo que trabajan en cada reino y así controlar el acceso a los distintos aspectos del reino.

Para añadir un miembro al reino, sigue estos pasos:

  1. Haz click en el botón + Agregar miembro en la parte superior derecha.
  2. En el modal, selecciona a un usuario y asigna un rol.
  3. Haz click en Agregar.

Para modificar el rol de un miembro del equipo:

  1. Haz click en el nombre del usuario en el modal.
  2. Asigna el rol deseado al usuario.
  3. Da click en Actualizar.

Puedes elegir entre dos roles:

  • Realm User: Puede añadir usuarios, crear, modificar y enviar a revisión campañas, formularios y segmentos.
  • Realm Admin: Tiene acceso a todas las configuraciones y secciones del reino, puede añadir y eliminar usuarios y miembros del equipo. Puede también eliminar el reino.

Para eliminar a un administrador del reino, selecciona la casilla a la izquierda de su nombre y haz click en el botón Borrar en la parte inferior.

# Custom fields

En esta sección, puedes crear campos personalizados para distinguir el perfil del usuario. Es importante que estos campos estén correctamente identificados para su mejor uso.

Los tipos de campos personalizados que puedes agregar son:

  • Casilla
  • Fecha
  • Lista Desplegable
  • Párrafo
  • Número
  • Elección
  • Texto simple

Puedes reorganizar los campos personalizados arrastrándolos. Recuerda que el orden en el que los ordenes será el mismo en el que aparecerán en las vistas de edición y en el perfil de los usuarios.

Tip

Puedes crear un máximo de 20 campos personalizados en cada reino.

Los campos personalizados tienen propiedades estándar que debes tener en cuenta:

  • Debe ser una respuesta única: El valor debe ser único para cada usuario, evitando duplicados.
  • Este es un campo requerido: Debe completarse al modificar o crear un usuario. Si el campo es visible y editable para los usuarios, se mostrará en el formulario de registro y será obligatorio para crear nuevos usuarios.
  • Visible para los usuarios de los sitios: Será visible en el perfil del usuario.
    • Editable por usuarios de los sitios: Los usuarios podrán ver y modificar el valor.
  • Buscable por administradores: El valor estará indexado y los administradores podrán realizar búsquedas de usuarios en el índice de usuarios del administrador de Modyo, por el valor de este campo.
  • Texto de sugerencia: Proporciona un ejemplo o guía para el campo.
  • Valor por defecto.

Los campos personalizables pueden estar habilitados o deshabilitados. Si están habilitados, un administrador puede usarlos y, dependiendo de su configuración, pueden también estar disponibles para los usuarios.

Cuando un campo personalizable está deshabilitado, no aparece en ningún formulario, sin embargo, sus valores se mantienen guardados.

Peligro

Cuando un campo personalizable está deshabilitado, puede ser eliminado.

Al eliminar un campo personalizable, eliminas permanentemente todos los valores de usuarios asociados a ese campo.

Tip

Además de guardar valores específicos de los usuarios, puedes utilizar los valores de los campos personalizables para crear filtros de segmentos lo que te permite separar a los usuarios según sus valores personalizados.

# Seguridad

# Política de Contraseña

Las opciones disponibles para establecer una política de contraseña en la plataforma Modyo, son:

  • Valor mínimo de longitud de contraseña: Establece el número mínimo de caracteres que una contraseña debe tener, entre 12 y 128 caracteres.
  • Requerir por lo menos una letra minúscula (a - z)
  • Requerir por lo menos una letra mayúscula (A - Z)
  • Requerir por lo menos un caracter no alfanumérico (! @ # $ % ^ & * () _ + - = [] {} |)

# reCAPTCHA

Puedes habilitar o no reCAPTCHA en el reino, una vez habilitado ingresa:

  • Clave de sitio
  • Secreto
  • Umbral

# Configuración de payment

Al habilitar la función de pago en tu reino, tienes acceso a las siguientes opciones:

  • Formato de moneda: Modifica el tipo de puntuación usado.
  • Configuración de pago: Selecciona la unidad monetaria que deseas mostrar. Esta unidad se refleja en las órdenes y reportes. Si no indicas una unidad monetaria, Modyo utiliza la moneda predeterminada según el idioma configurado para el sitio.
  • Activar el envío de correo electrónico: Cuando esta opción está seleccionada, el usuario recibe un correo al pagar una orden.
  • Asunto del correo: Encabezado del correo enviado a los usuarios.
  • Cuerpo del correo: Contenido del mensaje enviado a los usuarios.

← Perfil de usuario →