Ātrais sākums
- Ienāc biznesa panelī ar Google vai Facebook un piesaisti savu uzņēmumu (darba e-pasts, meta tags, fails vai DNS ieraksts).
- Ieliec logrīku mājaslapā — tas strādā arī bez piesaistes.
- Sāc aicināt klientus: CSV no paneļa, unikālas saites pasūtījuma e-pastā vai API.
- Izveido API atslēgu un webhook, lai atsauksmes nonāktu tavā CRM vai Slack.
Tavs uzņēmuma identifikators (slug) ir profila adreses pēdējā daļa: https://godigasatsauksmes.lv/uznemums/swedbank.
Logrīki
Ielīmē kodu vietā, kur jārāda logrīks. Logrīks ielādējas atsevišķā iframe, tāpēc neietekmē tavas lapas stilus un ātrumu (loading="lazy"), un pielāgo augstumu saturam.
<div class="ga-widget" data-company="swedbank" data-type="carousel"></div>
<script src="https://godigasatsauksmes.lv/widget.js" async></script>| Atribūts | Vērtības | Apraksts |
|---|---|---|
data-company | slug | Obligāts. Uzņēmuma identifikators. |
data-type | mini stars badge carousel list collector | Logrīka veids (noklusētais mini). |
data-theme | dark | Tumšam fonam. |
data-min | 1–5 | Rādīt atsauksmes no šī vērtējuma (karuselim un sarakstam). Kopējais vērtējums vienmēr ietver visas atsauksmes. |
data-count | 1–20 | Atsauksmju skaits. |
miniVērtējums un atsauksmju skaits. Der kājenei, grozam vai produkta lapai.starsViena kompakta rinda — galvenei vai pie cenas.badgeNeliela poga ar vērtējumu.carouselJaunākās atsauksmes, ko var šķirstīt. Sākumlapai.listAtsauksmju saraksts — lapai «Atsauksmes».collectorPiecas zvaigznes, kas ved uz atsauksmes formu. Pēc pirkuma lapai.Ja lapu ielādē dinamiski (React, Vue, SPA), pēc jaunu elementu pievienošanas izsauc window.GodigasAtsauksmes.init(). Bez JavaScript var izmantot tiešu iframe: <iframe src="https://godigasatsauksmes.lv/embed/swedbank?type=mini" …>.
SVG nozīmīte
Attēls ar aktuālo vērtējumu e-pasta parakstam, rēķiniem, Markdown un vietām, kur skripti nav atļauti. Atjaunojas ik pēc 30 minūtēm.
<a href="https://godigasatsauksmes.lv/uznemums/swedbank"><img src="https://godigasatsauksmes.lv/badge/swedbank.svg" alt="Atsauksmes — Godīgas Atsauksmes" height="28"></a>Uzaicinājumi pēc pirkuma
Uzaicinātās atsauksmes profilā saņem atzīmi «Uzaicināts», un tu redzi, kurš pasūtījums tās atnesa. Ir četri veidi:
| Veids | Kam der | Kas sūta e-pastu |
|---|---|---|
| CSV vai viens e-pasts biznesa panelī | Bez izstrādes, periodiski | Godīgas Atsauksmes |
API ar e-pastu — POST /invitations ar email | E-veikals, CRM, kase | Godīgas Atsauksmes (ar aizturi) |
API bez e-pasta — POST /invitations tikai ar reference | Saite tavā pasūtījuma/piegādes e-pastā | Tu pats |
| Parakstīta saite — bez API izsaukuma | E-pasta šabloni, kur var izrēķināt HMAC | Tu pats |
Godīgas Atsauksmes sūtītais e-pasts satur tavu tekstu, piecas zvaigznes (klikšķis atver formu ar izvēlēto vērtējumu) un atteikšanās saiti. Tekstu, sūtītāja vārdu un aizturi (0–30 dienas) maini panelī. Ja klients ir atteicies, uzaicinājums netiek sūtīts. Klientu e-pastus dzēšam pēc 180 dienām.
Parakstītas saites
Saiti var izveidot jebkur, kur var izrēķināt HMAC-SHA256 — bez API izsaukuma. Slepenā atslēga ir biznesa paneļa sadaļā «Uzaicinājumi». Paraksts tiek rēķināts no virknes {slug}:{reference}:
https://godigasatsauksmes.lv/i/s/{slug}?ref={reference}&sig={hex(HMAC_SHA256(secret, slug + ":" + reference))}Neobligāti parametri: name (klienta vārds), r (1–5, iepriekš izvēlētais vērtējums — zvaigznēm e-pastā). Katrs reference ir viens uzaicinājums: atkārtots klikšķis atver to pašu.
PHP
$ref = (string) $order->get_id();
$sig = hash_hmac('sha256', 'swedbank:' . $ref, GA_LINK_SECRET);
$link = 'https://godigasatsauksmes.lv/i/s/swedbank?ref=' . rawurlencode($ref) . '&sig=' . $sig;Node.js
import { createHmac } from 'node:crypto';
const ref = String(order.id);
const sig = createHmac('sha256', process.env.GA_LINK_SECRET).update('swedbank:' + ref).digest('hex');
const link = 'https://godigasatsauksmes.lv/i/s/swedbank?ref=' + encodeURIComponent(ref) + '&sig=' + sig;Python
import hmac, hashlib, urllib.parse
ref = str(order.id)
sig = hmac.new(GA_LINK_SECRET.encode(), f"swedbank:{ref}".encode(), hashlib.sha256).hexdigest()
link = f"https://godigasatsauksmes.lv/i/s/swedbank?ref={urllib.parse.quote(ref)}&sig={sig}"REST API v1
Bāzes adrese: https://godigasatsauksmes.lv/api/v1. Atbildes ir JSON (UTF-8), laiki — ISO 8601 UTC. Privātajiem galapunktiem sūti API atslēgu, ko izveido biznesa panelī:
Authorization: Bearer ga_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxAtslēga dod piekļuvi tikai vienam uzņēmumam. Glabā to serverī — nekad pārlūka kodā vai mobilajā lietotnē. Kļūdas izskatās tā:
HTTP/1.1 401 Unauthorized
{ "error": { "code": "unauthorized", "message": "Trūkst vai nederīga API atslēga." } }Kodi: 400 invalid_request, 400 invalid_json, 401 unauthorized, 404 not_found, 409 conflict, 429 daily_limit. Saraksti ir lappušu veidā: ?page=1&per_page=20 (līdz 100), atbildē page, per_page, total.
/meTavs uzņēmums un vērtējumsUzaicinājumi
/invitationsIzveidot vienu vai līdz 100 uzaicinājumiem/invitationsSaraksts; filtri ?status= un ?reference=/invitations/{id}Viens uzaicinājums/invitations/{id}Atcelt, ja vēl nav nosūtītsLauki: email (ja nav — tikai saite), name, reference (pasūtījuma nr.; atkārtots pieprasījums ar to pašu vērtību atgriež esošo uzaicinājumu — droši atkārtot), delay_days (0–60, noklusētais no paneļa) vai send_at (ISO laiks).
curl https://godigasatsauksmes.lv/api/v1/invitations \
-H "Authorization: Bearer $GA_API_KEY" \
-H "Content-Type: application/json" \
-d '{"email":"anna@piemers.lv","name":"Anna","reference":"10045","delay_days":3}'HTTP/1.1 201 Created
{
"data": {
"id": 812,
"email": "anna@piemers.lv",
"name": "Anna",
"reference": "10045",
"status": "queued",
"send_at": "2026-11-22 09:14:02",
"link": "https://godigasatsauksmes.lv/i/3f9c…"
}
}Vairāki uzreiz: {"invitations": [{…}, {…}]} — atbildē data ir masīvs tādā pašā secībā. Statusi: queued, sent, opened, reviewed, link (bez e-pasta), duplicate (tas pats e-pasts pēdējās 30 dienās), unsubscribed, invalid, failed, cancelled.
Atsauksmes
/reviewsTava uzņēmuma atsauksmes; ?since=2026-11-01T00:00:00Z/reviews/{id}/replyPublicēt vai mainīt atbildi: {"body": "…"}/reviews/{id}/replyNoņemt atbildi{
"data": [{
"id": 4211,
"rating": 5,
"title": "Ātri un godīgi",
"body": "Pasūtīju svētdien, pirmdien jau bija klāt…",
"tags": ["Ātrs serviss"],
"author": "Anna K.",
"experience_month": "2026-11",
"published_at": "2026-11-19T08:12:44Z",
"invited": true,
"verified": false,
"reply": null,
"url": "https://godigasatsauksmes.lv/uznemums/swedbank#r4211",
"invitation": { "id": 812, "reference": "10045" }
}],
"page": 1, "per_page": 20, "total": 1
}Publiskie dati (bez atslēgas)
/companies?q=220Meklēt uzņēmumus pēc nosaukuma, domēna vai reģ. nr./companies/{slug}Vērtējums, skaits un sadalījums pa zvaigznēm/companies/{slug}/reviewsPublicētās atsauksmes; ?min_rating=4Publiskie galapunkti atļauj CORS (Access-Control-Allow-Origin: *) un tiek kešoti 5 minūtes — tos var saukt arī no pārlūka, lai veidotu savu dizainu.
const res = await fetch('https://godigasatsauksmes.lv/api/v1/companies/swedbank');
const { data } = await res.json();
console.log(data.rating, data.review_count, data.distribution);Webhooki
Iestati URL biznesa paneļa sadaļā «API un webhooki». Par katru jaunu atsauksmi nosūtām POST ar JSON. Atbildi ar 2xx 8 sekunžu laikā; pēdējās piegādes redzamas panelī.
POST /hooks/atsauksmes
GA-Event: review.created
GA-Signature: t=1763540000,v1=5d41402abc4b2a76b9719d911017c592…
{
"id": "evt_8b1f…",
"event": "review.created",
"created_at": "2026-11-19T08:12:45Z",
"data": {
"company": { "slug": "swedbank" },
"review": { "id": 4211, "rating": 5, "title": "…", "invitation": { "id": 812, "reference": "10045" }, … }
}
}Paraksta pārbaude. v1 = HMAC-SHA256 ar tavu whsec_… noslēpumu no virknes {t}.{neapstrādātais ķermenis}. Noraidi pieprasījumus, kas vecāki par 5 minūtēm.
Node.js (Express)
import { createHmac, timingSafeEqual } from 'node:crypto';
app.post('/hooks/atsauksmes', express.raw({ type: 'application/json' }), (req, res) => {
const parts = Object.fromEntries(req.get('GA-Signature').split(',').map((p) => p.split('=')));
const expected = createHmac('sha256', process.env.GA_WEBHOOK_SECRET).update(parts.t + '.' + req.body).digest('hex');
const fresh = Math.abs(Date.now() / 1000 - Number(parts.t)) < 300;
if (!fresh || !timingSafeEqual(Buffer.from(expected), Buffer.from(parts.v1))) return res.sendStatus(401);
const event = JSON.parse(req.body);
// event.data.review …
res.sendStatus(204);
});PHP
$body = file_get_contents('php://input');
parse_str(str_replace(',', '&', $_SERVER['HTTP_GA_SIGNATURE'] ?? ''), $sig);
$expected = hash_hmac('sha256', $sig['t'] . '.' . $body, GA_WEBHOOK_SECRET);
if (abs(time() - (int) $sig['t']) > 300 || !hash_equals($expected, $sig['v1'] ?? '')) {
http_response_code(401); exit;
}
$event = json_decode($body, true);Notikumi: review.created, test (poga «Nosūtīt testu»).
Receptes
WooCommerce — uzaicinājums, kad pasūtījums izpildīts
// functions.php vai neliels spraudnis
add_action('woocommerce_order_status_completed', function ($order_id) {
$order = wc_get_order($order_id);
wp_remote_post('https://godigasatsauksmes.lv/api/v1/invitations', [
'headers' => [
'Authorization' => 'Bearer ' . GA_API_KEY,
'Content-Type' => 'application/json',
],
'body' => wp_json_encode([
'email' => $order->get_billing_email(),
'name' => $order->get_billing_first_name(),
'reference' => (string) $order_id,
'delay_days' => 5,
]),
'timeout' => 5,
]);
});Shopify — Flow
Izveido Flow: trigeris Order fulfilled → darbība Send HTTP request: metode POST, URL https://godigasatsauksmes.lv/api/v1/invitations, galvenes Authorization: Bearer … un Content-Type: application/json, ķermenis:
{"email":"{{order.email}}","name":"{{order.customer.firstName}}","reference":"{{order.name}}","delay_days":5}Saite pasūtījuma e-pastā (jebkura platforma)
Ja e-pastu sūti pats, izveido uzaicinājumu bez email — atbildē būs link, ko ievieto e-pastā («Novērtē mūs»). Vai izmanto parakstītu saiti bez API izsaukuma.
Make, Zapier, n8n
Izmanto HTTP moduli ar tiem pašiem parametriem kā curl piemērā. Jaunas atsauksmes uz Slack vai Google Sheets — ar webhook trigeri.
Noteikumi un limiti
- Aicini visus. Nedrīkst atlasīt tikai apmierinātus klientus vai aicināt pēc tam, kad klients jau izteicis apmierinātību.
- Bez atlīdzības. Par atsauksmi nedrīkst piedāvāt atlaidi, dāvanu vai dalību izlozē.
- Tikai reāli klienti. Uzaicini tikai cilvēkus, kuri pēdējo 12 mēnešu laikā izmantojuši tavus pakalpojumus, un atbilstoši VDAR (likumīgās intereses vai piekrišanas pamatā). Atteikšanos ievērojam automātiski.
- Atsauksmes nevar dzēst. Uz tām var atbildēt vai ziņot par pārkāpumu.
- Limiti: 2000 uzaicinājumi diennaktī, 100 vienā API pieprasījumā, 1000 vienā CSV, 10 aktīvas API atslēgas. Ja vajag vairāk — raksti mums.
API v1 · atjaunots 2026-11-19. Izmaiņas, kas var salauzt integrācijas, paziņosim vismaz 60 dienas iepriekš.