Než začnete

Než spolu plugin a Messenger začnou komunikovat, potřebujete od Messengeru několik věcí. Nejjednodušší je vyžádat si všechno jedním e-mailem — na konci stránky najdete hotovou šablonu ke zkopírování.

Co potřebujete od Messengeru

Co	Kam v pluginu patří	Poznámka
Zákaznické číslo	Zákaznické číslo	číselné, slouží k přihlášení k API
Heslo	Heslo	slouží k přihlášení k API
importKey	importKey	přiděluje IT oddělení Messengeru
Číslo typu přepravy	Typ přepravy	výchozí 106 = Over Economy (doručení den po vyzvednutí); jiné typy po domluvě s obchodním oddělením

Všechno se zadává v WooCommerce → Nastavení → Doprava → Messenger — viz Nastavení pluginu.

Testovací přístupy

Plugin má po instalaci zapnutý testovací režim, takže do ostrého prostředí nic neodejde. Testovací režim komunikuje s api-test.messenger.cz a testovací zásilky zkontrolujete v testovacím portálu.

Vyžádejte si od Messengeru samostatné testovací přístupy — ostré přístupy v testovacím prostředí nefungují. Až si ověříte, že vše funguje, nezapomeňte testovací režim vypnout.

Registrace tracking webhooku

Aby se stavy objednávek aktualizovaly automaticky (včetně překlopení na Vyřízeno po doručení), potřebuje Messenger vědět, kam posílat stavy zásilek. Předejte jim URL, kterou plugin zobrazuje v hlavičce svého nastavení:

https://VASE-DOMENA/wp-json/kbnt-messenger/v1/trackingstates/

Formát: JSON, metoda: POST. Bez této registrace se stavy neaktualizují a objednávky se samy nepřeklopí do Vyřízeno — víc na stránce Stavy objednávky.

Ještě jedna věc k nahlášení

Plugin posílá číslo popisné dohromady s ulicí v jednom poli (samostatné pole pro číslo domu nemá). Dejte to Messengeru vědět, ať adresy na své straně zpracují správně — plugin na to ostatně upozorňuje i v nastavení.

Hotová šablona e-mailu

Předmět: Napojení WooCommerce — žádost o přístupy

Dobrý den,

napojujeme náš e-shop (https://VASE-DOMENA) na vaše API pomocí WooCommerce
pluginu Kybernaut Messenger. Prosíme o zaslání:

1. Zákaznického čísla, hesla a importKey pro ostré API.
2. Testovacích přístupů k api-test.messenger.cz, ať si napojení nejdřív
   ověříme.
3. Čísla našeho domluveného typu přepravy (pokud se liší od 106 / Over
   Economy).

Prosíme také o registraci webhooku pro stavy zásilek:
URL: https://VASE-DOMENA/wp-json/kbnt-messenger/v1/trackingstates/
Formát: JSON, metoda POST.

Poznámka: číslo popisné posíláme dohromady s ulicí v jednom poli.

Děkujeme!