Zapier 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)

Auslöser: Ereignis aus My Store Locator

1. Legen Sie in Zapier einen neuen Zap an und wählen Sie als Auslöser Webhooks by Zapier → Catch Hook. Zapier zeigt Ihnen eine Webhook-Adresse.
2. Legen Sie in My Store Locator unter API & Webhooks einen Webhook mit dieser Adresse an, Format JSON, und wählen Sie die Ereignisse, z. B. lead.created.
3. Senden Sie in der App ein Testereignis und laden Sie es in Zapier als Beispiel.
4. Fügen Sie die gewünschte Aktion hinzu, zum Beispiel einen Eintrag im CRM oder eine Nachricht in Slack.

„Webhooks by Zapier“ ist laut Zapier nur in bezahlten Zapier-Tarifen verfügbar.

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. Fügen Sie in Zapier die Aktion Webhooks by Zapier → Custom Request hinzu.
3. Methode POST, URL https://app.my-store-locator.com/api/v1/ext/locations.
4. Unter Headers: Authorization mit dem Wert Bearer msl_live_… (Ihr Key) und Content-Type mit application/json.
5. Unter Data den Inhalt als JSON, die Werte ziehen Sie aus dem vorherigen Schritt.

Zum Ändern nutzen Sie PATCH mit /api/v1/ext/locations/{id} und senden nur die geänderten Felder.

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 Zapier, nicht im Klartext in einzelnen Schritten.
• Nicht mehr benötigte Keys widerrufen Sie in der App mit einem Klick.

FAQ