Standorte aus dem Unternehmensprofil aufnehmen

Google Unternehmensprofil ist ein kostenloses und einfach zu verwendendes Tool für Unternehmen und Organisationen. Damit kann die Onlinepräsenz auf Google, einschließlich der Google Suche und Google Maps, schnell und einfach verwaltet werden.

Über die Google Unternehmensprofil API lassen sich Informationen zu Unternehmensstandorten auf Google verwalten. Ein Unternehmen kann einem anderen Unternehmen über die OAuth-Einwilligung Zugriff gewähren, um sein Profil in seinem Namen zu verwalten.

Verwaltete Unternehmen in Google Unternehmensprofil wurden bereits über das Bestätigungsverfahren für Unternehmensprofile bestätigt. Sie können den OAuth-Einwilligungsprozess für Unternehmensprofile erweitern, um diese Unternehmen in Business Messages einzubinden und sie automatisch für die Nutzung von Business Messages zu bestätigen.

Dies ist eine skalierbarere und schnellere Methode, um Business Messages zu starten. Sie ist die empfohlene Vorgehensweise, um die Nachrichtenfunktion für einen Unternehmensprofilstandort zu aktivieren.

Vorbereitung

Sie müssen bereits ein Google Unternehmensprofil-Partner mit Zugriff auf die Google Unternehmensprofil-APIs sein. Falls nicht, folgen Sie den Voraussetzungen für das Unternehmensprofil, um Zugriff zu beantragen.

Sobald Sie Zugriff auf die Google Unternehmensprofil API erhalten haben, folgen Sie der grundlegenden Einrichtung und der OAuth-Einrichtung, bevor Sie fortfahren.

Business Messaging für einen bestätigten Standort im Unternehmensprofil aktivieren

Das folgende Diagramm zeigt, wie Ihr Webdienst die Standortbestätigung des Unternehmensprofils einer Marke für einen Kundenservicemitarbeiter von Business Messages nutzen kann. Eine ausführliche Anleitung finden Sie unten.

Ablaufdiagramm für die automatische Bestätigung von Kundenservicemitarbeitern über die Bestätigung des Unternehmensprofils

  1. Aktualisieren Sie in Ihrem vorhandenen OAuth-Einwilligungsprozess, in dem ein Inhaber eines Unternehmensprofil-Kontos Ihnen Zugriff gewährt, die Google Unternehmensprofil APIs in seinem Namen aufzurufen, die API-Bereiche so, dass sie

    • https://www.googleapis.com/auth/business.manage
    • https://www.googleapis.com/auth/businesscommunications

    Beide Zugriffsbereiche sind erforderlich, damit die automatische Bestätigung des Kundenservicemitarbeiters und der Geschäftsstandorte erfolgreich durchgeführt werden kann.

  2. Erstellen Sie einen Kundenservicemitarbeiter mit einer displayName, die mit dem Namen mindestens eines der Google Unternehmensprofil-Einträge übereinstimmt, deren Inhaber die im vorherigen Schritt abgerufenen OAuth-Anmeldedaten sind. Suchen Sie mit der Google Unternehmensprofil API nach Standorten, um die Namen von Unternehmen zu ermitteln.

    Für den Abgleich von Namen gilt:

    • Die Groß- und Kleinschreibung wird nicht berücksichtigt.
    • Der vollständige Name des Kundenservicemitarbeiters muss genau mit dem ersten Wort oder den ersten Wörtern im Standortnamen des Unternehmensprofils übereinstimmen. Ein Agent mit dem Namen „GBP Bäckerei“ würde beispielsweise mit „Gbp Bäckerei Mountain View“, „Gbp Bäckerei“ und „gbp bäckerei sunnyvale“ übereinstimmen, aber nicht mit „Bäckerei San Francisco“.

  3. Erstellen Sie für jeden Standort im Unternehmensprofil einen Standort mit derselben placeId. Die placeId für einen Unternehmensprofilstandort ist im Objekt LocationKey enthalten, wenn ein Standort aus der Google Unternehmensprofil API abgerufen wird.

  4. Fordere mit dem von dir erstellten Agenten und dem erhaltenen OAuth-Token die Bestätigung des Agents an.

    Für den Überprüfungsantrag sind Kontaktdaten der Marke erforderlich. Im Rahmen der Überprüfung wird jedoch keine E-Mail an die Marke gesendet, wenn der Name des Kundenservicemitarbeiters mit dem Namen des Unternehmensprofils übereinstimmt und du das OAuth-Token mit den richtigen Bereichen erhalten hast.

    Wenn Sie dies richtig gemacht haben, sollte die Ausgabe der Bestätigungsanfrage sofort einen verificationState von VERIFICATION_STATE_VERIFIED zurückgeben. Wenn verificationState einen anderen Wert zurückgibt, hast du wahrscheinlich bei der Anfrage nicht das richtige OAuth-Token verwendet oder der Kundenservicemitarbeiter konnte nicht mit einem Unternehmensprofil-Standort abgeglichen werden.

  5. Verwenden Sie dasselbe OAuth-Token, um für alle Standorte, die dem Unternehmen im Unternehmensprofil gehören, die Standortbestätigung anzufordern.

    Wenn Sie alles richtig gemacht haben, sollte die Ausgabe des Bestätigungsantrags wie bei der Bestätigung von Kundenservicemitarbeitern sofort einen verificationState von VERIFICATION_STATE_VERIFIED zurückgeben. Wenn verificationState einen anderen Wert zurückgibt, haben Sie bei der Anfrage wahrscheinlich nicht das richtige OAuth-Token verwendet oder der Standort des Unternehmensprofils ist kein beanspruchtes und bestätigtes Unternehmen.

  6. Starten Sie den Agenten mit dem Einstiegspunkt LOCATION.

  7. Aktivieren Sie die Nachrichtenfunktion für bestimmte Standorte, indem Sie die Orte starten, die in der Google Suche und in Google Maps verfügbar sein sollen. Sobald die Einführung gestartet wurde, sind die Mitteilungen für jeden eingeführten Standort innerhalb weniger Stunden für Nutzer verfügbar.

Nachdem Sie diese Schritte ausgeführt haben, werden alle Nachrichten von Nutzern an Ihren registrierten Business Messages-Webhook gesendet. Sie müssen Antworten an Nutzer mit der Business Messages API senden.