Jonas Müller, Produktentwicklung, RegioScoutJede qualifizierte RegioScout-Anfrage entsteht in Hero Software als neues Projekt mit Kunde, Adresse, Herkunftskennzeichnung und einem Logbuch-Eintrag, der den Portal-Link und alle Objektdaten enthält. Sie brauchen dafür ein Token für die Lead-API, das Sie beim Hero-Support anfragen. Diese Seite beschreibt die Einrichtung, die übertragenen Felder und das Verhalten bei Störungen.
Was Sie brauchen
Voraussetzungen
- Zugang
- API-Token für die Hero-Lead-API
- Bezugsweg
- beim Hero-Support anfragen (hero-software.de)
- Pflichtangabe je Anfrage
- E-Mail-Adresse — HERO erkennt Dubletten darüber
- Aufwand
- abhängig von der Bearbeitungszeit beim Hero-Support
Einrichtung
- Beim Hero-Support ein Token für die Lead-API anfragen. Anders als bei den meisten anderen Systemen können Sie es nicht selbst in der Oberfläche erzeugen.
- Das Token im RegioScout-Portal unter Integrationen einfügen und speichern.
Beim Speichern prüft RegioScout das Token sofort gegen die Hero-Schnittstelle. Ein abgelehntes Token wird nicht gespeichert, Sie sehen direkt eine Fehlermeldung. Ist Hero in dem Moment nicht erreichbar, wird das Token gespeichert und als „nicht verifiziert“ markiert. Alle Zugangsdaten liegen verschlüsselt.
Was in Hero Software ankommt
Angelegt wird ein Projekt mit Kunde, Adresse und Herkunftsdaten in einem Schritt.
| Hero-Feld | Inhalt |
|---|---|
| Kunde: Vorname / Nachname | Name des Eigentümers |
| Kunde: E-Mail | E-Mail-Adresse aus der Anfrage |
| Kunde: Telefon | Mobilnummer, ersatzweise Festnetznummer |
| Adresse | Straße, Hausnummer, PLZ, Ort, Länderkennzeichen DE |
| Quelle | „RegioScout - Lead“, Untergruppe „regioscout“, Medium „api“ |
| Partnerquelle | „RegioScout“ |
| Lead-Kennung | „RegioScout/{Anfrage-Nummer}“ |
| Status | „Neuer Kontakt“ |
| Logbuch-Kommentar | Portal-Link, Verteilung, Festnetz, Objektdaten |
Der Logbuch-Kommentar enthält die Anfrage-Nummer, den Link auf die Anfrage im RegioScout-Portal, die Verteilung (Exklusiv oder Multi), die Festnetznummer, falls beide Nummern vorliegen, und die im Gespräch erfassten Objektdaten: Haustyp, Dachform und Dachbelag, aktuelle Heizung und Heizungsalter, Anzahl Bewohner, Stromverbrauch und weitere Angaben, soweit vorhanden.
Durch die eigene Lead-Kennung je Anfrage können Sie in Hero jederzeit nachvollziehen, welches Projekt zu welcher RegioScout-Anfrage gehört — hilfreich bei einer Reklamation, siehe Anfrage reklamieren.
Für Photovoltaik-Anfragen wird zusätzlich die Gewerkekennung für Photovoltaik gesetzt. Bei Wärmepumpen-Anfragen verzichten wir darauf, weil die Gewerkecodes je Hero-Instanz unterschiedlich vergeben sind und ein falscher Code mehr Schaden anrichtet als ein fehlender. Das Produktinteresse steht in jedem Fall im Logbuch-Kommentar.
Sie werden doppelt benachrichtigt — mit Absicht
RegioScout setzt beim Anlegen die Partner-Benachrichtigung, sodass HERO seine eigene Neu-Lead-Mail verschickt. Wenn Sie zusätzlich die RegioScout-E-Mail-Benachrichtigung aktiviert haben, erhalten Sie also zwei Nachrichten. Das ist bewusst so: Lieber eine Mail zu viel als eine Anfrage, die niemand sieht. Die RegioScout-Benachrichtigung können Sie im Portal abschalten, wenn Ihnen die HERO-Mail genügt.
Vor dem Ernstfall: Test-Anfrage senden
Im Portal senden Sie unter Integrationen eine Test-Anfrage durch dieselbe Strecke wie später die echten. Sie erscheint in Hero als „Max Mustermann (n. TEST)“, wird nach 15 Minuten automatisch gelöscht und ist auf drei Versuche je zehn Minuten begrenzt.
Wenn etwas nicht funktioniert
Die CRM-Anbindung ist ein zusätzlicher Weg, nicht der einzige. Jede Anfrage steht unabhängig davon im RegioScout-Portal und geht, wenn eingestellt, per E-Mail an Sie.
Schlägt die Übertragung fehl — Token zurückgezogen, Hero nicht erreichbar —, erhalten Sie eine Mitteilung im Portal mit der Fehlermeldung. Die Anfrage bleibt vollständig erhalten und lässt sich mit Erneut zustellen noch einmal senden, sobald die Ursache behoben ist.
Zusammenspiel mit den anderen Wegen
Portal, E-Mail-Benachrichtigung und Hero-Anbindung laufen parallel; den Übermittlungsweg ändern Sie jederzeit im Portal.
Wie eine Anfrage entsteht, bevor sie als Projekt bei Ihnen liegt, steht unter Wie RegioScout eine Anfrage qualifiziert.