Vivasend
API transakciniai laiškai integracija

Transakciniai laiškai per API

Kaip siųsti transakcinius el. laiškus per Vivasend API — žingsnis po žingsnio instrukcija su kodo pavyzdžiais.

Vivasend UAB ·

Transakciniai el. laiškai — tai automatiškai siunčiami pranešimai, kurie pasiekia gavėją konkrečiu momentu: patvirtinus užsakymą, atstatant slaptažodį ar užbaigus registraciją. Skirtingai nuo rinkodaros laiškų, transakciniai laiškai yra tiesiogiai susiję su vartotojo veiksmais ir pasižymi ypač aukštu atidarymo rodikliu.

Kaip pradėti

Norėdami siųsti transakcinius laiškus per Vivasend API, pirmiausia sukurkite naują šabloną transakcinių laiškų skiltyje. Šablone galite naudoti dinaminius kintamuosius formatu {$kintamojo_pavadinimas} — sistema juos automatiškai pakeis tikromis reikšmėmis siuntimo metu.

Šablonus galima kurti dviem būdais:

  • HTML redaktorius — pilna laisvė projektuoti HTML kodu
  • Vizualinis redaktorius — patogus drag & drop įrankis be programavimo žinių

API užklausa

Sukūrę šabloną, galite jį naudoti per API. Svarbiausi veiksniai — teisingai suformuota užklausa su JSON duomenų struktūra ir tinkamai sukonfigūruotas autorizacijos raktas.

Kiekviena API užklausa turi apimti:

  • Gavėjo el. pašto adresą
  • Kintamųjų reikšmes dinaminiams laukams užpildyti
  • Priedus (jei reikia)

Python pavyzdys

import requests
import json

url = "https://api.vivasend.lt/v1/transactional/send"

payload = {
    "to": "gavėjas@example.com",
    "template_id": "jūsų_šablono_id",
    "variables": {
        "vardas": "Jonas",
        "užsakymo_numeris": "12345"
    }
}

headers = {
    "Authorization": "Bearer JŪSŲ_API_RAKTAS",
    "Content-Type": "application/json"
}

response = requests.post(url, data=json.dumps(payload), headers=headers)
print(response.json())

Kintamieji šablone

Šablone kintamuosius rašykite tokiu formatu:

Sveiki, {$vardas}!

Jūsų užsakymas Nr. {$uzsakymo_numeris} sėkmingai gautas.

Sistema siuntimo metu automatiškai pakeis {$vardas} ir {$uzsakymo_numeris} tikromis reikšmėmis iš API užklausos.

Priedai

Prie transakcinių laiškų galima pridėti failus (sąskaitas, bilietus, dokumentus). Priedai perduodami base64 formatu API užklausoje.

Dažniausiai naudojami transakciniai laiškai

  • Užsakymo patvirtinimas — klientas iš karto gauna užsakymo detalles
  • Slaptažodžio atstatymas — saugus prisijungimo atkūrimas
  • Registracijos patvirtinimas — naujų vartotojų aktyvavimas
  • Pristatymo pranešimas — informacija apie siuntos būklę
  • Sąskaita faktūra — automatinis dokumentų siuntimas

Jei kyla klausimų diegiant API integraciją, susisiekite su mūsų komanda — mielai padėsime.

Visi straipsniai