Establecimientos

Crear un enlace de conexión

Devuelve un enlace alojado donde la persona autoriza una red con Sofia, sin que ningún token de red llegue a tu app. Válido 30 minutos; solo apps live.

POSThttps://api.sofia-post.com/api/v1/establishments/{id}/connection-links

curl -X POST 'https://api.sofia-post.com/api/v1/establishments/{id}/connection-links' \
  -H "Authorization: Bearer $SOFIA_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"platform":"tiktok","redirectUrl":"https://crm.example.com/sofia/connected"}'

{
  "platform": "tiktok",
  "url": "string",
  "expiresAt": "string"
}

Crear un enlace de conexión

curl --request POST \
  --url 'https://api.sofia-post.com/api/v1/establishments/<id>/connection-links' \
  --header "Authorization: Bearer $SOFIA_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "platform": "tiktok",
  "redirectUrl": "https://crm.example.com/sofia/connected"
}'

{
  "platform": "tiktok",
  "url": "string",
  "expiresAt": "string"
}

Crea un enlace de conexión alojado y envía al propietario a él. El enlace es válido durante 30 minutos; al terminar, Sofia lo devuelve a tu redirectUrl cuando reconoce su origen.

curl -X POST https://api.sofia-post.com/api/v1/establishments/$ESTABLISHMENT_ID/connection-links \
  -H "Authorization: Bearer $SOFIA_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"platform":"linkedin","redirectUrl":"https://app.example.com/sofia/connected"}'

Una red ya conectada responde 409 account_already_connected; una red que Sofia no ofrece responde 422 platform_not_offered.

Autorizaciones

Authorizationstringheaderobligatorio
Tu clave personal o token de acceso OAuth, enviado como Bearer <token>.

Parámetros de ruta

idstringobligatorio
Identificador del establecimiento.

Cuerpo

application/json

platformstringobligatorio
La red que conectar
Valores permitidos: instagramfacebooktiktoklinkedinx
redirectUrlstring
Adónde enviar a la persona al final, si Sofia reconoce este origen; si no, una página de Sofia le indica que ha terminado

Respuesta

El enlace de conexión alojado y su caducidad.

platformstringobligatorio
La red que conectar
urlstringobligatorio
La página de Sofia que la persona abre para conectar la red
expiresAtstringobligatorio
Hasta cuándo espera el enlace un clic (ISO 8601)

¿Te ha resultado útil esta página?