Saltar al contenido principal
Una parte importante de la integración del Business Plan o Launch Plan consiste en crear nuevas cuentas de perfil en Ayrshare para tus usuarios o clientes y permitirles vincular sus redes sociales mediante la página de vinculación social. Cada uno de tus usuarios se configura como un User Profile de Ayrshare. Un User Profile permite una conexión a cada red social.
Esta es la forma estándar de incorporar clientes. Tus usuarios conectan sus propias cuentas de redes sociales a través de la página de conexión con URL JWT de marca blanca que se describe abajo — nunca inician sesión en Ayrshare ni acceden a tu dashboard. El dashboard está reservado a tu equipo interno (creación y gestión de perfiles, pruebas y publicaciones en nombre de un cliente).

​
Flujo de integración

Para integrar Ayrshare en tu aplicación, tendrás que hacer dos llamadas a la API:
  1. Llamar al endpoint Create Profiles para crear un nuevo perfil de Ayrshare para tu usuario.
  2. Llamar al endpoint Generate JWT para obtener una URL con JWT.
La URL JWT permite a tu usuario acceder de forma segura a la página de vinculación social mediante autenticación por single sign-on. Mostrarás esta página en una nueva pestaña, ventana o view controller para que los usuarios conecten sus cuentas de redes sociales. Flujo de trabajo de conexión de perfiles de usuario Una vez que tu usuario vincule sus cuentas de redes sociales, podrás publicar, obtener analíticas y gestionar sus cuentas a través de la API.
Por motivos de seguridad, las plataformas de redes sociales requieren que los usuarios se autentiquen a través de su navegador, algo que no se puede hacer mediante llamadas desde un servidor backend. Esto garantiza que tus usuarios puedan conectar de forma segura sus cuentas de redes sociales iniciando sesión directamente en la página oficial de cada plataforma. Las redes sociales restringen la autenticación para que solo se realice a través de dominios de socios autorizados, como Ayrshare. También bloquean los iFrames, lo que significa que no puedes incrustar ni mostrar la página de vinculación de Ayrshare dentro de un iFrame en tu sitio.

​
Crear un User Profile de Ayrshare

​
Crear un perfil con la API

Cuando un nuevo usuario se registre en tu sistema o cuando tu cliente haga clic en el enlace de redes sociales de tu app, crea una nueva cuenta de perfil en Ayrshare llamando al endpoint RESTful /profiles/create-profile, o usando los paquetes de NPM o PyPi.

Perfiles

Esta llamada devuelve la PROFILE KEY de tu usuario. Esta clave se utilizará para publicar en nombre de tu usuario y gestionar su cuenta. Debes guardarla en un lugar seguro.

​
Crear un perfil desde el dashboard (equipo interno)

Tu equipo interno también puede crear User Profiles directamente desde el Developer Dashboard, algo útil para pruebas, incorporar un perfil manualmente o realizar tareas administrativas puntuales. Es una herramienta para tu equipo, no un flujo orientado al cliente: tus clientes nunca acceden al dashboard y se incorporan siempre a través de la página de conexión con URL JWT. Para la incorporación en producción, crea perfiles programáticamente con la API para que cada nuevo usuario se provisione automáticamente.

Gestiona los User Profiles en el dashboard

​
Paquete de integración

Durante tu proceso de incorporación como cliente del Business Plan o Launch Plan, recibiste un paquete de integración personalizado con información importante sobre la configuración y el dominio, ejemplos de llamadas a endpoints y más. Consúltalo con el titular principal de tu cuenta. También puedes obtener o restablecer el paquete de integración en el dashboard, en la página API. Asegúrate primero de cambiar a tu Primary Profile. Ayrshare Integration Package

​
Single Sign-On con autenticación JWT

Ayrshare usa un JWT (JSON Web Token) para autenticar a tu usuario y realizar Single Sign-On en la página de vinculación social. Un JWT es un mecanismo seguro para transmitir información firmada digitalmente y permite a Ayrshare autenticarte a ti y a tu usuario.

​
Generar un JWT

Tu app construirá un JWT compuesto por tu API Key, la Profile Key del usuario y algunos parámetros más. Se firmará con tu clave privada de 1024 bits.
El token JWT es válido durante 5 minutos. Consulta el Max Pack para ampliar el tiempo de expiración.
Utiliza el endpoint Generate JWT para que Ayrshare cree el token y la URL de vinculación social. Abre esa URL en una nueva pestaña o ventana, permitiendo a tus usuarios vincular sus redes sociales fácilmente.
La URL JWT es la vía de incorporación recomendada para todos los clientes. Tus usuarios se autentican directamente en cada red social por su cuenta — nunca recopilas ni almacenas sus credenciales. Si tu equipo necesita vincular una cuenta manualmente durante las pruebas, puede hacerlo desde el dashboard, pero se trata de una comodidad interna y no de la forma en que se deben incorporar los clientes.

​
Marca blanca en la página de conexión de cuentas

Dado que la página de conexión que se abre desde la URL JWT es la única interfaz de Ayrshare que verán tus usuarios, deberías personalizarla como si fuese tuya. Añade tu logotipo y cabeceras personalizadas, elige qué redes sociales aparecen, define el idioma de la página y usa tus propios enlaces de ayuda; y con el Max Pack, aplica un archivo CSS totalmente personalizado, favicon, título de página y pie de página. Estas opciones las configura tu equipo una sola vez desde el Primary Profile y se aplican a todas las URL JWT que generes.

Marca blanca en la página de conexión de cuentas

Consulta todas las opciones de branding y personalización de la página de conexión.

​
Cierre de sesión automático del perfil activo

Cómo cerrar sesión automáticamente del perfil activoSi un perfil ya ha iniciado sesión, enviar el JWT de otro perfil no cambia de perfil. Esto se hace para agilizar la experiencia de los usuarios que ya han iniciado sesión. Al probar, cierra sesión del perfil actual antes de hacer una llamada SSO con otro perfil. Los perfiles con sesión iniciada permanecen conectados hasta que se cierra sesión explícitamente.No obstante, si tienes una necesidad de negocio —por ejemplo, que tus usuarios tengan varios perfiles a los que acceden con frecuencia, o quieras hacer pruebas— incluye el siguiente parámetro en la URL de SSO:logout=truePor ejemplo:https://profile.ayrshare.com?domain=[domain id]&jwt=[jwt token]&logout=trueEsto fuerza el cierre de sesión y, a continuación, inicia sesión con el nuevo perfil.Consulta también el endpoint Generate JWT para añadir el logout automáticamente.Advertencia: usar el cierre de sesión automático provoca un retraso en el rendimiento para tu usuario, por lo que, salvo que lo necesites, recomendamos no forzar el logout y no usarlo en producción.

​
Apertura y cierre de la URL de vinculación social

La página Social Accounts tiene un botón “Close” que cierra la ventana y devuelve al usuario a tu sitio.

​
Apertura de la URL de vinculación social

Al abrir la URL de vinculación social, recomendamos usar la función window.open() de JavaScript en lugar de un anchor con href. El botón “Close” utiliza JavaScript para cerrar la ventana, y la mayoría de navegadores solo permiten cerrar ventanas que se hayan abierto a través de un script. Puedes usar el siguiente código de ejemplo en tu sitio web para lanzar la ventana de vinculación social.
Window Open
o bien
Window Open Function
Puedes controlar el botón “Close” para que redirija la pestaña de vinculación social a una página elegida por ti o para que redirija la pestaña/ventana original y cierre la pestaña de vinculación social. Esto se puede hacer con el parámetro redirect y añadiendo origin=true a los parámetros de consulta de la URL de redirección. Consulta el endpoint Generate JWT para más detalles.

​
Redirección al cerrar

Además, si quieres que el botón Close redirija a tu página (muy útil en móviles), pasa el parámetro GET redirect como una cadena URL-encoded que comience por https. Consulta los parámetros del endpoint Generate JWT para más detalles.
JWT URL
La redirección se guardará para ese perfil y se usará en llamadas SSO posteriores incluso si no se vuelve a enviar el parámetro redirect. Para restablecer el botón Close a su comportamiento de cierre, envía el parámetro redirect=null.

​
Más información

​
Notificaciones de vinculación o desvinculación de usuarios

Cuando un usuario vincula o desvincula una red social, puedes recibir una notificación mediante webhook. Consulta la página Social Action Webhooks para más información. También puedes usar el endpoint user para obtener las redes sociales conectadas de un User Profile.

​
Varios conjuntos de cuentas sociales

​
Descripción general

Cada User Profile tiene un conjunto de cuentas de redes sociales y puede establecer una conexión a cada red social. Si tus usuarios o clientes tienen varios conjuntos de cuentas de redes sociales, como dos páginas de Facebook, dos cuentas de Instagram y dos canales de YouTube, puedes gestionar esos varios conjuntos siguiendo estos pasos:
  1. Crear varios User Profiles - Crea User Profiles separados dentro del sistema de Ayrshare para cada conjunto de cuentas sociales que tu usuario o cliente necesite gestionar.
  2. Almacenar Profile Keys únicas - Cada User Profile tendrá su propia Profile Key única, devuelta por el endpoint de creación de User Profile.
  3. Etiquetar tus perfiles - Ponle un title o tag a cada User Profile para identificar con claridad con qué cuentas de redes sociales está asociado (por ejemplo, “Facebook Page A” y “Facebook Page B”).
  4. Mapear en tu base de datos - En tu propio sistema, asocia todas las Profile Keys relevantes con el usuario o cliente correspondiente.
  5. Usar la Profile Key adecuada - Al publicar contenido u obtener analíticas para una cuenta social concreta, usa la Profile Key asociada a esa cuenta. Por ejemplo, para publicar en Facebook Page A, usa la Profile Key del User Profile conectado a Facebook Page A.

​
Ejemplo

Veamos un escenario práctico con varias cuentas de cliente:
  • Cliente: cadena de restaurantes de Joe con dos ubicaciones
Joe necesita cuentas de redes sociales separadas para cada ubicación: Ubicación 1:
  • Página de Facebook: “Joe’s Downtown Bistro”
  • Instagram: @joesdowntownbistro
  • LinkedIn: página de empresa de Joe’s Downtown Bistro
Ubicación 2:
  • Página de Facebook: “Joe’s Seaside Grill”
  • Instagram: @joesseasidegrill
  • LinkedIn: página de empresa de Joe’s Seaside Grill
Solución de implementación:
  1. Crea dos User Profiles distintos en Ayrshare:
  • User Profile 1: titulado “Joe’s Downtown Bistro Accounts”
  • User Profile 2: titulado “Joe’s Seaside Grill Accounts”
  1. Conecta las cuentas sociales correspondientes a cada perfil:
  • Profile 1: vincula el Facebook, Instagram y LinkedIn de Downtown Bistro
  • Profile 2: vincula el Facebook, Instagram y LinkedIn de Seaside Grill
  1. Guarda ambas Profile Keys en tu base de datos, asociándolas a la cuenta de Joe:
  2. Al publicar una novedad de menú para Downtown, usa la Profile Key 1 en las llamadas a la API. Al publicar una promoción de marisco de Seaside, usa la Profile Key 2.
Creando varios User Profiles, titulándolos o etiquetándolos adecuadamente y asociándolos a un único usuario o cliente en tu sistema, puedes gestionar sus varias cuentas de redes sociales en las mismas plataformas usando Ayrshare. Este enfoque permite publicar y obtener analíticas de forma segmentada por cada cuenta específica.

​
Próximos pasos

Consulta aquí más detalles sobre la experiencia del usuario:

Integración del usuario

Una vez que tu usuario haya configurado los enlaces a sus redes sociales, podrás empezar a publicar en su nombre usando los endpoints /post y /profile.

API de Post

API de Profiles