Attività

Creare un link di collegamento

Restituisce un link ospitato dove la persona autorizza una rete con Sofia, senza che alcun token di rete arrivi alla tua app. Valido 30 minuti; solo app 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"
}

Creare un link di collegamento

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 link di collegamento ospitato e manda lì il titolare. Il link è valido 30 minuti; alla fine, Sofia lo riporta al tuo redirectUrl quando ne riconosce l’origine.

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 rete già collegata risponde 409 account_already_connected; una rete che Sofia non propone risponde 422 platform_not_offered.

Autorizzazioni

Authorizationstringheaderobbligatorio
La tua chiave personale o il token di accesso OAuth, inviato come Bearer <token>.

Parametri di percorso

idstringobbligatorio
Identificatore dell'attività.

Body

application/json

platformstringobbligatorio
La rete da collegare
Valori ammessi: instagramfacebooktiktoklinkedinx
redirectUrlstring
Dove mandare la persona alla fine, se Sofia riconosce questa origine; altrimenti una pagina di Sofia le dice che è fatto

Risposta

Il link di collegamento ospitato e la sua scadenza.

platformstringobbligatorio
La rete da collegare
urlstringobbligatorio
La pagina di Sofia che la persona apre per collegare la rete
expiresAtstringobbligatorio
Fino a quando il link attende un clic (ISO 8601)

Questa pagina ti è stata utile?