Incorporar cuentas sociales de clientes

Usa el MCP Server para incorporar las cuentas sociales de tus clientes bajo sub-perfiles con una URL de vinculación social JWT.

Los integradores con un plan Business o Enterprise pueden incorporar las cuentas sociales de sus clientes bajo sub-perfiles. Usando el MCP Server, un agente crea un sub-perfil, lo apunta y genera una URL de vinculación con single sign-on que el cliente abre para conectar sus cuentas.

​

Flujo

1. Crea un sub-perfil

   Llama a create_profile (a nivel de cuenta — sin profileKey). Devuelve una profile key para el nuevo sub-perfil.

2. Apunta al sub-perfil

   Usa la profile key devuelta en las llamadas siguientes — ya sea con la cabecera Profile-Key en la conexión o como un argumento profileKey por llamada. Consulta Conexión y configuración para la precedencia.

3. Genera una URL de vinculación social

   Llama a generate_jwt_social_linking_url para generar una URL de vinculación con single sign-on. La clave de firma del JWT y el dominio de onboarding se derivan del lado del servidor — el llamador no proporciona cabeceras X-Ayrshare-* ni clave privada ni dominio.

4. El cliente vincula sus cuentas

   El cliente abre la URL y autoriza (OAuth) sus cuentas sociales. Las cuentas conectadas quedan vinculadas al sub-perfil.

​

Requisitos

generate_jwt_social_linking_url requiere un profileKey. Si no se resuelve ninguno, la llamada devuelve 400 con el mensaje “Profile Key is required…”.

Debe estar provisionado un dominio de vinculación social para tu cuenta. Esto está disponible en los planes Business y Enterprise.

​

Estados de error

Condición	Respuesta
Sin dominio provisionado	400 — “No social-linking domain is provisioned for this account (available on Business/Enterprise plans).”
Sin clave de firma	400 — “No signing key found for this account’s social-linking domain.”

​

Próximos pasos

Conexión y configuración

Autenticación y direccionamiento de perfiles.

Catálogo de herramientas

Las 27 herramientas agrupadas por dominio, con alcance y propósito.