SmartDialog
SmartDialog est une plateforme utilisée pour envoyer et recevoir des messages SMS et WhatsApp. Il offre un large éventail de services de messagerie intelligente.
Ce connecteur est disponible dans les produits et régions suivants :
| Service | classe | Régions |
|---|---|---|
| Copilot Studio | Premium | Toutes les régions Power Automate , à l’exception des éléments suivants : - Us Government (GCC) - Us Government (GCC High) - China Cloud géré par 21Vianet - Us Department of Defense (DoD) |
| Applications logiques | Norme | Toutes les régions Logic Apps , à l’exception des suivantes : - Régions Azure Government - Régions Azure Chine - Us Department of Defense (DoD) |
| Power Apps | Premium | Toutes les régions Power Apps , à l’exception des suivantes : - Us Government (GCC) - Us Government (GCC High) - China Cloud géré par 21Vianet - Us Department of Defense (DoD) |
| Power Automate | Premium | Toutes les régions Power Automate , à l’exception des éléments suivants : - Us Government (GCC) - Us Government (GCC High) - China Cloud géré par 21Vianet - Us Department of Defense (DoD) |
| Contact | |
|---|---|
| Nom | Prise en charge interactive d’Arena |
| URL | https://www.arenainteractive.fi/contact |
| Messagerie électronique | support@arenainteractive.fi |
| Métadonnées du connecteur | |
|---|---|
| Éditeur | Arena Interactive Oy |
| Site internet | https://www.arenainteractive.fi |
| Politique de confidentialité | https://www.arenainteractive.fi/privacypolicy |
| Catégories | Communication; Collaboration |
Connecteur SmartDialog
Ce connecteur peut être utilisé pour envoyer et recevoir des sms à l’aide de la plateforme SmartDialog.
Prerequisites
- Un abonnement et un compte SmartDialog. Veuillez être en contact avec sales@arenainteractive.fi
- OAuth doit être activé pour votre compte et une clé secrète client doit être demandée. Pour ce faire, envoyez-nous un e-mail à l’adresse support@arenainteractive.fi.
Configuration
- Suivez les instructions fournies dans Créer un connecteur personnalisé à partir d’une définition OpenAPI.
- Créez un flux ou PowerApp et ajoutez une action SmartDialog à partir de la section personnalisée. Connectez-vous avec votre compte SmartDialog.
Actions prises en charge
- Nouveau message (déclencheur pour la réception de messages)
- Envoyer un message
- Envoyer un message WhatsApp
- Envoyer un message de réponse de discussion
- Envoyer un message de réponse
- WhatsApp Opt In
- WhatsApp Opt Out
- Créer un modèle WhatsApp
- Obtenir un contact de groupe
- Créer un contact de groupe
- Mettre à jour le contact de groupe
- Supprimer le contact de groupe
- Supprimer tous les contacts de groupe
Limitations
| Nom | Appels | Période de renouvellement |
|---|---|---|
| Appels d’API par connexion | 100 | 60 secondes |
Actions
| Créer un contact de groupe |
Créer un contact de groupe |
|
Créer un modèle Whats |
Créez un modèle WhatsApp. |
| Envoyer un message |
Envoyez un message aux destinataires. |
| Envoyer un message de réponse |
Envoyez un replymessage aux destinataires. |
| Envoyer un message de réponse de discussion |
Envoyez un message de réponse de discussion aux destinataires. |
|
Envoyer un message Whats |
Envoyer un message de modèle WhatsApp. |
| Mettre à jour le contact de groupe |
Mettre à jour le contact de groupe |
| Obtenir un contact de groupe |
Obtenir un contact de groupe |
| Supprimer le contact de groupe |
Supprimez le contact de groupe à l’aide du numéro de téléphone. |
| Supprimer tous les contacts de groupe |
Supprimer tous les contacts de groupe |
|
Whats |
WhatsApp Opt In pour l’expéditeur et le destinataire. (déconseillé) |
|
Whats |
WhatsApp Opt Out pour l’expéditeur et le destinataire. (déconseillé) |
Créer un contact de groupe
Créer un contact de groupe
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Client
|
Customer | True | string |
Client pour lequel récupérer les services de groupe. |
|
Service de groupe
|
Group Service | True | string |
Service de groupe à utiliser. |
|
Active
|
active | boolean |
Indicateur qui indique si le contact est actif. |
|
|
Téléphone
|
phone | True | string |
Numéro de téléphone du contact. |
|
Messagerie électronique
|
string |
Adresse e-mail du contact. |
||
|
Prénom
|
firstName | string |
Prénom du contact. |
|
|
Nom de famille
|
lastName | string |
Nom du contact. |
|
|
Gender
|
gender | string |
Sexe du contact. |
|
|
Année de naissance
|
birthYear | integer |
Année de naissance du contact. |
|
|
Adresse de rue
|
streetAddress | string |
Adresse postale du contact. |
|
|
Code postal
|
zipCode | string |
Code postal du contact. |
|
|
Ville
|
city | string |
Ville du contact. |
|
|
Code pays
|
countryCode | string |
Code pays de 3 lettres du contact. |
|
|
Nom
|
name | string |
Nom de propriété personnalisée. |
|
|
Valeur
|
value | string |
Valeur de propriété personnalisée. |
|
|
Régions phonenumber
|
phoneNumberRegions | array of string |
Régions phonenumber à utiliser pour l’analyse des numéros. La valeur par défaut est la Finlande si elle est laissée vide. |
Retours
ID unique du contact créé.
- Contact Id
- uuid
Créer un modèle WhatsApp
Créez un modèle WhatsApp.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Client
|
Customer-Id | True | string |
Client pour lequel créer le modèle. |
|
IdentityNumber
|
IdentityNumber | True | string |
WhatsApp IdentityNumber utilisé pour le modèle. |
|
Displayname
|
DisplayName | True | string |
Nom d’affichage du modèle. |
|
Content
|
RawContent | True | string |
Contenu du modèle. |
|
Catégorie de modèle
|
Category | True | string |
Catégorie de modèle. |
|
Langage du modèle
|
Language | True | string |
Code de 2 caractères pour le langage du modèle. |
|
Type de bouton
|
Type | string |
Type de bouton. |
|
|
Étiquette du bouton
|
Label | string |
Étiquette du bouton. |
|
|
Données de bouton
|
Data | string |
Données de bouton. URL (URL), numéro de téléphone (appel) ou texte (QuickReply). La longueur maximale est 2000 pour l’URL, et 20 pour le numéro de téléphone et le texte. |
|
|
URL de pièce jointe
|
AttachmentUrl | string |
URL d’un exemple de pièce jointe. |
Envoyer un message
Envoyez un message aux destinataires.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Client
|
Customer-Id | True | string |
Client à utiliser pour l’envoi. |
|
Service
|
Service-Id | True | string |
Service à utiliser pour l’envoi. |
|
Expéditeur du message
|
Sender | True | string |
L’expéditeur du message peut être alphanumérique, code long ou code court (les restrictions s’appliquent). |
|
Contenu du message
|
Content | True | string |
Contenu du message. |
|
Protocole de message
|
Protocol | True | string |
Protocole à utiliser pour l’envoi du message. |
|
Envoyer datetime
|
SendDateTime | date-time |
Date et heure d’envoi du message. Laissez vide pour envoyer instantanément. |
|
|
Adresse
|
Address | True | string |
Adresse du destinataire du message. |
|
Uri de pièce jointe
|
AttachmentUri | string |
Uri de pièce jointe à utiliser lors de l’envoi d’un message WhatsApp qui contient une pièce jointe. |
|
|
Données client
|
CustomerData | string |
Données de facturation/regroupement pour ce message, facultatives. |
|
|
Message publicitaire
|
AdMessage | boolean |
Indicateur de substitution facultatif pour marquer le message en tant que message publicitaire |
|
|
Dlr Url
|
DlrUrl | string |
URL du rappel d’état de remise via http-get. Vous pouvez ajouter des valeurs de chaîne de requête à l’URL, elles seront conservées. |
|
|
ID de demande
|
RequestId | string |
ID de demande unique facultatif qui peut être utilisé pour identifier les demandes en double. Si un ID de demande en double est détecté, l’envoi est annulé. Il n’existe aucune garantie que les requêtes avec des ID de demande en double seront bloquées dans des situations de débit/de trafic élevé. L’ID de requête donné sera « mémorisé » pendant 7 jours. |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Message Id
|
MessageId | string |
Identificateur du message nouvellement créé. |
|
Nombre de parties de message
|
MessagePartCount | integer |
Nombre approximatif de parties de message pour ce message. |
|
Destinataires
|
Recipients | array of object |
Destinataires |
|
Adresse du destinataire
|
Recipients.Address | string |
Adresse du destinataire (numéro de téléphone/e-mail/ID d’utilisateur, etc.). |
|
ID du destinataire
|
Recipients.Id | string |
Identificateur de destinataire utilisé pour recevoir des informations d’état de remise. |
Envoyer un message de réponse
Envoyez un replymessage aux destinataires.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ParentMessage Id
|
ParentMessageId | True | string |
ID de message parent auquel répondre. |
|
Client
|
Customer-Id | True | string |
Client à utiliser pour l’envoi. |
|
Service
|
Service-Id | True | string |
Service à utiliser pour l’envoi. |
|
Expéditeur du message
|
Sender | True | string |
L’expéditeur du message peut être alphanumérique, code long ou code court (les restrictions s’appliquent). |
|
Contenu du message
|
Content | True | string |
Contenu du message. |
|
Protocole de message
|
Protocol | True | string |
Protocole à utiliser pour l’envoi du message. |
|
Envoyer datetime
|
SendDateTime | date-time |
Date et heure d’envoi du message. Laissez vide pour envoyer instantanément. |
|
|
Adresse
|
Address | True | string |
Adresse du destinataire du message. |
|
Uri de pièce jointe
|
AttachmentUri | string |
Uri de pièce jointe à utiliser lors de l’envoi d’un message WhatsApp qui contient une pièce jointe. |
|
|
Données client
|
CustomerData | string |
Données de facturation/regroupement pour ce message, facultatives. |
|
|
Message publicitaire
|
AdMessage | boolean |
Indicateur de substitution facultatif pour marquer le message en tant que message publicitaire |
|
|
Dlr Url
|
DlrUrl | string |
URL du rappel d’état de remise via http-get. Vous pouvez ajouter des valeurs de chaîne de requête à l’URL, elles seront conservées. |
|
|
ID de demande
|
RequestId | string |
ID de demande unique facultatif qui peut être utilisé pour identifier les demandes en double. Si un ID de demande en double est détecté, l’envoi est annulé. Il n’existe aucune garantie que les requêtes avec des ID de demande en double seront bloquées dans des situations de débit/de trafic élevé. L’ID de requête donné sera « mémorisé » pendant 7 jours. |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Message Id
|
MessageId | string |
Identificateur du message nouvellement créé. |
|
Nombre de parties de message
|
MessagePartCount | integer |
Nombre approximatif de parties de message pour ce message. |
|
Destinataires
|
Recipients | array of object |
Destinataires |
|
Adresse du destinataire
|
Recipients.Address | string |
Adresse du destinataire (numéro de téléphone/e-mail/ID d’utilisateur, etc.). |
|
ID du destinataire
|
Recipients.Id | string |
Identificateur de destinataire utilisé pour recevoir des informations d’état de remise. |
Envoyer un message de réponse de discussion
Envoyez un message de réponse de discussion aux destinataires.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Client
|
CustomerId | True | string |
Client à utiliser pour l’envoi. |
|
Thread Id
|
ThreadId | True | string |
ID du thread existant auquel répondre. |
|
Contenu du message
|
Content | True | string |
Contenu du message. |
|
Données client
|
CustomerData | string |
Données de facturation/regroupement pour ce message, facultatives. |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Message Id
|
MessageId | string |
Identificateur du message nouvellement créé. |
|
Nombre de parties de message
|
MessagePartCount | integer |
Nombre approximatif de parties de message pour ce message. |
|
Destinataires
|
Recipients | array of object |
Destinataires |
|
Adresse du destinataire
|
Recipients.Address | string |
Adresse du destinataire (numéro de téléphone/e-mail/ID d’utilisateur, etc.). |
|
ID du destinataire
|
Recipients.Id | string |
Identificateur de destinataire utilisé pour recevoir des informations d’état de remise. |
|
ThreadId
|
ThreadId | string |
Identificateur du thread auquel le message a été envoyé. |
Envoyer un message WhatsApp
Envoyer un message de modèle WhatsApp.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Client
|
Customer-Id | True | string |
Client à utiliser pour l’envoi. |
|
Service
|
Service-Id | True | string |
Service à utiliser pour l’envoi. |
|
Modèle WhatsApp
|
TemplateName | True | string |
Modèle à utiliser pour l’envoi. |
|
Adresse
|
Address | True | string |
Adresse du destinataire du message. |
|
BodyParameters
|
BodyParameters | array of string |
BodyParameters |
|
|
HeaderParameters
|
HeaderParameters | array of string |
HeaderParameters |
|
|
Type
|
Type | string |
Type de bouton. Un seul type par modèle peut contenir plusieurs du même type. |
|
|
Texto
|
Data | string |
Texte du bouton. |
|
|
Envoyer datetime
|
SendDateTime | string |
Date et heure d’envoi du message. Laissez vide pour envoyer instantanément. |
|
|
Uri de pièce jointe
|
AttachmentUri | string |
Uri de pièce jointe si le modèle contient une pièce jointe. |
|
|
Utiliser la secours SMS
|
UseSmsFallback | boolean |
Si SMS doit être utilisé comme secours. |
|
|
Dlr Url
|
DlrUrl | string |
URL du rapport de remise qui reçoit un rappel lorsque le processus d’envoi est terminé. |
|
|
Données client
|
CustomerData | string |
Données de facturation/regroupement pour ce message, facultatives. |
|
|
ID de demande
|
RequestId | string |
ID de demande unique facultatif qui peut être utilisé pour identifier les demandes en double. Si un ID de demande en double est détecté, l’envoi est annulé. Il n’existe aucune garantie que les requêtes avec des ID de demande en double seront bloquées dans des situations de débit/de trafic élevé. L’ID de requête donné sera « mémorisé » pendant 7 jours. |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Message Id
|
messageId | string |
Identificateur du message nouvellement créé. |
|
Nombre de parties de message
|
messagePartCount | integer |
Nombre approximatif de parties de message pour ce message. |
|
destinataires
|
recipients | array of object |
destinataires |
|
Adresse du destinataire
|
recipients.address | string |
Adresse du destinataire (numéro de téléphone/e-mail/ID d’utilisateur, etc.). |
|
ID du destinataire
|
recipients.id | string |
Identificateur de destinataire utilisé pour recevoir des informations d’état de remise. |
Mettre à jour le contact de groupe
Mettre à jour le contact de groupe
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Client
|
Customer | True | string |
Client pour lequel récupérer les services de groupe. |
|
Service de groupe
|
Group Service | True | string |
Service de groupe à utiliser. |
|
Téléphone
|
Phone | True | string |
Numéro de téléphone du contact à mettre à jour. |
|
Active
|
active | boolean |
Indicateur qui indique si le contact est actif. |
|
|
Messagerie électronique
|
string |
Adresse e-mail du contact. |
||
|
Prénom
|
firstName | string |
Prénom du contact. |
|
|
Nom de famille
|
lastName | string |
Nom du contact. |
|
|
Gender
|
gender | string |
Sexe du contact. |
|
|
Année de naissance
|
birthYear | integer |
Année de naissance du contact. |
|
|
Adresse de rue
|
streetAddress | string |
Adresse postale du contact. |
|
|
Code postal
|
zipCode | string |
Code postal du contact. |
|
|
Ville
|
city | string |
Ville du contact. |
|
|
Code pays
|
countryCode | string |
Code pays de 3 lettres du contact. |
|
|
Nom
|
name | string |
Nom de la propriété contact personnalisée. |
|
|
Valeur
|
value | string |
Valeur de propriété de contact personnalisée. |
|
|
Régions phonenumber
|
phoneNumberRegions | array of string |
Régions phonenumber à utiliser pour l’analyse des numéros. La valeur par défaut est la Finlande si elle est laissée vide. |
Retours
- response
- boolean
Obtenir un contact de groupe
Obtenir un contact de groupe
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Client
|
Customer | True | string |
Client pour lequel récupérer les services de groupe. |
|
Service de groupe
|
Group Service | True | string |
Service de groupe à utiliser. |
|
Téléphone
|
Phone | True | string |
Numéro de téléphone du contact. |
|
Région
|
Region | string |
Région Phonenumber facultative à utiliser pour analyser le numéro de téléphone. |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Téléphone
|
phone | string |
Numéro de téléphone du contact. |
|
Messagerie électronique
|
string |
Adresse e-mail du contact. |
|
|
Prénom
|
firstName | string |
Prénom du contact. |
|
Nom de famille
|
lastName | string |
Nom du contact. |
|
Gender
|
gender | string |
Sexe du contact. |
|
Année de naissance
|
birthYear | integer |
Année de naissance du contact. |
|
Adresse de rue
|
streetAddress | string |
Adresse postale du contact. |
|
Code postal
|
zipCode | string |
Code postal du contact. |
|
Ville
|
city | string |
Ville du contact. |
|
Code pays
|
countryCode | string |
Code de pays du contact. |
|
Messages ayant échoué
|
failedMessages | integer |
Nombre de messages ayant échoué pour le contact. |
|
Propriétés personnalisées
|
customContactProperties | array of object |
Collection de propriétés contact personnalisée enregistrée pour le contact. |
|
Nom
|
customContactProperties.name | string |
Nom de la propriété contact personnalisée. |
|
Valeur
|
customContactProperties.value | string |
Valeur de propriété de contact personnalisée. |
Supprimer le contact de groupe
Supprimez le contact de groupe à l’aide du numéro de téléphone.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Client
|
Customer | True | string |
Client pour lequel récupérer les services de groupe. |
|
Service de groupe
|
Group Service | True | string |
Service de groupe à utiliser. |
|
Téléphone
|
Phone | True | string |
Numéro de téléphone du contact à supprimer. |
Retours
- response
- boolean
Supprimer tous les contacts de groupe
Supprimer tous les contacts de groupe
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Client
|
Customer | True | string |
Client pour lequel récupérer les services de groupe. |
|
Service de groupe
|
Group Service | True | string |
Service de groupe à utiliser. |
Retours
- response
- boolean
WhatsApp Opt In (déconseillé) [DÉPRÉCIÉ]
WhatsApp Opt In pour l’expéditeur et le destinataire. (déconseillé)
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Adresse de l’expéditeur
|
Sender | True | string |
Numéro d’identité Whatsapp inscrit pour l’inscription. |
|
Adresse du destinataire
|
Recipient | True | string |
Numéro de destinataire à accepter. |
WhatsApp Opt Out (déconseillé) [DÉPRÉCIÉ]
WhatsApp Opt Out pour l’expéditeur et le destinataire. (déconseillé)
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Adresse de l’expéditeur
|
Sender | True | string |
Numéro d’identité Whatsapp inscrit à partir duquel refuser. |
|
Adresse du destinataire
|
Recipient | True | string |
Numéro de recette à supprimer de l’opt-in. |
Déclencheurs
| Nouveau message |
Lorsqu’un nouveau message arrive à un service 2-Way. |
Nouveau message
Lorsqu’un nouveau message arrive à un service 2-Way.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Client
|
Customer | True | string |
Client à utiliser. |
|
Service
|
Service | True | string |
Service 2-Way à utiliser. |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Expéditeur du message
|
sender | string |
Expéditeur du message. |
|
Destinataire du message
|
recipient | string |
Destinataire du message. |
|
Contenu du message
|
content | string |
Contenu du message reçu. |
|
Horodatage de message
|
timestamp | date-time |
Horodatage du message. |
|
Protocole de message
|
protocol | string |
Protocole du message reçu. |
|
attachments
|
attachments | array of object |
attachments |
|
Nom de fichier de pièce jointe
|
attachments.name | string |
Nom de fichier de la pièce jointe. |
|
Type Mime de pièce jointe
|
attachments.mimeType | string |
Type mime de la pièce jointe. |
|
Emplacement des ressources de pièce jointe
|
attachments.resourceLocation | string |
Emplacement de la ressource de pièce jointe. |
|
Message Id
|
messageId | string |
ID de message unique du message reçu. |
Définitions
Identifiant unique universel (UUID)
boolean
Il s’agit du type de données de base « boolean ».