Before you start

Before the plugin can talk to Messenger, you need a few things from them. It’s easiest to ask for everything in one e-mail — there’s a ready-to-copy template at the end of this page.

What you need from Messenger

What	Where it goes in the plugin	Note
Customer number	Zákaznické číslo	numeric, used for API authentication
Password	Heslo	used for API authentication
importKey	importKey	issued by Messenger’s IT department
Shipping type number	Typ přepravy	the default 106 = Over Economy (delivery the day after pickup); other types by agreement with their sales department

All of these are entered under WooCommerce → Settings → Shipping → Messenger — see Plugin settings.

Test access

The plugin ships with test mode enabled by default, so nothing reaches the production environment right after installation. Test mode talks to api-test.messenger.cz, and you can check your test shipments in the test portal.

Ask Messenger for separate test credentials — production credentials don’t work against the test environment. Once you’ve verified everything works, don’t forget to turn test mode off.

Tracking webhook registration

To have order statuses update automatically (including the switch to Completed after delivery), Messenger needs to know where to send shipment status updates. Give them the URL the plugin shows at the top of its settings page:

https://YOUR-DOMAIN/wp-json/kbnt-messenger/v1/trackingstates/

Format: JSON, method: POST. Without this registration the statuses won’t update and orders won’t move to Completed on their own — more in Order statuses.

One more thing to mention

The plugin sends the house number together with the street in a single field (there is no separate house-number field). Let Messenger know so their side parses addresses correctly — the plugin reminds you about this in its settings, too.

Ready-to-send e-mail template

Subject: WooCommerce integration — access request

Hello,

we are connecting our e-shop (https://YOUR-DOMAIN) to your API via the
Kybernaut Messenger WooCommerce plugin. Please send us:

1. Customer number, password, and importKey for the production API.
2. Test credentials for api-test.messenger.cz, so we can verify the
   integration first.
3. Our agreed shipping type number (if different from 106 / Over Economy).

Please also register our tracking-states webhook:
URL: https://YOUR-DOMAIN/wp-json/kbnt-messenger/v1/trackingstates/
Format: JSON, method POST.

Note: our system sends the house number together with the street in one
field.

Thank you!