Freigeben über


SmartDialog

SmartDialog ist eine Plattform zum Senden und Empfangen von SMS- und WhatsApp-Nachrichten. Es bietet eine Vielzahl von Smart Messaging-Diensten.

Dieser Connector ist in den folgenden Produkten und Regionen verfügbar:

Dienstleistung Class Regions
Copilot Studio Premium Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche:
     - US Government (GCC)
     - US Government (GCC High)
     - China Cloud betrieben von 21Vianet
     - US Department of Defense (DoD)
Logik-Apps Norm Alle Logik-Apps-Regionen mit Ausnahme der folgenden Bereiche:
     – Azure Government-Regionen
     - Azure China-Regionen
     - US Department of Defense (DoD)
Power Apps Premium Alle Power Apps-Regionen mit Ausnahme der folgenden:
     - US Government (GCC)
     - US Government (GCC High)
     - China Cloud betrieben von 21Vianet
     - US Department of Defense (DoD)
Power Automate Premium Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche:
     - US Government (GCC)
     - US Government (GCC High)
     - China Cloud betrieben von 21Vianet
     - US Department of Defense (DoD)
Kontakt
Name Interaktiver Arena-Support
URL https://www.arenainteractive.fi/contact
Email support@arenainteractive.fi
Connectormetadaten
Herausgeber Arena Interactive Oy
Webseite https://www.arenainteractive.fi
Datenschutzrichtlinie https://www.arenainteractive.fi/privacypolicy
Kategorien Kommunikation; Zusammenarbeit

SmartDialog Connector

Dieser Connector kann zum Senden und Empfangen von SMS-Nachrichten mithilfe der SmartDialog-Plattform verwendet werden.

Voraussetzungen

  1. Ein SmartDialog-Abonnement und -Konto. Bitte wenden Sie sich an sales@arenainteractive.fi
  2. OAuth muss für Ihr Konto aktiviert sein, und ein geheimer Clientschlüssel muss angefordert werden. Dies kann erfolgen, indem Sie uns eine E-Mail senden unter support@arenainteractive.fi.

Konfiguration

  1. Befolgen Sie die Anweisungen unter Erstellen eines benutzerdefinierten Connectors aus einer OpenAPI-Definition.
  2. Erstellen Sie einen Flow oder PowerApp, und fügen Sie eine SmartDialog-Aktion aus dem benutzerdefinierten Abschnitt hinzu. Melden Sie sich mit Ihrem SmartDialog-Konto an.

Unterstützte Aktionen

  • Neue Nachricht (Trigger für den Empfang von Nachrichten)
  • Nachricht senden
  • WhatsApp-Nachricht senden
  • Diskussionsantwortnachricht senden
  • Antwortnachricht senden
  • WhatsApp-Anmeldung
  • WhatsApp Abmelden
  • WhatsApp-Vorlage erstellen
  • Gruppenkontakt abrufen
  • Gruppenkontakt erstellen
  • Gruppenkontakt aktualisieren
  • Gruppenkontakt löschen
  • Alle Gruppenkontakte löschen

Drosselungsgrenzwerte

Name Aufrufe Verlängerungszeitraum
API-Aufrufe pro Verbindung 100 60 Sekunden

Aktionen

Alle Gruppenkontakte löschen

Alle Gruppenkontakte löschen

Antwortnachricht senden

Senden sie eine Antwortnachricht an Empfänger.

Diskussionsantwortnachricht senden

Senden einer Diskussionsantwortnachricht an Empfänger.

Gruppenkontakt abrufen

Gruppenkontakt abrufen

Gruppenkontakt aktualisieren

Gruppenkontakt aktualisieren

Gruppenkontakt erstellen

Gruppenkontakt erstellen

Gruppenkontakt löschen

Löschen eines Gruppenkontakts mithilfe der Telefonnummer.

Nachricht senden

Senden einer Nachricht an Empfänger.

WhatsApp-Nachricht senden

Senden Sie eine WhatsApp-Vorlagennachricht.

WhatsApp Opt In (veraltet) [VERALTET]

WhatsApp Opt In für Absender und Empfänger. (veraltet)

WhatsApp Opt Out (veraltet) [VERALTET]

WhatsApp opt Out für Absender und Empfänger. (veraltet)

WhatsApp-Vorlage erstellen

Erstellen Sie eine neue WhatsApp-Vorlage.

Alle Gruppenkontakte löschen

Alle Gruppenkontakte löschen

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Customer
Customer True string

Der Kunde, für den Gruppendienste abgerufen werden sollen.

Gruppendienst
Group Service True string

Der zu verwendende Gruppendienst.

Gibt zurück

response
boolean

Antwortnachricht senden

Senden sie eine Antwortnachricht an Empfänger.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
ParentMessage-ID
ParentMessageId True string

Die ID der übergeordneten Nachricht, auf die sie antworten soll.

Customer
Customer-Id True string

Der Kunde, der zum Senden verwendet werden soll.

Dienstleistung
Service-Id True string

Der Dienst, der zum Senden verwendet werden soll.

Absender der Nachricht
Sender True string

Der Absender der Nachricht kann alphanumerisch, langer Code oder kurzer Code sein (Einschränkungen gelten).

Nachrichteninhalt
Content True string

Der Inhalt der Nachricht.

Nachrichtenprotokoll
Protocol True string

Das Protokoll, das zum Senden der Nachricht verwendet werden soll.

Datumsangabe senden
SendDateTime date-time

Das Datum und die Uhrzeit zum Senden der Nachricht. Lassen Sie leer, um sofort zu senden.

Adresse
Address True string

Adresse des Nachrichtenempfängers.

Anlagen-URI
AttachmentUri string

Anlagen-URI, der beim Senden einer WhatsApp-Nachricht verwendet werden soll, die eine Anlage enthält.

Kundendaten
CustomerData string

Abrechnungs-/Gruppierungsdaten für diese Nachricht, optional.

Anzeigennachricht
AdMessage boolean

Optionales Außerkraftsetzungskennzeichen zum Markieren der Nachricht als Anzeigennachricht

Dlr-URL
DlrUrl string

URL für den Übermittlungsstatusrückruf über http-get. Sie können url-Werte für Abfragezeichenfolgen hinzufügen, die beibehalten werden.

Anforderungs-ID
RequestId string

Optionale eindeutige Anforderungs-ID, die zum Identifizieren doppelter Anforderungen verwendet werden kann. Wenn eine doppelte Anforderungs-ID erkannt wird, wird das Senden abgebrochen. Es gibt keine Garantie, dass Anforderungen mit doppelten Anforderungs-IDs in Situationen mit hohem Durchsatz/Datenverkehr blockiert werden. Die angegebene requestId wird 7 Tage lang "gespeichert" werden.

Gibt zurück

Name Pfad Typ Beschreibung
Nachrichten-ID
MessageId string

Der Bezeichner der neu erstellten Nachricht.

Anzahl der Nachrichtenteils
MessagePartCount integer

Ungefähre Anzahl von Nachrichtenteilen für diese Nachricht.

Empfänger
Recipients array of object

Empfänger

Empfängeradresse
Recipients.Address string

Empfängeradresse (Telefonnummer/E-Mail/Benutzer-ID usw.).

Empfänger-ID
Recipients.Id string

Empfängerbezeichner, der für den Empfang von Übermittlungsstatusinformationen verwendet wird.

Diskussionsantwortnachricht senden

Senden einer Diskussionsantwortnachricht an Empfänger.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Customer
CustomerId True string

Der Kunde, der zum Senden verwendet werden soll.

Thread-ID
ThreadId True string

ID des vorhandenen Threads, auf den zu antworten ist.

Nachrichteninhalt
Content True string

Der Inhalt der Nachricht.

Kundendaten
CustomerData string

Abrechnungs-/Gruppierungsdaten für diese Nachricht, optional.

Gibt zurück

Name Pfad Typ Beschreibung
Nachrichten-ID
MessageId string

Der Bezeichner der neu erstellten Nachricht.

Anzahl der Nachrichtenteils
MessagePartCount integer

Ungefähre Anzahl von Nachrichtenteilen für diese Nachricht.

Empfänger
Recipients array of object

Empfänger

Empfängeradresse
Recipients.Address string

Empfängeradresse (Telefonnummer/E-Mail/Benutzer-ID usw.).

Empfänger-ID
Recipients.Id string

Empfängerbezeichner, der für den Empfang von Übermittlungsstatusinformationen verwendet wird.

ThreadId
ThreadId string

Bezeichner des Threads, an den die Nachricht gesendet wurde.

Gruppenkontakt abrufen

Gruppenkontakt abrufen

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Customer
Customer True string

Der Kunde, für den Gruppendienste abgerufen werden sollen.

Gruppendienst
Group Service True string

Der zu verwendende Gruppendienst.

Telefonnummer
Phone True string

Die Telefonnummer des Kontakts.

Region
Region string

Optionaler Telefonnummernbereich, der zum Analysieren der Telefonnummer verwendet werden soll.

Gibt zurück

Name Pfad Typ Beschreibung
Telefonnummer
phone string

Telefonnummer des Kontakts.

Email
email string

E-Mail-Adresse des Kontakts.

Vorname
firstName string

Vorname des Kontakts.

Nachname
lastName string

Nachname des Kontakts.

Geschlecht
gender string

Geschlecht des Kontakts.

Geburtsjahr
birthYear integer

Geburtsjahr des Kontakts.

Anschrift
streetAddress string

Straße des Kontakts.

PLZ
zipCode string

Postleitzahl des Kontakts.

Stadt
city string

Ort des Kontakts.

Ländercode
countryCode string

Ländervorwahl des Kontakts.

Fehlgeschlagene Nachrichten
failedMessages integer

Anzahl der fehlgeschlagenen Nachrichten für den Kontakt.

Benutzerdefinierte Eigenschaften
customContactProperties array of object

Die Sammlung der benutzerdefinierten Kontakteigenschaft, die für den Kontakt gespeichert wurde.

Name
customContactProperties.name string

Name der benutzerdefinierten Kontakteigenschaft.

Wert
customContactProperties.value string

Wert der benutzerdefinierten Kontakteigenschaft.

Gruppenkontakt aktualisieren

Gruppenkontakt aktualisieren

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Customer
Customer True string

Der Kunde, für den Gruppendienste abgerufen werden sollen.

Gruppendienst
Group Service True string

Der zu verwendende Gruppendienst.

Telefonnummer
Phone True string

Die Telefonnummer des zu aktualisierenden Kontakts.

Active
active boolean

Flag, das angibt, ob der Kontakt aktiv ist.

Email
email string

E-Mail-Adresse des Kontakts.

Vorname
firstName string

Vorname des Kontakts.

Nachname
lastName string

Nachname des Kontakts.

Geschlecht
gender string

Geschlecht des Kontakts.

Geburtsjahr
birthYear integer

Geburtsjahr des Kontakts.

Anschrift
streetAddress string

Straße des Kontakts.

PLZ
zipCode string

Postleitzahl des Kontakts.

Stadt
city string

Ort des Kontakts.

Ländercode
countryCode string

3-Buchstaben Landesvorwahl des Kontakts.

Name
name string

Name der benutzerdefinierten Kontakteigenschaft.

Wert
value string

Wert der benutzerdefinierten Kontakteigenschaft.

Telefonnummernregionen
phoneNumberRegions array of string

Telefonnummernbereiche, die für die Analyse von Nummern verwendet werden sollen. Wenn sie leer gelassen wird, wird der Standardwert für Finnland festgelegt.

Gibt zurück

response
boolean

Gruppenkontakt erstellen

Gruppenkontakt erstellen

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Customer
Customer True string

Der Kunde, für den Gruppendienste abgerufen werden sollen.

Gruppendienst
Group Service True string

Der zu verwendende Gruppendienst.

Active
active boolean

Flag, das angibt, ob der Kontakt aktiv ist.

Telefonnummer
phone True string

Telefonnummer des Kontakts.

Email
email string

E-Mail-Adresse des Kontakts.

Vorname
firstName string

Vorname des Kontakts.

Nachname
lastName string

Nachname des Kontakts.

Geschlecht
gender string

Geschlecht des Kontakts.

Geburtsjahr
birthYear integer

Geburtsjahr des Kontakts.

Anschrift
streetAddress string

Straße des Kontakts.

PLZ
zipCode string

Postleitzahl des Kontakts.

Stadt
city string

Ort des Kontakts.

Ländercode
countryCode string

3-Buchstaben Landesvorwahl des Kontakts.

Name
name string

Benutzerdefinierter Eigenschaftenname.

Wert
value string

Benutzerdefinierter Eigenschaftswert.

Telefonnummernregionen
phoneNumberRegions array of string

Telefonnummernbereiche, die für die Analyse von Nummern verwendet werden sollen. Wenn sie leer gelassen wird, wird der Standardwert für Finnland festgelegt.

Gibt zurück

Eindeutige ID des erstellten Kontakts.

Kontakt-ID
uuid

Gruppenkontakt löschen

Löschen eines Gruppenkontakts mithilfe der Telefonnummer.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Customer
Customer True string

Der Kunde, für den Gruppendienste abgerufen werden sollen.

Gruppendienst
Group Service True string

Der zu verwendende Gruppendienst.

Telefonnummer
Phone True string

Die Telefonnummer des zu löschenden Kontakts.

Gibt zurück

response
boolean

Nachricht senden

Senden einer Nachricht an Empfänger.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Customer
Customer-Id True string

Der Kunde, der zum Senden verwendet werden soll.

Dienstleistung
Service-Id True string

Der Dienst, der zum Senden verwendet werden soll.

Absender der Nachricht
Sender True string

Der Absender der Nachricht kann alphanumerisch, langer Code oder kurzer Code sein (Einschränkungen gelten).

Nachrichteninhalt
Content True string

Der Inhalt der Nachricht.

Nachrichtenprotokoll
Protocol True string

Das Protokoll, das zum Senden der Nachricht verwendet werden soll.

Datumsangabe senden
SendDateTime date-time

Das Datum und die Uhrzeit zum Senden der Nachricht. Lassen Sie leer, um sofort zu senden.

Adresse
Address True string

Adresse des Nachrichtenempfängers.

Anlagen-URI
AttachmentUri string

Anlagen-URI, der beim Senden einer WhatsApp-Nachricht verwendet werden soll, die eine Anlage enthält.

Kundendaten
CustomerData string

Abrechnungs-/Gruppierungsdaten für diese Nachricht, optional.

Anzeigennachricht
AdMessage boolean

Optionales Außerkraftsetzungskennzeichen zum Markieren der Nachricht als Anzeigennachricht

Dlr-URL
DlrUrl string

URL für den Übermittlungsstatusrückruf über http-get. Sie können url-Werte für Abfragezeichenfolgen hinzufügen, die beibehalten werden.

Anforderungs-ID
RequestId string

Optionale eindeutige Anforderungs-ID, die zum Identifizieren doppelter Anforderungen verwendet werden kann. Wenn eine doppelte Anforderungs-ID erkannt wird, wird das Senden abgebrochen. Es gibt keine Garantie, dass Anforderungen mit doppelten Anforderungs-IDs in Situationen mit hohem Durchsatz/Datenverkehr blockiert werden. Die angegebene requestId wird 7 Tage lang "gespeichert" werden.

Gibt zurück

Name Pfad Typ Beschreibung
Nachrichten-ID
MessageId string

Der Bezeichner der neu erstellten Nachricht.

Anzahl der Nachrichtenteils
MessagePartCount integer

Ungefähre Anzahl von Nachrichtenteilen für diese Nachricht.

Empfänger
Recipients array of object

Empfänger

Empfängeradresse
Recipients.Address string

Empfängeradresse (Telefonnummer/E-Mail/Benutzer-ID usw.).

Empfänger-ID
Recipients.Id string

Empfängerbezeichner, der für den Empfang von Übermittlungsstatusinformationen verwendet wird.

WhatsApp-Nachricht senden

Senden Sie eine WhatsApp-Vorlagennachricht.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Customer
Customer-Id True string

Der Kunde, der zum Senden verwendet werden soll.

Dienstleistung
Service-Id True string

Der Dienst, der zum Senden verwendet werden soll.

WhatsApp-Vorlage
TemplateName True string

Die Vorlage, die zum Senden verwendet werden soll.

Adresse
Address True string

Adresse des Nachrichtenempfängers.

BodyParameters
BodyParameters array of string

BodyParameters

HeaderParameters
HeaderParameters array of string

HeaderParameters

Typ
Type string

Der Schaltflächentyp. Pro Vorlage darf nur ein Typ pro Vorlage ein Vielfaches desselben Typs enthalten.

Text
Data string

Der Text der Schaltfläche.

Datumsangabe senden
SendDateTime string

Das Datum und die Uhrzeit zum Senden der Nachricht. Lassen Sie leer, um sofort zu senden.

Anlagen-URI
AttachmentUri string

Der Anlagen-URI, wenn die Vorlage eine Anlage enthält.

Verwenden von SMS-Fallback
UseSmsFallback boolean

Sollte SMS als Fallback verwendet werden.

Dlr-URL
DlrUrl string

Url des Übermittlungsberichts, der einen Rückruf empfängt, wenn der Sendevorgang abgeschlossen ist.

Kundendaten
CustomerData string

Abrechnungs-/Gruppierungsdaten für diese Nachricht, optional.

Anforderungs-ID
RequestId string

Optionale eindeutige Anforderungs-ID, die zum Identifizieren doppelter Anforderungen verwendet werden kann. Wenn eine doppelte Anforderungs-ID erkannt wird, wird das Senden abgebrochen. Es gibt keine Garantie, dass Anforderungen mit doppelten Anforderungs-IDs in Situationen mit hohem Durchsatz/Datenverkehr blockiert werden. Die angegebene requestId wird 7 Tage lang "gespeichert" werden.

Gibt zurück

Name Pfad Typ Beschreibung
Nachrichten-ID
messageId string

Der Bezeichner der neu erstellten Nachricht.

Anzahl der Nachrichtenteils
messagePartCount integer

Ungefähre Anzahl von Nachrichtenteilen für diese Nachricht.

recipients
recipients array of object

recipients

Empfängeradresse
recipients.address string

Empfängeradresse (Telefonnummer/E-Mail/Benutzer-ID usw.).

Empfänger-ID
recipients.id string

Empfängerbezeichner, der für den Empfang von Übermittlungsstatusinformationen verwendet wird.

WhatsApp Opt In (veraltet) [VERALTET]

WhatsApp Opt In für Absender und Empfänger. (veraltet)

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Absenderadresse
Sender True string

Registrierte Whatsapp-Identitätsnummer zum Anmelden.

Empfängeradresse
Recipient True string

Empfängernummer zum Anmelden.

WhatsApp Opt Out (veraltet) [VERALTET]

WhatsApp opt Out für Absender und Empfänger. (veraltet)

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Absenderadresse
Sender True string

Registrierte Whatsapp-Identitätsnummer zum Abmelden von.

Empfängeradresse
Recipient True string

Rezeptnummer, die aus der Anmeldung entfernt werden soll.

WhatsApp-Vorlage erstellen

Erstellen Sie eine neue WhatsApp-Vorlage.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Customer
Customer-Id True string

Der Kunde, für den die Vorlage erstellt werden soll.

IdentityNumber
IdentityNumber True string

WhatsApp IdentityNumber wird für die Vorlage verwendet.

Anzeigename
DisplayName True string

Anzeigename der Vorlage.

Content
RawContent True string

Vorlageninhalt.

Vorlagenkategorie
Category True string

Vorlagenkategorie.

Vorlagensprache
Language True string

2-stelligen Code für die Vorlagensprache.

Schaltflächentyp
Type string

Typ der Schaltfläche.

Schaltflächenbezeichnung
Label string

Schaltflächenbezeichnung.

Schaltflächendaten
Data string

Schaltflächendaten. URL (URL), Telefonnummer (Anruf) oder Text (QuickReply). Die maximale Länge beträgt 2000 für URL und 20 für Telefonnummer und Text.

Anlagen-URL
AttachmentUrl string

URL zu einer Beispielanlage.

Auslöser

Neue Nachricht

Wenn eine neue Nachricht zu einem 2-Wege-Dienst eintrifft.

Neue Nachricht

Wenn eine neue Nachricht zu einem 2-Wege-Dienst eintrifft.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Customer
Customer True string

Der Zu verwendende Kunde.

Dienstleistung
Service True string

Der zu verwendende 2-Wege-Dienst.

Gibt zurück

Name Pfad Typ Beschreibung
Absender der Nachricht
sender string

Der Absender der Nachricht.

Nachrichtenempfänger
recipient string

Der Empfänger der Nachricht.

Nachrichteninhalt
content string

Der Inhalt der empfangenen Nachricht.

Nachrichtenzeitstempel
timestamp date-time

Der Zeitstempel der Nachricht.

Nachrichtenprotokoll
protocol string

Das Protokoll der empfangenen Nachricht.

attachments
attachments array of object

attachments

Dateiname der Anlage
attachments.name string

Der Dateiname der Anlage.

Anlagen-MIME-Typ
attachments.mimeType string

Der MIME-Typ der Anlage.

Speicherort der Anlageressource
attachments.resourceLocation string

Der Speicherort der Anlageressource.

Nachrichten-ID
messageId string

Die eindeutige Nachrichten-ID der empfangenen Nachricht.

Definitionen

Universelle eindeutige Kennung (UUID)

Eindeutige ID des erstellten Kontakts.

Eindeutige ID des erstellten Kontakts.

Kontakt-ID
uuid

boolean

Dies ist der grundlegende Datentyp "boolean".