n8n mit My Store Locator verbinden

Was Sie damit machen können

• Auf Ereignisse reagieren: Eine neue Anfrage über die Karte landet als Aufgabe im CRM, als Nachricht im Team-Chat oder als Zeile in einer Tabelle.
• Standorte automatisch pflegen: Neue Filialen aus Ihrer Warenwirtschaft, einer Tabelle oder einem Formular werden in My Store Locator angelegt oder geändert.
• Abgleichen: Geänderte Standorte regelmäßig abrufen (updatedSince) und in andere Systeme übertragen.

Voraussetzungen

• Ein Konto bei My Store Locator ab dem Tarif Starter - API-Keys und Webhooks sind dort enthalten (Tarife ansehen)
• Ein API-Key mit den passenden Berechtigungen (in der App unter API & Webhooks)

Community-Node installieren

Unser Community-Node ist auf npm als n8n-nodes-mystorelocator veröffentlicht. Er bringt den Node My Store Locator (Standorte, Karten, Anfragen, Kategorien, Status) und zwei Auslöser mit: einen, der regelmäßig nach neuen oder geänderten Daten fragt, und einen Webhook-Auslöser in Echtzeit.

1. Öffnen Sie in Ihrer selbst gehosteten n8n-Instanz Settings → Community Nodes und klicken Sie auf Install.
2. Geben Sie den Paketnamen n8n-nodes-mystorelocator ein, bestätigen Sie den Hinweis und klicken Sie auf Install.
3. Legen Sie die Zugangsdaten My Store Locator API mit Ihrem API-Key an.

Ohne Oberfläche installieren Sie das Paket im Ordner ~/.n8n/nodes:

npm install n8n-nodes-mystorelocator

n8n Cloud zeigt nur Community-Nodes, die n8n selbst geprüft hat. Dort nutzen Sie den Webhook- und den HTTP-Request-Node wie unten beschrieben.

Auslöser: Ereignis aus My Store Locator

1. Legen Sie in n8n einen Workflow an und fügen Sie als Start einen Webhook-Node hinzu, Methode POST.
2. Kopieren Sie die Production URL des Nodes (sie muss öffentlich per https erreichbar sein).
3. Legen Sie in My Store Locator unter API & Webhooks einen Webhook mit dieser Adresse an, Format JSON, und wählen Sie die Ereignisse.
4. Aktivieren Sie den Workflow und senden Sie in der App ein Testereignis.

Möchten Sie die Signatur prüfen, berechnen Sie in einem Code-Node den HMAC-SHA256 aus <t>.<Inhalt> mit dem Geheimnis des Webhooks und vergleichen ihn mit dem Header X-MSL-Signature.

Verfügbare Ereignisse: location.created, location.updated, location.deleted, map.published, lead.created, import.finished. Jede Zustellung trägt die Header X-MSL-Event und X-MSL-Signature (HMAC-SHA256), mit denen Sie die Herkunft prüfen können. Schlägt eine Zustellung fehl, wiederholen wir sie nach 1, 5 und 30 Minuten.

Aktion: Standort anlegen oder ändern

1. Legen Sie in der App einen API-Key mit der Berechtigung locations:write an.
2. Legen Sie in n8n unter Credentials eine Zugangsart Header Auth an: Name Authorization, Wert Bearer msl_live_….
3. Fügen Sie einen HTTP Request-Node hinzu: Methode POST, URL https://app.my-store-locator.com/api/v1/ext/locations, Authentifizierung über die angelegte Header Auth.
4. Schalten Sie Send Body ein, Format JSON, und belegen Sie die Felder aus vorherigen Nodes.

Zum Ändern nutzen Sie PATCH mit /api/v1/ext/locations/{id}. Zum Testen der Verbindung genügt GET /api/v1/ext/me.

Ein Beispiel für den Inhalt eines neuen Standorts:

{
  "name": "Filiale Frankfurt Nord",
  "street": "Musterstraße 1",
  "zip": "60320",
  "city": "Frankfurt am Main",
  "country": "DE"
}

Fehlen Koordinaten, wird die Adresse über unseren Kartenserver geokodiert. Neue Standorte erscheinen auf allen veröffentlichten Karten, sofern Sie keine bestimmten Karten angeben. Alle Endpunkte und Felder stehen unter API und Webhooks.

Nur gelegentliche Massenänderungen? Dafür genügt oft der CSV-Import: Liste exportieren, importieren, fertig.

Sicherheit

• Geben Sie dem API-Key nur die Berechtigungen, die der Ablauf braucht, zum Beispiel nur locations:write.
• Speichern Sie den Key in den Zugangsdaten bzw. Credentials von n8n, nicht im Klartext in einzelnen Schritten.
• Nicht mehr benötigte Keys widerrufen Sie in der App mit einem Klick.

FAQ