Sådan sender du invitationer med Business Generated Links (for udviklere)

Denne guide er rettet mod udviklere, som gerne vil oprette Business Generated Links. Hér får du hjælp til at oprette krypterede links med dit foretrukne programmeringssprog.

VIGTIGT

Business Generated Links er kun tilgængelige for nye Trustpilot-kunder inden for specifikke brancher.

Bemærk: For at hjælpe dig i gang har Trustpilot tilgængelige ressourcer om Authenticated Encryption på GitHub. Læs mere her.

Vejledning til alle programmeringssprog

Business Generated Links bruger Authenticated Encryption with Associated Data (AEAD) og metoden Encrypt then MAC (EtM). Trustpilot bruger én nøgle til at kryptere dataene i payload (encryptkey) og en anden nøgle til MAC-delen (authkey) for at sikre dataintegritet.

Gå ind på din virksomhedskonto > Få anmeldelser > Invitér kunder > Business Generated Links for at finde de to nøgler.

Opret Business Generated Links

  1. Nøglerne, som kopieres fra din virksomhedskonto, er kodet med base64, så dit program skal først foretage en base64-afkodning af dem.
  2. Opret et JSON-formatteret payload-objekt, og indsæt kundeoplysningerne. Følgende felter er obligatoriske: email, name og ref (referencenummer). Her ses et eksempel:
{
  "email":"hans@eksempel.dk",
  "name":"Hans Jensen",
  "ref":"1234",
  "skus":["sku1","sku2","sku3"],
  "tags":["tag1","tag2","tag3"]
}
Bemærk: Tags må ikke indeholde mellemrum.
  1. Brug AES-CBC med en nøglestørrelse på 256-bit, en blokstørrelse på 128-bit og PKCS7 padding mode til at kryptere payload-dataene, så de ikke kan læses af tredjeparter.
  • Brug en Initialization Vector (IV) med en blokstørrelse på 128-bit.
  • Kryptér JSON-objektet med encryptkey og IV.
  • Opret en signatur for ciphertexten.
  • For at oprette en signatur skal du bruge HMAC-SHA256 og authkey. Beregn HMAC ved at hashe IV efterfulgt af ciphertexten, som fremgår af dette eksempel: HMAC = HMAC-SHA256( IV + ciphertext ).
  1. Brug base64 til at kryptere IV, ciphertext og HMAC: base64_payload = base64( IV + ciphertext + HMAC )
  2. Da base64 inkluderer skråstreger (/) og plustegn (+), skal du URL-encode payload-dataene ovenfor, før du tilføjer dem til det endelige link.
  3. Det endelige link burde se sådan ud:
  payload = urlencode( base64_payload )
  https://www.trustpilot.com/evaluate-bgl/<domain>?p=<payload>
  1. Erstat domænet med dit domænenavn og payload med de payload-data, du genererede i trin 5.

Det følgende rutediagram viser de nødvendige trin for korrekt formatering, kryptering og klargøring af payload-dataene før distribution:

Image_1.png

Sådan verificerer du et Business Generated Link

Du kan verificere, at et Business Generated Link er oprettet korrekt, på to måder:

Test dit link i en browser

Indsæt dit link i en browser, og søg. Lav derefter en testanmeldelse, hvor du vælger antallet af stjerner, tilføjer en titel og skriver en tekst. Hvis knappen Send din anmeldelse nu er aktiv, lykkedes din krypteringsproces. Hvis du bliver bedt om at logge ind med Facebook, Google eller e-mail, mislykkedes din krypteringsproces. Offentliggør ikke din testanmeldelse. Her er et eksempel:

Image_2.png

Test dit link med vores command line interface (CLI)

Du kan installere vores command line interface (CLI) på din computer. Hvis du kan dekryptere dine payload-data med CLI, er de krypteret korrekt.

Sådan koder du Business Generated Links til produktanmeldelser

For at indsamle produktanmeldelser med Business Generated Links skal du føje produkt-SKU'er til dine payload-data. Her er et eksempel på payload-data, der omfatter produkt-SKU'er. Det er en simpel JSON array:

{
  "email":"hans@eksempel.dk",
  "name":"Hans Jensen",
  "ref":"1234",
  "skus":["sku1","sku2","sku3"]
}

Hvordan lokaliserer jeg et Business Generated Link?

Slet og erstat "www." med den relevante landekode, som for eksempel:

https://de.trustpilot.com/evaluate-bgl/?p= https://es.trustpilot.com/evaluate-bgl/?p=

Sådan sender du invitationer til at skrive lokationsanmeldelser med Business Generated Links

Hvis du vil bruge Business Generated Links til at sende invitationer til at skrive lokationsanmeldelser, skal du sørge for at inkludere lokationsfeltet, når du tilføjer kundens oplysninger til payload-kodestrengen. Brug det lokations-ID, du har givet den specifikke lokation.

Her ses et eksempel:

{
  "email":"hans@eksempel.dk",
  "name":"Hans Jensen",
  "ref":"1234",
  "locationId": "id1",
  "skus":["sku1","sku2","sku3"],
  "tags":["tag1","tag2","tag3"]
}

Bemærk: Der skelnes mellem store og små bogstaver i lokations-ID'et.