Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Dieses Dokument enthält Anleitungen zum Senden von WhatsApp-Vorlagennachrichten mithilfe des Advanced Communication Messages-SDK.
Warum muss ich eine Vorlagennachricht senden?
Ein Unternehmen kann Vorlagennachrichten nur senden, bis der Benutzer eine Nachricht an das Unternehmen sendet.
Ein Unternehmen oder ein Benutzer kann ein Unterhaltungsfenster initiieren, aber das Unternehmen ist auf die Art von Nachrichten beschränkt, die er senden kann. Erst nachdem der Benutzer eine Nachricht an das Unternehmen gesendet hat, darf das Unternehmen während der aktiven Unterhaltung Text- oder Mediennachrichten an den Benutzer senden. Nach Ablauf des 24-Stunden-Fensters muss die Unterhaltung erneut eingeleitet werden. Weitere Informationen zu Unterhaltungen finden Sie in der Definition auf der WhatsApp Business-Platform.
Weitere WhatsApp-Anforderungen für Vorlagen finden Sie in den Verweisen auf die WhatsApp Business-Platform-API:
- Erstellen und Verwalten von Vorlagen
- Vorlagenkomponenten
- Senden von Vorlagennachrichten
- Unternehmen müssen auch die Opt-In-Anforderungen einhalten, bevor Sie Nachrichten an WhatsApp-Benutzer senden
Auswählen einer Vorlage
Wenn Sie ein WhatsApp Business-Konto über das Azure-Portal während der eingebetteten Anmeldung erstellen, stehen Ihnen eine Reihe von Beispielvorlagen zur Verfügung.
Erstellen der Vorlage
Verwenden Sie den Meta WhatsApp-Manager, um eigene Vorlagen zu erstellen.
Befolgen Sie die Anweisungen im Meta Business Help Center unter Erstellen von Nachrichtenvorlagen für Ihr WhatsApp Business-Konto.
Auflisten von Vorlagen
Sie können Ihre Vorlagen im Azure-Portal anzeigen, indem Sie zu Ihrer Azure Communication Service-Ressource >Vorlagen wechseln.
Wählen Sie eine Vorlage aus, um die Details anzuzeigen.
Das content-Feld der Vorlagendetails kann Parameterbindungen enthalten. Die Parameterbindungen können folgendermaßen angegeben werden:
- Ein
format-Feld mit einem Wert, z. B.IMAGE. - Doppelte Klammern, die eine Zahl umgeben, z. B.
{{1}}. Die Zahl, die mit 1 indiziert wurde, gibt die Reihenfolge an, in der die Bindungswerte angegeben werden müssen, um die Nachrichtenvorlage zu erstellen. - Doppelte Klammern, die einen Namen wie
{{movie_name}}umgeben. Mit den benannten Parametern können Entwickler anstelle der Position auf Parameter verweisen.Von Bedeutung
Wenn Sie benannte Parameter verwenden, müssen Sie sicherstellen, dass der Name, den Sie beim Senden der Nachricht verwenden, genau mit dem Namen übereinstimmt , der in der Vorlage definiert ist, die Sie im Meta WhatsApp-Manager erstellt haben.
Alternativ können Sie alle Vorlagen Ihres WhatsApp Business-Kontos in den Nachrichtenvorlagen in WhatsApp Manager>Konto-Tools>Nachrichtenvorlagen anzeigen und bearbeiten.
Um Ihre Vorlagen programmgesteuert auflisten zu können, können Sie alle Vorlagen für Ihre Kanal-ID abrufen:
MessageTemplateClient messageTemplateClient = new MessageTemplateClient(connectionString);
Pageable<MessageTemplateItem> templates = messageTemplateClient.GetTemplates(channelRegistrationId);
Kurzreferenz
sample_template akzeptiert keine Parameter.
Erstellen Sie MessageTemplate, indem Sie auf den Namen und die Sprache der Zielvorlage verweisen.
string templateName = "sample_template";
string templateLanguage = "en_us";
var sampleTemplate = new MessageTemplate(templateName, templateLanguage);
Ausführliche Beispiele und Vorlagenszenarien, die vom Advanced Messages SDK unterstützt werden, finden Sie unter: