Registrieren Ihres Diensts beim Entwicklerdashboard für Nachrichten mit Aktionen

Um Nachrichten mit Aktionen von Ihrem Dienst zu testen und zu veröffentlichen, müssen Sie bestimmte Informationen an Microsoft weitergeben, um diese Funktionalität für E-Mails von Ihrem Dienst zu aktivieren. Mit dem Entwicklerdashboard können Sie den Status Ihrer Übermittlung über das Webportal übermitteln und verfolgen.

Wenn Sie ein Entwickler sind und mit Nachrichten mit Aktionen per E-Mail arbeiten, verwenden Sie das Portal für die folgenden Fälle:

  • Zum Testen von Nachrichten mit Aktionen von Ihrem Dienst an Ihr eigenes Postfach
  • Zum Veröffentlichen von Nachrichten mit Aktionen von Ihrem Dienst, damit jeder E-Mail-Benutzer in Office 365, der Ihren Dienst verwendet, diese speziell formatierten Nachrichten empfangen kann
  • Zum Veröffentlichen von Nachrichten mit Aktionen von Ihrem Dienst, damit jeder E-Mail-Benutzer innerhalb Ihrer Organisation, der Office 365 verwendet, diese speziell formatierten Nachrichten empfangen kann (dies wird in der Regel zum Aktivieren von Nachrichten mit Aktionen von einem Dienst verwendet, der für Ihre Organisation spezifisch ist, z. B. eine Branchen-App)

Für die oben genannten Fälle übermitteln Sie bestimmte Details an Microsoft, die, nach Prüfung und Genehmigung, Nachrichten mit Aktionen für Ihren Dienst aktivieren.

Hinweis

Sie können Nachrichten mit Aktionen ganz einfach ausprobieren, indem Sie eine E-Mail an sich selbst mit dem erforderlichen Markup ohne jegliche Intervention von Microsoft senden. Dies wäre in der Regel der erste Schritt, den Sie im Zusammenhang mit dieser Funktion ausprobieren. Sehen Sie sich die folgenden Beispiele an, um eine Nachricht mit Aktionen an Ihr Postfach zu senden, oder verwenden Sie Karten-Playground, um Nachrichten mit Aktionen an sich selbst zu senden.

Dashboardbereiche

Das Entwicklerdashboard ist in ein paar logische Bereiche unterteilt, die Sie basierend auf dem Umfang angeben müssen, den Sie von Microsoft anfordern möchten, um Nachrichten mit Aktionen von Ihrem Dienst zu aktivieren.

Details zu Ihrem Anbieter

In diesem Bereich müssen Sie wichtige Informationen angeben, mit denen Office 365 E-Mail mit Markup von Ihrem Dienst sowie URLs akzeptieren kann, die über die Aktionsschaltflächen in diesen E-Mail aufgerufen werden können.

Die wichtigsten Felder sind:

  • E-Mail-Adresse des Absenders: Hierbei handelt es sich um eine oder mehrere statische E-Mail-Adressen, die dem Dienst entsprechen, der E-Mails mit Aktions-Markup sendet. Beispiel: myservice@contoso.com.
  • Ziel-URLs: Hierbei handelt es sich um eine oder mehrere Domänen, die URLs entsprechen, die die Aktionen verarbeiten. Ihre Ziel-URL kann der Domäne auf oberster Ebene oder der Unterdomäne des TLD entsprechen. Es muss sich um https-fähige URLs handeln. Beispiel: https://api.myservice.com.

Umfang Ihrer Übermittlung

In diesem Bereich müssen Sie angeben, in welchem Umfang Sie Nachrichten mit Aktionen für Ihren Dienst aktivieren möchten. Die anwendbaren Bereiche sind:

  • Mein Postfach: Dadurch werden Nachrichten mit Aktionen von Ihrem Dienst aktiviert, die an Ihr eigenes Postfach gesendet werden.
  • Global: Dadurch werden Nachrichten mit Aktionen von Ihrem Dienst für einen beliebigen E-Mail-Benutzer in Office 365 aktiviert.
  • Meine Organisation: Dadurch werden Nachrichten mit Aktionen von Ihrem Dienst an einen Office 365-E-Mail-Benutzer innerhalb Ihrer Organisation aktiviert. Dieser Umfang wird in der Regel zum Aktivieren von Nachrichten mit Aktionen von einem Dienst verwendet, der für Ihre Organisation spezifisch ist, z. B. eine interne Branchenanwendung in Ihrer Organisation.

Die oben aufgeführten Schritte sind voneinander unabhängig, d. h. Sie können nur einen Umfang für jede Übermittlung auswählen und unterliegen dem Genehmigungsprozess von Microsoft.

Hinweis

Beachten Sie, dass Sie Nachrichten mit Aktionen ganz einfach ausprobieren können, indem Sie eine E-Mail an sich selbst mit dem erforderlichen Markup ohne jegliche Intervention von Microsoft senden. Sie können Karten-Playground verwenden, um eine solche Nachricht an sich selbst zu senden, ohne dass Code erforderlich ist. Dies ist normalerweise der erste Schritt beim Testen von Nachrichten mit Aktionen.

Kontaktinformationen

In diesem Bereich müssen Sie Kontaktdetails angeben, damit wir uns an Sie wenden können, wenn wir weitere Fragen zu Ihrer Übermittlung haben. Alle Angaben müssen gültig und korrekt sein.

Herausgeberinformationen

Dieser Bereich trifft nur zu, wenn der Umfang der Übermittlung zum Aktivieren von Nachrichten mit Aktionen Global lautet.

In diesem Bereich müssen Sie Informationen zu Ihrem Dienst angeben, der Nachrichten mit Aktionen und damit im Zusammenhang stehende Supportinformationen senden wird, damit wir uns an Sie wenden oder Kunden zu Ihrer Supportwebsite weiterleiten können. Diese Informationen werden auch im Rahmen des Genehmigungsprozesses von Microsoft für Ihren Anbieter verwendet.

Szenarioinformationen

Dieser Bereich trifft nur zu, wenn der Umfang der Übermittlung zum Aktivieren von Nachrichten mit Aktionen Global lautet.

In diesem Bereich müssen Sie Informationen zum Szenario, für das Benutzer Nachrichten mit Aktionen von Ihrem Dienst verwenden werden, sowie andere relevante Informationen angeben. Dies soll Microsoft helfen, die Gültigkeit und Nützlichkeit der von Ihrem Dienst bereitgestellten Lösung zu bestimmen.

Überprüfungsinformationen

Dieser Bereich trifft nur zu, wenn der Umfang der Übermittlung zum Aktivieren von Nachrichten mit Aktionen Global lautet.

In diesem Bereich müssen Sie Details für Microsoft zum Überprüfen der Nachrichten mit Aktionen und der entsprechenden Aktionen angeben, die von der an Ihren Anbieter/Dienst gesendeten E-Mail aufgerufen werden.

Senden Sie außerdem eine gültige E-Mail von Ihren Produktionsservern (oder von einem Server mit ähnlichen DKIM/SPF/From:/Return-Path:-Kopfzeilen), einschließlich des Markups an  amverify@microsoft.com. So kann Microsoft feststellen, ob die Lösung allen in den Registrierungskriterien aufgeführten Richtlinien und Anforderungen entspricht.

  • Stellen Sie vor dem Senden der Nachricht sicher, dass das Markup korrekt ist.
  • Office 365 entfernt das gesamte Markup beim Weiterleiten einer E-Mail-Nachricht. Leiten Sie keine E-Mails weiter, sondern senden Sie sie direkt.

Registrierungskriterien

Es gibt einige Dinge, die Sie beachten müssen, wenn Sie Ihre Lösung zur Genehmigung für den UmfangGlobal übermitteln, da dies wesentliche Auswirkungen auf Benutzer in Office 365 haben kann.

Qualitätsrichtlinien für E-Mail-Absender

  • E-Mail-Nachrichten müssen über DKIM oder SPF authentifiziert werden.
  • Die Domäne die obersten Ebene (TLD) der SPF-Prüfung oder die DKIM-Signatur muss der TLD Ihrer From:-E-Mail-Adresse entsprechen. Wenn Sie beispielsweise From: myservice@contoso.com verwenden, muss die DKIM oder SPF für contoso.com oder subdomain.contoso.com sein.
  • E-Mails müssen von einer statischen E-Mail Adresse stammen, z. B. myservice@contoso.com.
  • E-Mails müssen den Richtlinien für E-Mail-Absender entsprechen.
  • Konsistenter Verlauf des Sendens eines großen E-Mail-Volumens von Ihrer Domäne (in der Größenordnung von mindestens hundert E-Mails pro Tag an Office 365) für mindestens ein paar Wochen.
  • Eine sehr niedrige Rate von Spambeschwerden von Benutzern.
  • Es sollten sehr präzise, routinemäßige und einfache Aktionen, die für Ihren Dienst verfügbar sind, verwendet werden. Für komplexere Interaktionen können OpenURI-Aktionen verwendet werden.
  • Aktionen sollten für Transaktions-E-Mails verwendet werden, bei denen eine hohe Interaktionsrate erwartet wird. Sie sollten nicht für Massen-E-Mails zu Werbezwecken verwendet werden.

Aktionsrichtlinien

  • Die Bezeichnung der Schaltfläche muss klar die Aktion darstellen, die ausgeführt werden soll.
  • Die OpenURI-Aktion muss als Deep-Link für die jeweilige Seite fungieren, die der in der Nachricht mit Aktionen dargestellten Entität/Information zugeordnet ist.
  • Niedrige Fehlerrate und schnelle Reaktion für Dienste, die Aktionsanforderungen verarbeiten.
  • Lesen Sie die Kartenreferenz, um Informationen zu weiteren Richtlinien zum Entwerfen von Nachrichten mit Aktionen zu erhalten.

Genehmigung Ihrer Übermittlung

Sie erhalten eine Benachrichtigung an die E-Mail-Adresse, die Sie bei der Übermittlung angegeben haben, stellen Sie daher sicher, dass Sie die korrekten Kontaktinformationen angeben.