SmartDialog

Met SmartDialog kunnen organisaties sms- en WhatsApp-berichten verzenden en ontvangen via geautomatiseerde werkstromen. Het ondersteunt berichtsjablonen, delivery tracking en conversationele interacties. Vereist een SmartDialog-account met API-toegang en geconfigureerde kanalen. Levering is afhankelijk van het beleid van provider en WhatsApp. Voor sommige functies zijn specifieke abonnementslagen vereist.

Deze connector is beschikbaar in de volgende producten en regio's:

Dienst	Class	Regions
Copilot Studio	Premium	Alle Power Automate-regio's , met uitzondering van het volgende: - Amerikaanse overheid (GCC) - Amerikaanse overheid (GCC High) - China Cloud beheerd door 21Vianet - Us Department of Defense (DoD)
Logic-apps	Standaard	Alle Logic Apps-regio's , met uitzondering van het volgende: - Azure Government-regio's - Azure China-regio's - Us Department of Defense (DoD)
Power Apps	Premium	Alle Power Apps-regio's , met uitzondering van het volgende: - Amerikaanse overheid (GCC) - Amerikaanse overheid (GCC High) - China Cloud beheerd door 21Vianet - Us Department of Defense (DoD)
Power Automate	Premium	Alle Power Automate-regio's , met uitzondering van het volgende: - Amerikaanse overheid (GCC) - Amerikaanse overheid (GCC High) - China Cloud beheerd door 21Vianet - Us Department of Defense (DoD)

Contactpersoon
Naam	Arena Interactive Support
URL	https://www.arenainteractive.fi/contact
E-mailen	support@arenainteractive.fi

Connectormetagegevens
Uitgever	Arena Interactive Oy
Webpagina	https://www.arenainteractive.fi
Privacybeleid	https://www.arenainteractive.fi/privacypolicy
Categorieën	Communicatie; Samenwerking

SmartDialog-connector

Deze connector kan worden gebruikt voor het verzenden en ontvangen van sms-berichten via het SmartDialog-platform.

Vereiste voorwaarden

Een SmartDialog-abonnement en -account. Neem contact op met sales@arenainteractive.fi
OAuth moet zijn ingeschakeld voor uw account en er moet een clientgeheim worden aangevraagd. Dit kan worden gedaan door ons een e-mail te sturen op support@arenainteractive.fi.

Configuratie

Volg de instructies in Een aangepaste connector maken op basis van een OpenAPI-definitie.
Maak een stroom of PowerApp en voeg een SmartDialog-actie toe vanuit de aangepaste sectie. Meld u aan met uw SmartDialog-account.

Ondersteunde acties

Nieuw bericht (trigger voor het ontvangen van berichten)
Bericht verzenden
WhatsApp-bericht verzenden
Discussieantwoordbericht verzenden
Antwoordbericht verzenden
WhatsApp Opt In
WhatsApp Opt-out
WhatsApp-sjabloon maken
Groepscontactpersoon ophalen
Groepscontactpersoon maken
Groepscontactpersoon bijwerken
Groepscontactpersoon verwijderen
Alle groepscontactpersonen verwijderen

Beperkingslimieten

Naam	Aanroepen	Verlengingsperiode
API-aanroepen per verbinding	100	60 seconden

Acties

Alle groepscontactpersonen verwijderen	Alle groepscontactpersonen verwijderen
Antwoordbericht verzenden	Verzend een replymessage naar geadresseerden.
Bericht verzenden	Een bericht verzenden naar geadresseerden.
Discussieantwoordbericht verzenden	Verzend een bericht over het beantwoorden van een discussie naar geadresseerden.
Groepscontactpersoon bijwerken	Groepscontactpersoon bijwerken
Groepscontactpersoon maken	Groepscontactpersoon maken
Groepscontactpersoon ophalen	Groepscontactpersoon ophalen
Groepscontactpersoon verwijderen	Groepscontactpersoon verwijderen met telefoonnummer.
WhatsApp-bericht verzenden	WhatsApp-sjabloonbericht verzenden.
WhatsApp Opt In (afgeschaft) [AFGESCHAFT]	WhatsApp Opt In voor afzender en geadresseerde. (afgeschaft)
WhatsApp Opt Out (afgeschaft) [AFGESCHAFT]	WhatsApp Opt Out voor afzender en geadresseerde. (afgeschaft)
WhatsApp-sjabloon maken	Maak een nieuwe WhatsApp-sjabloon.

Alle groepscontactpersonen verwijderen

Bewerkings-id:: DeleteAllGroupContacts

Alle groepscontactpersonen verwijderen

Parameters

Naam	Sleutel	Vereist	Type	Description
Customer	Customer	True	string	De klant waarvoor groepsservices moeten worden opgehaald.
Groepsservice	Group Service	True	string	De te gebruiken groepsservice.

Retouren

response: boolean

Antwoordbericht verzenden

Bewerkings-id:: SendReplyMessage

Verzend een replymessage naar geadresseerden.

Parameters

Naam	Sleutel	Vereist	Type	Description
ParentMessage-id	ParentMessageId	True	string	De id van het bovenliggende bericht dat moet worden beantwoord.
Customer	Customer-Id	True	string	De klant die moet worden gebruikt voor verzending.
Dienst	Service-Id	True	string	De service die moet worden gebruikt voor verzending.
Afzender van bericht	Sender	True	string	De afzender van het bericht kan alfanumerieke, lange code of korte code zijn (beperkingen zijn van toepassing).
Berichtinhoud	Content	True	string	De inhoud van het bericht.
Message Protocol	Protocol	True	string	Het protocol dat moet worden gebruikt voor het verzenden van het bericht.
Datum/tijd verzenden	SendDateTime		date-time	De datum en tijd waarop het bericht moet worden verzonden. Laat leeg om direct te verzenden.
Adres	Address	True	string	Adres van geadresseerde van bericht.
Bijlage-URI	AttachmentUri		string	Bijlage-URI die moet worden gebruikt bij het verzenden van Een WhatsApp-bericht dat een bijlage bevat.
Klantgegevens	CustomerData		string	Facturerings-/groeperingsgegevens voor dit bericht, optioneel.
Advertentiebericht	AdMessage		boolean	Optioneel overschrijven vlag voor het markeren van het bericht als een advertentiebericht
Dlr-URL	DlrUrl		string	URL voor callback van leveringsstatus via http-get. U kunt querytekenreekswaarden toevoegen aan de URL. Ze blijven behouden.
Aanvraag-id	RequestId		string	Optionele unieke aanvraag-id die kan worden gebruikt om dubbele aanvragen te identificeren. Als er een dubbele aanvraag-id wordt gedetecteerd, wordt het verzenden geannuleerd. Er is geen garantie dat aanvragen met dubbele aanvraag-id's worden geblokkeerd in situaties met hoge doorvoer/verkeer. De opgegeven requestId wordt gedurende 7 dagen 'onthouden'.
Unicode-beleid voor het verwerken van tekens	UnicodeCharacterHandlingPolicy		string	Beleid voor het afhandelen van Unicode-tekens (alleen sms-protocol). De standaardwaarde is Geen (niet valideren of vervangen), Strikt resulteert in een validatiefout als er Unicode-tekens aanwezig zijn in de berichtinhoud. Vervangen vervangt Unicode-tekens door zowel look-alike tekens als vraagtekens (?)

Retouren

Naam	Pad	Type	Description
Bericht-id	MessageId	string	De id van het zojuist gemaakte bericht.
Aantal berichtenonderdelen	MessagePartCount	integer	Het geschatte aantal berichtonderdelen voor dit bericht.
Ontvangers	Recipients	array of object	Ontvangers
Adres van geadresseerde	Recipients.Address	string	Adres van geadresseerde (telefoonnummer/e-mailadres/gebruikers-id, enzovoort).
Geadresseerde-id	Recipients.Id	string	Geadresseerde-id die wordt gebruikt voor het ontvangen van informatie over de bezorgingsstatus.

Bericht verzenden

Bewerkings-id:: SendMessage

Een bericht verzenden naar geadresseerden.

Parameters

Naam	Sleutel	Vereist	Type	Description
Customer	Customer-Id	True	string	De klant die moet worden gebruikt voor verzending.
Dienst	Service-Id	True	string	De service die moet worden gebruikt voor verzending.
Afzender van bericht	Sender	True	string	De afzender van het bericht kan alfanumerieke, lange code of korte code zijn (beperkingen zijn van toepassing).
Berichtinhoud	Content	True	string	De inhoud van het bericht.
Message Protocol	Protocol	True	string	Het protocol dat moet worden gebruikt voor het verzenden van het bericht.
Datum/tijd verzenden	SendDateTime		date-time	De datum en tijd waarop het bericht moet worden verzonden. Laat leeg om direct te verzenden.
Adres	Address	True	string	Adres van geadresseerde van bericht.
Bijlage-URI	AttachmentUri		string	Bijlage-URI die moet worden gebruikt bij het verzenden van Een WhatsApp-bericht dat een bijlage bevat.
Klantgegevens	CustomerData		string	Facturerings-/groeperingsgegevens voor dit bericht, optioneel.
Advertentiebericht	AdMessage		boolean	Optioneel overschrijven vlag voor het markeren van het bericht als een advertentiebericht
Dlr-URL	DlrUrl		string	URL voor callback van leveringsstatus via http-get. U kunt querytekenreekswaarden toevoegen aan de URL. Ze blijven behouden.
Aanvraag-id	RequestId		string	Optionele unieke aanvraag-id die kan worden gebruikt om dubbele aanvragen te identificeren. Als er een dubbele aanvraag-id wordt gedetecteerd, wordt het verzenden geannuleerd. Er is geen garantie dat aanvragen met dubbele aanvraag-id's worden geblokkeerd in situaties met hoge doorvoer/verkeer. De opgegeven requestId wordt gedurende 7 dagen 'onthouden'.
Unicode-beleid voor het verwerken van tekens	UnicodeCharacterHandlingPolicy		string	Beleid voor het afhandelen van Unicode-tekens (alleen sms-protocol). De standaardwaarde is Geen (niet valideren of vervangen), Strikt resulteert in een validatiefout als er Unicode-tekens aanwezig zijn in de berichtinhoud. Vervangen vervangt Unicode-tekens door zowel look-alike tekens als vraagtekens (?)

Retouren

Naam	Pad	Type	Description
Bericht-id	MessageId	string	De id van het zojuist gemaakte bericht.
Aantal berichtenonderdelen	MessagePartCount	integer	Het geschatte aantal berichtonderdelen voor dit bericht.
Ontvangers	Recipients	array of object	Ontvangers
Adres van geadresseerde	Recipients.Address	string	Adres van geadresseerde (telefoonnummer/e-mailadres/gebruikers-id, enzovoort).
Geadresseerde-id	Recipients.Id	string	Geadresseerde-id die wordt gebruikt voor het ontvangen van informatie over de bezorgingsstatus.

Discussieantwoordbericht verzenden

Bewerkings-id:: SendDiscussionReplyMessage

Verzend een bericht over het beantwoorden van een discussie naar geadresseerden.

Parameters

Naam	Sleutel	Vereist	Type	Description
Customer	CustomerId	True	string	De klant die moet worden gebruikt voor verzending.
Thread-id	ThreadId	True	string	Id van de bestaande thread die moet worden beantwoord.
Berichtinhoud	Content	True	string	De inhoud van het bericht.
Klantgegevens	CustomerData		string	Facturerings-/groeperingsgegevens voor dit bericht, optioneel.

Retouren

Naam	Pad	Type	Description
Bericht-id	MessageId	string	De id van het zojuist gemaakte bericht.
Aantal berichtenonderdelen	MessagePartCount	integer	Het geschatte aantal berichtonderdelen voor dit bericht.
Ontvangers	Recipients	array of object	Ontvangers
Adres van geadresseerde	Recipients.Address	string	Adres van geadresseerde (telefoonnummer/e-mailadres/gebruikers-id, enzovoort).
Geadresseerde-id	Recipients.Id	string	Geadresseerde-id die wordt gebruikt voor het ontvangen van informatie over de bezorgingsstatus.
ThreadId	ThreadId	string	Id van thread waarnaar het bericht is verzonden.

Groepscontactpersoon bijwerken

Bewerkings-id:: UpdateGroupContact

Groepscontactpersoon bijwerken

Parameters

Naam	Sleutel	Vereist	Type	Description
Customer	Customer	True	string	De klant waarvoor groepsservices moeten worden opgehaald.
Groepsservice	Group Service	True	string	De te gebruiken groepsservice.
Telefoon	Phone	True	string	Het telefoonnummer van de contactpersoon die moet worden bijgewerkt.
Active	active		boolean	Vlag die aangeeft of de contactpersoon actief is.
E-mailen	email		string	E-mailadres van de contactpersoon.
Voornaam	firstName		string	Voornaam van de contactpersoon.
Achternaam	lastName		string	Achternaam van de contactpersoon.
Geslacht	gender		string	Geslacht van de contactpersoon.
Geboortejaar	birthYear		integer	Geboortejaar van de contactpersoon.
Straatadres	streetAddress		string	Adres van de contactpersoon.
Postcode	zipCode		string	Postcode van de contactpersoon.
City	city		string	Plaats van de contactpersoon.
Landcode	countryCode		string	Landcode van 3 letters van de contactpersoon.
Naam	name		string	Naam van aangepaste contactpersooneigenschap.
Waarde	value		string	Aangepaste eigenschapswaarde van contactpersoon.
Regio's van telefoonnummers	phoneNumberRegions		array of string	Telefoonnummerregio's die moeten worden gebruikt voor het parseren van nummers. Wordt standaard ingesteld op Finland als deze leeg blijft.

Retouren

response: boolean

Groepscontactpersoon maken

Bewerkings-id:: CreateGroupContact

Groepscontactpersoon maken

Parameters

Naam	Sleutel	Vereist	Type	Description
Customer	Customer	True	string	De klant waarvoor groepsservices moeten worden opgehaald.
Groepsservice	Group Service	True	string	De te gebruiken groepsservice.
Active	active		boolean	Vlag die aangeeft of de contactpersoon actief is.
Telefoon	phone	True	string	Telefoonnummer van de contactpersoon.
E-mailen	email		string	E-mailadres van de contactpersoon.
Voornaam	firstName		string	Voornaam van de contactpersoon.
Achternaam	lastName		string	Achternaam van de contactpersoon.
Geslacht	gender		string	Geslacht van de contactpersoon.
Geboortejaar	birthYear		integer	Geboortejaar van de contactpersoon.
Straatadres	streetAddress		string	Adres van de contactpersoon.
Postcode	zipCode		string	Postcode van de contactpersoon.
City	city		string	Plaats van de contactpersoon.
Landcode	countryCode		string	Landcode van 3 letters van de contactpersoon.
Naam	name		string	Naam van aangepaste eigenschap.
Waarde	value		string	Aangepaste eigenschapswaarde.
Regio's van telefoonnummers	phoneNumberRegions		array of string	Telefoonnummerregio's die moeten worden gebruikt voor het parseren van nummers. Wordt standaard ingesteld op Finland als deze leeg blijft.

Retouren

Unieke id van de gemaakte contactpersoon.

Contactpersoon-ID: uuid

Groepscontactpersoon ophalen

Bewerkings-id:: GetGroupContact

Groepscontactpersoon ophalen

Parameters

Naam	Sleutel	Vereist	Type	Description
Customer	Customer	True	string	De klant waarvoor groepsservices moeten worden opgehaald.
Groepsservice	Group Service	True	string	De te gebruiken groepsservice.
Telefoon	Phone	True	string	Het telefoonnummer van de contactpersoon.
Regio	Region		string	Optioneel telefoonnummergebied dat moet worden gebruikt voor het parseren van het telefoonnummer.

Retouren

Naam	Pad	Type	Description
Telefoon	phone	string	Telefoonnummer van de contactpersoon.
E-mailen	email	string	E-mailadres van de contactpersoon.
Voornaam	firstName	string	Voornaam van de contactpersoon.
Achternaam	lastName	string	Achternaam van de contactpersoon.
Geslacht	gender	string	Geslacht van de contactpersoon.
Geboortejaar	birthYear	integer	Geboortejaar van de contactpersoon.
Straatadres	streetAddress	string	Adres van de contactpersoon.
Postcode	zipCode	string	Postcode van de contactpersoon.
City	city	string	Plaats van de contactpersoon.
Landcode	countryCode	string	Landcode van de contactpersoon.
Mislukte berichten	failedMessages	integer	Aantal mislukte berichten voor de contactpersoon.
Aangepaste eigenschappen	customContactProperties	array of object	De verzameling eigenschappen van aangepaste contactpersonen die zijn opgeslagen voor de contactpersoon.
Naam	customContactProperties.name	string	Naam van aangepaste contactpersooneigenschap.
Waarde	customContactProperties.value	string	Aangepaste eigenschapswaarde van contactpersoon.

Groepscontactpersoon verwijderen

Bewerkings-id:: DeleteGroupContact

Groepscontactpersoon verwijderen met telefoonnummer.

Parameters

Naam	Sleutel	Vereist	Type	Description
Customer	Customer	True	string	De klant waarvoor groepsservices moeten worden opgehaald.
Groepsservice	Group Service	True	string	De te gebruiken groepsservice.
Telefoon	Phone	True	string	Het telefoonnummer van de contactpersoon die u wilt verwijderen.

Retouren

response: boolean

WhatsApp-bericht verzenden

Bewerkings-id:: SendWhatsappTemplateMessage

WhatsApp-sjabloonbericht verzenden.

Parameters

Naam	Sleutel	Vereist	Type	Description
Customer	Customer-Id	True	string	De klant die moet worden gebruikt voor verzending.
Dienst	Service-Id	True	string	De service die moet worden gebruikt voor verzending.
WhatsApp-sjabloon	TemplateName	True	string	De sjabloon die moet worden gebruikt voor het verzenden.
Adres	Address	True	string	Adres van geadresseerde van bericht.
BodyParameters	BodyParameters		array of string	BodyParameters
HeaderParameters	HeaderParameters		array of string	HeaderParameters
Typologie	Type		string	Het knoptype. Slechts één type per sjabloon kan meerdere van hetzelfde type bevatten.
Tekst	Data		string	De tekst van de knop.
Datum/tijd verzenden	SendDateTime		string	De datum en tijd waarop het bericht moet worden verzonden. Laat leeg om direct te verzenden.
Bijlage-URI	AttachmentUri		string	De bijlage-URI als de sjabloon een bijlage bevat.
Sms-terugval gebruiken	UseSmsFallback		boolean	Moet sms worden gebruikt als terugval.
Dlr-URL	DlrUrl		string	Url van bezorgingsrapport die een callback ontvangt wanneer het verzendproces is voltooid.
Klantgegevens	CustomerData		string	Facturerings-/groeperingsgegevens voor dit bericht, optioneel.
Aanvraag-id	RequestId		string	Optionele unieke aanvraag-id die kan worden gebruikt om dubbele aanvragen te identificeren. Als er een dubbele aanvraag-id wordt gedetecteerd, wordt het verzenden geannuleerd. Er is geen garantie dat aanvragen met dubbele aanvraag-id's worden geblokkeerd in situaties met hoge doorvoer/verkeer. De opgegeven requestId wordt gedurende 7 dagen 'onthouden'.

Retouren

Naam	Pad	Type	Description
Bericht-id	messageId	string	De id van het zojuist gemaakte bericht.
Aantal berichtenonderdelen	messagePartCount	integer	Het geschatte aantal berichtonderdelen voor dit bericht.
recipients	recipients	array of object	recipients
Adres van geadresseerde	recipients.address	string	Adres van geadresseerde (telefoonnummer/e-mailadres/gebruikers-id, enzovoort).
Geadresseerde-id	recipients.id	string	Geadresseerde-id die wordt gebruikt voor het ontvangen van informatie over de bezorgingsstatus.

WhatsApp Opt In (afgeschaft) [AFGESCHAFT]

Bewerkings-id:: WhatsAppOptIn

WhatsApp Opt In voor afzender en geadresseerde. (afgeschaft)

Parameters

Naam	Sleutel	Vereist	Type	Description
Adres afzender	Sender	True	string	Geregistreerd Id-nummer van WhatsApp om u aan te melden.
Adres van geadresseerde	Recipient	True	string	Het nummer van de geadresseerde om u aan te geven.

WhatsApp Opt Out (afgeschaft) [AFGESCHAFT]

Bewerkings-id:: WhatsAppOptOut

WhatsApp Opt Out voor afzender en geadresseerde. (afgeschaft)

Parameters

Naam	Sleutel	Vereist	Type	Description
Adres afzender	Sender	True	string	Geregistreerde WhatsApp-identiteitsnummer om u af te melden.
Adres van geadresseerde	Recipient	True	string	Receptnummer dat moet worden verwijderd uit opt-in.

WhatsApp-sjabloon maken

Bewerkings-id:: CreateWhatsappTemplate

Maak een nieuwe WhatsApp-sjabloon.

Parameters

Naam	Sleutel	Vereist	Type	Description
Customer	Customer-Id	True	string	De klant waarvoor de sjabloon moet worden gemaakt.
IdentityNumber	IdentityNumber	True	string	WhatsApp IdentityNumber dat wordt gebruikt voor de sjabloon.
Weergavenaam	DisplayName	True	string	Weergavenaam van sjabloon.
Content	RawContent	True	string	Sjablooninhoud.
Sjablooncategorie	Category	True	string	Sjablooncategorie.
Sjabloontaal	Language	True	string	Code van twee tekens voor sjabloontaal.
Knoptype	Type		string	Type knop.
Knoplabel	Label		string	Knoplabel.
Knopgegevens	Data		string	Knopgegevens. URL (URL), telefoonnummer (oproep) of tekst (QuickReply). De maximale lengte is 2000 voor URL en 20 voor telefoonnummer en tekst.
Url van bijlage	AttachmentUrl		string	URL naar een voorbeeldbijlage.

Triggers

Nieuw bericht

Wanneer er een nieuw bericht binnenkomt bij een 2-way-service.

Nieuw bericht

Bewerkings-id:: NewMessage

Wanneer er een nieuw bericht binnenkomt bij een 2-way-service.

Parameters

Naam	Sleutel	Vereist	Type	Description
Customer	Customer	True	string	De klant die moet worden gebruikt.
Dienst	Service	True	string	De 2-Way-service die moet worden gebruikt.

Retouren

Naam	Pad	Type	Description
Afzender van bericht	sender	string	De afzender van het bericht.
Geadresseerde van bericht	recipient	string	De ontvanger van het bericht.
Berichtinhoud	content	string	De inhoud van het ontvangen bericht.
Berichttijdstempel	timestamp	date-time	De tijdstempel van het bericht.
Message Protocol	protocol	string	Het protocol van het ontvangen bericht.
attachments	attachments	array of object	attachments
Bestandsnaam van bijlage	attachments.name	string	De bestandsnaam van de bijlage.
Mime-type bijlage	attachments.mimeType	string	Het mime-type van de bijlage.
Locatie van bijlageresource	attachments.resourceLocation	string	De locatie van de bijlageresource.
Bericht-id	messageId	string	De unieke bericht-id van het ontvangen bericht.

Definities

UUID (Universally Unique Identifier)

Unieke id van de gemaakte contactpersoon.

Contactpersoon-ID: uuid

booleaan

Dit is het basisgegevenstype 'Booleaanse waarde'.