Enlaces de conexión
Crea un enlace para que un cliente conecte sus cuentas sociales a tu espacio de trabajo sin iniciar sesión en AdaptlyPost, y revócalo cuando termines.
Permiso: accounts.manage. Consulta Roles y permisos.
Solo una clave de Administrador tiene accounts.manage, así que solo las claves de Administrador pueden crear o revocar enlaces de conexión.
Un enlace de conexión abre una página donde alguien sin cuenta de AdaptlyPost conecta sus cuentas sociales a tu espacio de trabajo. Envía la url a un cliente, este aprueba cada plataforma y las cuentas aparecen en Social Accounts como cualquier otra.
POST /api/v1/connect-links
Todos los campos son opcionales. Sin cuerpo obtienes un enlace rápido: ofrece todas las plataformas, muestra al cliente todas las cuentas del espacio de trabajo, conecta cualquier número de cuentas y deja de funcionar a los 7 días.
| Campo | Tipo | Descripción |
|---|---|---|
name | string, hasta 80 caracteres | Etiqueta en la lista de enlaces del panel. Solo la ve tu equipo |
visibility | PUBLIC o PRIVATE | PRIVATE muestra al cliente solo las cuentas que conectó con este enlace. Por defecto PUBLIC |
allowedPlatforms | array de tipos de plataforma | Plataformas que el cliente puede elegir. Omítelo o envía [] para todas |
maxAccounts | entero, 1 o más | El enlace deja de funcionar cuando se conectan tantas cuentas con él. Volver a conectar una cuenta que ya conectó no cuenta otra vez |
expiresAt | fecha y hora ISO 8601 con Z o un desfase | Cuándo deja de funcionar el enlace. Entre 1 hora y 365 días a partir de ahora. Por defecto, dentro de 7 días |
neverExpires | booleano | true mantiene el enlace activo hasta que lo revoques. No lo envíes junto con expiresAt |
returnUrl | URL https, hasta 2048 caracteres | Adónde va el cliente después de conectar, elegir páginas o canales o recibir un rechazo, para que vuelva a tu app. Debe ser https (http solo para localhost) y no llevar usuario ni contraseña. Tus propios parámetros de consulta se conservan |
Petición de ejemplo:
{
"name": "Acme onboarding",
"visibility": "PRIVATE",
"allowedPlatforms": ["INSTAGRAM", "TIKTOK"],
"maxAccounts": 3,
"expiresAt": "2026-11-30T18:00:00Z",
"returnUrl": "https://app.example.com/social/connected?client=42"
}Devuelve 201:
{
"url": "https://adaptlypost.com/connect/9f2c4e71b0d8...",
"token": "9f2c4e71b0d8...",
"expiresAt": "2026-11-30T18:00:00.000Z",
"name": "Acme onboarding",
"visibility": "PRIVATE",
"allowedPlatforms": ["INSTAGRAM", "TIKTOK"],
"maxAccounts": 3,
"returnUrl": "https://app.example.com/social/connected?client=42",
"startUrls": [
{ "platform": "INSTAGRAM", "url": "https://auth.adaptlypost.com/auth/connect/9f2c4e71b0d8.../INSTAGRAM/start" },
{ "platform": "TIKTOK", "url": "https://auth.adaptlypost.com/auth/connect/9f2c4e71b0d8.../TIKTOK/start" }
]
}| Campo | Descripción |
|---|---|
url | La página que envías. Quien la tenga puede conectar cuentas a este espacio de trabajo mientras el enlace funcione |
token | Identifica el enlace. Guárdalo para revocarlo más tarde |
expiresAt | Cuándo deja de funcionar el enlace, o null si no caduca nunca |
name, visibility, allowedPlatforms, maxAccounts | La configuración con la que se creó el enlace. name y maxAccounts son null si no se indicaron |
returnUrl | La returnUrl con la que se creó el enlace, o null |
startUrls | Un { platform, url } por cada plataforma ofrecida que conecta a través de la pantalla de consentimiento de la propia red. Bluesky y Telegram no aparecen porque se conectan en la página del enlace. Añade server a la URL de Mastodon, site a la de WordPress y via=facebook a la de Instagram para conectar Instagram a través de su página de Facebook |
Un expiresAt fuera del rango, o expiresAt junto con neverExpires, devuelve 400 con un mensaje que indica el motivo. Una returnUrl que no es https, o que lleva usuario o contraseña, también devuelve 400.
Un enlace también deja de funcionar en cuanto se revoca, cuando ya conectó maxAccounts cuentas, o cuando el miembro que lo creó ya no puede gestionar cuentas en el espacio de trabajo.
Tus propios botones de conexión
Envía returnUrl y pon cada entrada de startUrls detrás de un botón en tu app. El botón lleva al cliente directamente a la pantalla de consentimiento de la red, sin pasar por la página del enlace. Después de conectar, elegir páginas o canales o recibir un rechazo, el cliente llega a returnUrl con estos parámetros de consulta añadidos:
| Parámetro | Descripción |
|---|---|
status | connected o error |
platform | El tipo de plataforma, cuando se conoce |
accountId | Uno por cada cuenta que añadió la conexión, el mismo id que lista Social Accounts. Elegir páginas o canales puede añadir varios |
error | Si hay un error, un código, por ejemplo cancelled cuando el cliente cerró el selector |
message | Si hay un error, un texto que puedes mostrar al cliente, cuando lo hay |
Una contraseña de Bluesky o WordPress incorrecta deja al cliente en la página del enlace para que lo intente de nuevo.
DELETE /api/v1/connect-links/:token
Revoca el enlace al instante. Las cuentas ya conectadas con él siguen conectadas. Devuelve { "success": true }, o 404 si ningún enlace de este espacio de trabajo tiene ese token.