Betriebe

Einen Verbindungslink erstellen

Liefert einen gehosteten Link, über den die Person ein Netzwerk bei Sofia autorisiert, ohne dass ein Netzwerk-Token Ihre App erreicht. 30 Min. gültig, nur 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"
}

Einen Verbindungslink erstellen

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"
}

Erstelle einen gehosteten Verbindungslink und schicke den Inhaber dorthin. Der Link ist 30 Minuten gültig; am Ende leitet Sofia zu deiner redirectUrl zurück, sofern sie deren Herkunft erkennt.

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"}'

Ein bereits verbundenes Netzwerk antwortet mit 409 account_already_connected; ein Netzwerk, das Sofia nicht anbietet, mit 422 platform_not_offered.

Autorisierungen

Authorizationstringheadererforderlich
Ihr persönlicher Schlüssel oder OAuth-Access-Token, gesendet als Bearer <token>.

Pfadparameter

idstringerforderlich
Kennung des Betriebs.

Body

application/json

platformstringerforderlich
Das zu verbindende Netzwerk
Zulässige Werte: instagramfacebooktiktoklinkedinx
redirectUrlstring
Wohin die Person am Ende geschickt wird, wenn Sofia diesen Ursprung erkennt; sonst meldet eine Sofia-Seite, dass es erledigt ist

Antwort

Der gehostete Verbindungslink und sein Ablauf.

platformstringerforderlich
Das zu verbindende Netzwerk
urlstringerforderlich
Die Sofia-Seite, die die Person öffnet, um das Netzwerk zu verbinden
expiresAtstringerforderlich
Bis wann der Link auf einen Klick wartet (ISO 8601)

War diese Seite hilfreich?