Brauche ich einen API-Schlüssel für Bestellung → Einladung?

Commerce und Pro können eine Webhook-Token-URL für Storefront-Bestellereignisse verwenden. Growth/Pro-API-Schlüssel sind für POST /api/v1/invites und benutzerdefinierte Stacks — siehe https://ranqa.me/developers

Ersetzen Widgets Schema.org AggregateRating?

Nein. Widgets betten eine Live-Bewertung in Ihrem Storefront ein. Suchmaschinen durchsuchen AggregateRating auf Ihren öffentlichen Ranqa-Unternehmens-/Produktseiten, wenn Bewertungen vorhanden sind.

Wie lange dauert ein typisches Commerce-Setup?

Etwa 15 Minuten für fertige Module (Token + Webhook/Plugin + Testbestellung). Die Katalogzuordnung und die Platzierung des PDP-Widgets können je nach Ihrem Theme länger dauern.

← Integrationen

Velicoo — Bewertungseinladungen & Widgets

First-Class-Velicoo-Modul: Einladungen nach Lieferung, PDP-Widgets und Katalog-Sync — pro Tenant in Velicoo Admin konfiguriert.

1. Modul aktivieren

Das echte Modul liegt in Velicoo. Diese Zip dokumentiert Setup und Commerce-Endpoint.

Velicoo-Setup-Paket (.zip) herunterladen →

Ranqa-Dashboard → Commerce-Webhooks-Token oder API-Schlüssel erstellen.
Velicoo Admin → Integrations → Ranqa → Token einfügen und aktivieren.
Einladungsverzögerung standardmäßig 7 Tage nach WMS-Lieferung; native Bewertungs-E-Mails deaktivieren.
Wähle PDP-Widget-Slots und synchronisiere optional den Katalog.
Sende eine Testeinladung von Velicoo oder Ranqa.

2. Commerce-Endpunkt

InviteWorker postet hier gelieferte Bestellungen (EAN-Positionen, Land, verifiziert).

POST https://ranqa.me/api/v1/commerce/velicoo/orders?token=YOUR_WEBHOOK_TOKEN
Content-Type: application/json

{
  "email": "[email protected]",
  "name": "Anna",
  "id": "TG12345",
  "line_items": [{ "sku": "7350123456789" }],
  "shipping": { "country": "SE" },
  "delayHours": 0,
  "verifiedPurchase": true
}

# Or: Authorization: Bearer rnq_… (Growth/Pro API key)

Dashboard-Setup öffnen →

3. Widget-Slots

Konfiguriere in Velicoo Admin — Badge- und Karussellplatzierung auf der PDP.

below_title — unter dem Produktnamen
below_gallery — unter den Bildminiaturen
above_tabs — vor dem Beschreibungsklapp
below_description — nach der langen Beschreibung
footer — vollständiger Bewertungsbereich (Badge + Karussell)

Setup FAQ

Brauche ich einen API-Schlüssel für Bestellung → Einladung?: Commerce und Pro können eine Webhook-Token-URL für Storefront-Bestellereignisse verwenden. Growth/Pro-API-Schlüssel sind für POST /api/v1/invites und benutzerdefinierte Stacks — siehe https://ranqa.me/developers
Ersetzen Widgets Schema.org AggregateRating?: Nein. Widgets betten eine Live-Bewertung in Ihrem Storefront ein. Suchmaschinen durchsuchen AggregateRating auf Ihren öffentlichen Ranqa-Unternehmens-/Produktseiten, wenn Bewertungen vorhanden sind.
Wie lange dauert ein typisches Commerce-Setup?: Etwa 15 Minuten für fertige Module (Token + Webhook/Plugin + Testbestellung). Die Katalogzuordnung und die Platzierung des PDP-Widgets können je nach Ihrem Theme länger dauern.