Webhooks ir adrese tavā sistēmā, uz kuru PIM nosūta ziņu, kad kaut kas notiek — piemēram, produkts mainīts vai imports pabeigts.

Atver **Iestatījumi → Webhooki**. Pievienot un mainīt var **Administrators** un **Īpašnieks**.

## Izveidot webhook

1. Spied **Pievienot webhook**.
2. Ieraksti **Adresi** (jābūt `https://`).
3. Atzīmē **Notikumus**, kas tavai sistēmai tiešām vajadzīgi.
4. Spied **Izveidot webhook**.
5. Atvērsies webhook lapa ar **Paraksta atslēgu**. **Nokopē to uzreiz** (poga blakus) — vēlāk to vairs nerādīs.

Izslēgts webhook (**Aktīvs** noņemts) paliek saglabāts, bet ziņas netiek sūtītas.

## Notikumi

**Produkti:** produkts izveidots, mainīts, arhivēts, publicēts veikalā, pievienots sortimentam, produkti apvienoti / apvienošana atcelta, produkts atsaistīts, variants piesaistīts / atsaistīts mātes produktam.

**Attēli un faili:** augšupielādēts attēls vai fails, attēli vai faili mainīti.

**Teksti un īpašības:** tulkošana pabeigta, bagātināšana pabeigta, īpašības apvienotas / apvienošana atcelta.

**Piegādātāji:** imports pabeigts, piedāvājums vairs nav pieejams, piegādātājs pievienots / atvienots.

## Paraksta pārbaude

Katram pieprasījumam ir galvene:

```
X-Ecompim-Signature: t=<unix laiks>,v1=<paraksts>
```

`v1` = `HMAC-SHA256(paraksta atslēga, t + "." + pieprasījuma ķermenis)`, heksadecimāli. Pārbaudi parakstu un noraidi vecus pieprasījumus (piemēram, ja `t` ir vecāks par 5 minūtēm).

Paraksta atslēgu PIM izveido automātiski un parāda **tikai vienu reizi**; vēlāk redzami tikai pēdējie 4 simboli. Ja atslēga pazaudēta vai nonākusi svešās rokās, spied **Nomainīt atslēgu** un apstiprini — vecā atslēga uzreiz pārstāj darboties, jaunā tiek parādīta vienu reizi. Neaizmirsti to ielikt savā sistēmā.

## Ja tava sistēma neatbild

PIM mēģina **4 reizes**: uzreiz, pēc 1 minūtes, pēc 5 minūtēm un pēc 30 minūtēm. Pēc tam notikums netiek sūtīts vēlreiz.

> Lai neko nepalaistu garām, papildus lieto API galapunktu **`/api/v1/events`** — tajā ir visi notikumi, un to var nolasīt jebkurā brīdī.