Partager via

TrueDialog SMS

Le connecteur SMS TrueDialog permet d’envoyer des messages texte en masse et individuels via du code long et du code court.

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 de TrueDialog
URL https://www.truedialog.com/help/
Messagerie électronique support@truedialog.com
Métadonnées du connecteur
Éditeur TrueDialog Dynamics
Website https://www.truedialog.com/
Politique de confidentialité https://www.truedialog.com/privacy-policy/
Catégories Communication

L’API SMS de TrueDialog est de niveau entreprise avec plus de fonctionnalités prédéfinies que tout autre logiciel SMS. Conçue pour les développeurs, notre API SMS est hautement fiable, sécurisée et inclut une base de données ISO 9001 prédéfini pour une protection supplémentaire contre l’opt-out et la conformité. Disponible également par le biais de nos logiciels de texte sms Enterprise-Grade complets.

Prerequisites

Vous aurez besoin de ces informations d’identification pour continuer :

  • Un plan Microsoft Power Apps ou Power Automate
  • Un compte TrueDialog et un plan et votre clé API TrueDialog et code secret pour votre compte. Cliquez ICI pour vous inscrire.

Comment obtenir des informations d’identification

Cliquez ICI pour vous inscrire. Lorsque vous vous inscrivez à TrueDialog, la clé API et le code secret se trouveront dans votre e-mail d’informations d’identification. Pour obtenir de l’aide pour commencer, contactez notre équipe. Notre équipe de services clients de classe mondiale vous guidera tout au long de l’inscription et choisira le meilleur compte pour les besoins de votre entreprise.

CONTACTEZ-NOUS:

Messagerie électronique support@truedialog.com
Conversation en direct https://www.truedialog.com/
Téléphone 512-501-5940

Prise en main du connecteur TrueDialog

Une fois que vous avez vos informations d’identification, vous pouvez commencer à utiliser le connecteur.

Actions

Envoyer un SMS

L’action la plus précieuse est « Envoyer des SMS ». Il permet d’envoyer des SMS à un ou plusieurs destinataires. Cette action comporte plusieurs champs obligatoires :

  • ID de compte : peut être utilisé à partir de la réponse Obtenir les informations utilisateur actuelles ou peut être codé en dur.
  • Canal : conservez la valeur par défaut 22 pour utiliser le numéro de téléphone associé par défaut.
  • Cibles : numéro de téléphone américain valide sans mise en forme (ex. : +15125453809)
  • Message : message lui-même.
  • Exécuter : conservez la valeur par défaut True si vous ne souhaitez pas reporter l’envoi.

Triggers

La liste des rappels inscrits pour un compte est disponible ici : https://ui.truedialog.com/Callbacks

Message entrant reçu

Déclencheur le plus important. Cette opération déclenche un flux chaque fois que l’utilisateur final envoie un sms vers le numéro de téléphone associé.

L’ID de compte est requis pour inscrire le déclencheur. Vous pouvez obtenir un ID de compte via le portail TD, situé en regard du nom du compte dans le coin supérieur droit.

Le message entrant contient du texte du message et d’autres champs nécessaires.

Arrêter le message reçu

Cette opération déclenche un flux chaque fois que l’utilisateur final texte dans STOP ou synonyme. Il désactive également automatiquement le contact dans le système TrueDialog. Pour envoyer un message au contact désactivé, définissez l’indicateur forceOptIn sur True lors de l’envoi de SMS. Utilisez cette fonctionnalité ForceOptIt avec précaution et assurez-vous que vous effectuez le suivi des enregistrements désactivés.

Fournissez aux utilisateurs un processus pas à pas pour commencer à utiliser votre connecteur. C’est là que vous devez mettre en évidence les cas d’usage courants, tels que vos déclencheurs et actions populaires attendus, et comment ils peuvent vous aider dans les scénarios d’automatisation. Incluez des images dans la situation où cela est possible.

Avis de remise reçu

Cette opération déclenche un flux pour chaque reçu de notification de remise. Notez que tous les opérateurs mobiles n’envoient pas de reçu de notification.

Cibles non valides

Quand l’un des téléphones cibles n’est pas valide ou est mis sur liste rouge, il est toujours possible d’envoyer des SMS et de ne pas obtenir d’erreur. Pour cela, vous devez définir la propriété « IgnoreInvalidTargets » sur true lors de l’envoi d’un message. Si des numéros de téléphone non valides ont été présentés dans la liste des destinataires SMS envoyés, cette opération déclenche un flux.

Problèmes connus et limitations

L’API TrueDialog offre plus de fonctionnalités, par rapport au connecteur personnalisé

Questions fréquentes (FAQ)

Pour obtenir la description la plus récente de l’API nondrlying, consultez ICI

Fournissez une répartition des questions fréquemment posées et leurs réponses respectives ici. Cela peut couvrir les questions fréquentes sur l’interaction avec le service sous-jacent ou sur le connecteur lui-même.

Création d’une connexion

Le connecteur prend en charge les types d’authentification suivants :
Par défaut Paramètres de création de connexion. Toutes les régions Non partageable

Faire défaut

Applicable : Toutes les régions

Paramètres de création de connexion.

Cette connexion n’est pas partageable. Si l’application power est partagée avec un autre utilisateur, un autre utilisateur est invité à créer une connexion explicitement.

Nom Type Descriptif Obligatoire
nom d'utilisateur securestring Nom d’utilisateur de cette API Vrai
mot de passe securestring Mot de passe de cette API Vrai

Limitations

Nom Appels Période de renouvellement
Appels d’API par connexion 100 60 secondes

Actions

Créer un contact

Créer un enregistrement de contact dans TrueDialog
Envoyer un SMS

Envoyer des SMS à un ou plusieurs destinataires
Mise à jour du contact

Mettre à jour un contact
Obtenir des informations sur le compte

Obtenir des informations sur le compte
Obtenir les informations utilisateur actuelles

Obtenir des informations sur l’utilisateur, dont les informations d’identification ont été utilisées dans La connexion
Recherche de contacts

Recherche un contact via un numéro de téléphone ou une adresse e-mail.

Créer un contact

ID d’opération :
Contact_Create

Créer un enregistrement de contact dans TrueDialog

Paramètres

Nom Clé Obligatoire Type Description
ID de compte
 accountId True string

ID de compte qui serait utilisé comme compte parent pour le contact créé
Numéro de téléphone
 PhoneNumber string

Numéro de téléphone mobile si disponible. Cela ou le champ e-mail sont OBLIGATOIREs
Messagerie électronique
 Email string

Adresse e-mail du contact. Cela ou le champ PhoneNumber sont OBLIGATOIREs.
Prénom
 FirstName string

Prénom du contact.
nom de famille
 LastName string

Nom du contact.

Retours

Corps
ContactResponse

Envoyer un SMS

ID d’opération :
Campaign_Push

Envoyer des SMS à un ou plusieurs destinataires

Paramètres

Nom Clé Obligatoire Type Description
ID de compte
 accountId True string

ID de compte utilisé pour l’envoi de SMS
Canaux
 Channels True array of string

Canaux
Targets
 Targets True array of string

Targets
ContactListIds
 ContactListIds array of string

ID de liste de contacts
ExcludeListIds
 ExcludeListIds array of string

Exclure les ID de liste
ID de média
 MediaId integer

ID de média
Message
 Message True string

Message
Ignorer l’utilisation unique
 IgnoreSingleUse boolean

Ignorer l’utilisation unique
ForceOptIn
 ForceOptIn boolean

Forcer Opt-In
Horaires
 Schedules array of string

Liste des planifications associées à l’action
Execute
 Execute True boolean

Définir true si l’action doit être exécutée lors de la création
IgnoreInvalidTargets
 IgnoreInvalidTargets boolean

Indique si les nombres non valides doivent être ignorés

Retours

Corps
PushCampaignResponse

Mise à jour du contact

ID d’opération :
Contact_Update

Mettre à jour un contact

Paramètres

Nom Clé Obligatoire Type Description
ID de compte
 accountId True string

ID de compte utilisé comme compte parent pour le contact mis à jour
Identifiant de contact
 contactid True string

ID du contact qui serait mis à jour
Numéro de téléphone
 PhoneNumber string

Numéro de téléphone mobile si disponible. Cela ou le champ e-mail sont OBLIGATOIREs
Messagerie électronique
 Email string

Adresse e-mail du contact. Cela ou le champ PhoneNumber sont OBLIGATOIREs.
Prénom
 FirstName string

Prénom du contact.
nom de famille
 LastName string

Nom du contact.

Retours

Corps
ContactResponse

Obtenir des informations sur le compte

ID d’opération :
Account_Get_Info

Obtenir des informations sur le compte

Paramètres

Nom Clé Obligatoire Type Description
ID du compte, qui doit être récupéré
 accountId True string

ID de compte

Retours

Corps
AccountResponse

Obtenir les informations utilisateur actuelles

ID d’opération :
User_Get_Self_Info

Obtenir des informations sur l’utilisateur, dont les informations d’identification ont été utilisées dans La connexion

Retours

Corps
UserResponse

Recherche de contacts

ID d’opération :
Contact_Search

Recherche un contact via un numéro de téléphone ou une adresse e-mail.

Paramètres

Nom Clé Obligatoire Type Description
ID de compte pour l’abonnement
 accountId True string

Compte auquel le contact est visible.
Numéro de téléphone à rechercher
 phone True string

Recherchez les contacts existants avec le numéro de téléphone ou l’e-mail transmis.

Retours

Objets
ContactSearchRequest

Déclencheurs

Arrêter le message reçu

Cette opération déclenche un flux chaque fois que l’utilisateur final texte dans STOP ou synonyme
Avis de remise reçu

Cette opération déclenche un flux pour chaque reçu de notification de remise
Cibles non valides

Cette opération déclenche un flux si des cibles ont été filtrées lors de l’envoi de SMS
Message entrant reçu

Cette opération déclenche un flux chaque fois que l’utilisateur final texte dans
Mot clé reçu

Cette opération déclenche un flux chaque fois que l’utilisateur final texte dans un mot clé

Arrêter le message reçu

ID d’opération :
Stop_received

Cette opération déclenche un flux chaque fois que l’utilisateur final texte dans STOP ou synonyme

Paramètres

Nom Clé Obligatoire Type Description
ID de compte pour l’abonnement
 accountId True string

Utilisez l’ID de compte racine dans la plupart des cas pour vous abonner aux notifications.

Retours

Nom Chemin d’accès Type Description
Horodatage de rappel
 CallbackTimestamp string

Date et heure d’envoi du rappel. Format : aaaa-MM-ddTHH :mm :ss
CallbackToken
 CallbackToken string

Jeton de rappel
TransactionId
 TransactionId string

ID de la transaction
Identifiant de compte
 AccountId integer

ID de compte
Nom du compte
 AccountName string

Nom du compte auquel le rappel est associé
ChannelId
 ChannelId integer

ID de canal
Code du canal
 ChannelCode string

Code du canal sur lequel le message a été envoyé (numéro de téléphone réel pour les codes longs)
ContactId
 ContactId integer

Contact Id
ContactAccountId
 ContactAccountId integer

ID du compte propriétaire de l’enregistrement de contact
ContactAccountName
 ContactAccountName string

Nom du compte propriétaire de l’enregistrement de contact
Numéro de téléphone
 PhoneNumber string

Numéro de téléphone de l’utilisateur final qui a été désactivé

Avis de remise reçu

ID d’opération :
Delivery_Notice_received

Cette opération déclenche un flux pour chaque reçu de notification de remise

Paramètres

Nom Clé Obligatoire Type Description
ID de compte pour l’abonnement
 accountId True string

Utilisez l’ID de compte racine dans la plupart des cas pour vous abonner aux notifications.

Retours

Nom Chemin d’accès Type Description
Horodatage de rappel
 CallbackTimestamp string

Date et heure d’envoi du rappel. Format : aaaa-MM-ddTHH :mm :ss
CallbackToken
 CallbackToken string

Jeton de rappel
TransactionId
 TransactionId string

ID de la transaction
Identifiant de compte
 AccountId integer

ID de compte
Nom du compte
 AccountName string

Nom du compte auquel le rappel est associé
ID d’état
 StatusId integer

2 = Livré ; 3 = Non remis ; 7 = Inconnu
Statut
 Status string

Code de remise : OK pour le message remis ou le code d’erreur. Pour undelivered - Null
ChannelId
 ChannelId integer

ID de canal
Code du canal
 ChannelCode string

Code du canal sur lequel le message a été envoyé (numéro de téléphone réel pour les codes longs)
MessageId
 MessageId string

MessageId
Numéro de téléphone
 PhoneNumber string

Numéro de téléphone
ContactId
 ContactId integer

Contact Id
ActionId
 ActionId integer

ID d’action
Message
 Message string

Texte du message réel

Cibles non valides

ID d’opération :
Invalid_Targets

Cette opération déclenche un flux si des cibles ont été filtrées lors de l’envoi de SMS

Paramètres

Nom Clé Obligatoire Type Description
ID de compte pour l’abonnement
 accountId True string

Utilisez l’ID de compte racine dans la plupart des cas pour vous abonner aux notifications.

Retours

Nom Chemin d’accès Type Description
Horodatage de rappel
 CallbackTimestamp string

Date et heure d’envoi du rappel. Format : aaaa-MM-ddTHH :mm :ss
CallbackURL
 CallbackURL string

Callback URL (URL de rappel)
TransactionId
 TransactionId string

ID de la transaction
Identifiant de compte
 AccountId integer

ID de compte
ActionId
 ActionId integer

ID d’action
RunId
 RunId integer

Id d’exécution
InvalidTargets
 InvalidTargets array of object

Cibles non valides
Cible
 InvalidTargets.Target string

Cible filtrée
ReasonId
 InvalidTargets.ReasonId integer

ID de la raison. 0 - Non valide, 1 - Désactivé, 2 - Dupliqué, 3 - Bloqué, 4 - Non remis, 5 - Utilisation unique
Reason
 InvalidTargets.Reason string

Brève description d’une raison

Message entrant reçu

ID d’opération :
Incoming_SMS_Received

Cette opération déclenche un flux chaque fois que l’utilisateur final texte dans

Paramètres

Nom Clé Obligatoire Type Description
ID de compte pour l’abonnement
 AccountId True string

Utilisez l’ID de compte racine dans la plupart des cas pour vous abonner aux notifications.

Retours

Nom Chemin d’accès Type Description
Nom du compte
 AccountName string

Nom du compte auquel le rappel est associé
Code du canal
 ChannelCode string

Code du canal sur lequel le message a été envoyé (numéro de téléphone réel pour les codes longs)
ChannelId
 ChannelId integer

ID du canal sur lequel le message a été envoyé
ContactId
 ContactId integer

ID de contact le cas échéant (null pour les contacts inconnus)
Message
 Message string

Texte du message réel
Numéro de téléphone
 PhoneNumber string

Numéro de téléphone cible
Identifiant de compte
 AccountId integer

ID du compte auquel le rappel est associé
Horodatage de rappel
 CallbackTimestamp string

Date et heure d’envoi du rappel. Format : aaaa-MM-ddTHH :mm :ss
CallbackToken
 CallbackToken string

Jeton de rappel
TransactionId
 TransactionId string

Jeton unique

Mot clé reçu

ID d’opération :
Keyword_received

Cette opération déclenche un flux chaque fois que l’utilisateur final texte dans un mot clé

Paramètres

Nom Clé Obligatoire Type Description
ID de compte pour l’abonnement
 accountId True string

Utilisez l’ID de compte racine dans la plupart des cas pour vous abonner aux notifications.

Retours

Nom Chemin d’accès Type Description
Horodatage de rappel
 CallbackTimestamp string

Date et heure d’envoi du rappel : aaaa-MM-ddTHH :mm :ss
CallbackToken
 CallbackToken string

Jeton de rappel
TransactionId
 TransactionId string

ID de la transaction
Identifiant de compte
 AccountId integer

ID du compte auquel le rappel est associé
Nom du compte
 AccountName string

Nom du compte auquel le rappel est associé
Identifiant de la campagne
 CampaignId integer

ID de campagne
ChannelId
 ChannelId integer

ID de canal
Code du canal
 ChannelCode string

Code du canal sur lequel le message a été envoyé (numéro de téléphone réel pour les codes longs)
ContactId
 ContactId integer

ID du contact qui a envoyé le mot clé
Keyword
 Keyword string

Mot clé réel envoyé
KeywordId
 KeywordId integer

ID du mot clé qui a été envoyé
Message
 Message string

Texte du message réel
Numéro de téléphone
 PhoneNumber string

Numéro de téléphone de l’utilisateur final qui a envoyé le mot clé

Définitions

AccountResponse

Nom Chemin d’accès Type Description
pièce d'identité
 id integer

ID du compte.
status
 status integer

État actuel du compte.
parentId
 parentId integer

Identificateur du compte qui est le parent de ce compte.
nom
 name string

Le nom du compte
créé
 created string

Lorsque le compte a été créé.
allowCallback
 allowCallback boolean

Définissez si ce compte est autorisé à utiliser le mécanisme de rappel.
callbackToken
 callbackToken string

Jeton de rappel
type
 type integer

Type de compte (maître ou sous-compte)
type de compte
 accountType integer

Nom du type de compte
isApproved
 isApproved boolean

Le compte est approuvé ou non

ContactResponse

Nom Chemin d’accès Type Description
accountId
 accountId integer

ID de compte
numéro de téléphone
 phoneNumber string

Numéro de téléphone
Messagerie électronique
 email string

Messagerie électronique
preferredLanguageId
 preferredLanguageId string

ID de langue préféré
preferredLanguage
 preferredLanguage string

Langue préférée
assignedId
 assignedId string

ID affecté
firstName
 firstName string

Prénom
lastName
 lastName string

Nom de famille
phoneStatusId
 phoneStatusId integer

ID d’état du téléphone
phoneStatus
 phoneStatus integer

État du téléphone
phoneHardErrorCount
 phoneHardErrorCount integer

Nombre d’erreurs matérielles du téléphone
phoneSoftErrorCount
 phoneSoftErrorCount integer

Nombre d’erreurs réversibles par téléphone
phoneTotalHardErrorCount
 phoneTotalHardErrorCount integer

Nombre total d’erreurs matérielles du téléphone
phoneTotalSoftErrorCount
 phoneTotalSoftErrorCount integer

Nombre total d’erreurs réversibles par téléphone
phoneLastHardError
 phoneLastHardError string

Dernière erreur matérielle du téléphone
phoneLastSoftError
 phoneLastSoftError string

Dernière erreur réversible du téléphone
phoneHardErrorSince
 phoneHardErrorSince string

Erreur matérielle du téléphone depuis
phoneSoftErrorSince
 phoneSoftErrorSince string

Erreur réversible du téléphone depuis
statusId
 statusId integer

ID d’état
créé
 created string

créé
modified
 modified string

modified
createdBy
 createdBy string

créé par
modifiedBy
 modifiedBy string

modifié par
pièce d'identité
 id integer

pièce d'identité

ContactSearchRequest

Nom Chemin d’accès Type Description
pièce d'identité
 id integer

pièce d'identité
accountId
 accountId integer

ID de compte
statusId
 statusId integer

ID d’état
numéro de téléphone
 phoneNumber string

Numéro de téléphone
Messagerie électronique
 email string

Messagerie électronique
assignedId
 assignedId string

ID affecté
firstName
 firstName string

Prénom
lastName
 lastName string

Nom de famille
Abonnements
 subscriptions array of

Abonnements
attributes
 attributes array of

attributes
phoneStatusId
 phoneStatusId integer

ID d’état du téléphone
créé
 created string

créé
createdBy
 createdBy string

créé par
modified
 modified string

modified
modifiedBy
 modifiedBy string

modifié par

PushCampaignResponse

Nom Chemin d’accès Type Description
channels
 channels array of

channels
targets
 targets array of string

targets
targetsUrl
 targetsUrl string

URL des cibles
targetsColumn
 targetsColumn string

targets Column
contactListIds
 contactListIds array of

ID de liste de contacts
excludeListIds
 excludeListIds array of

exclure les ID de liste
campaignId
 campaignId integer

ID de campagne
mediaId
 mediaId string

ID de média
Message
 message string

Message
de
 from string

de
Objet
 subject string

Objet
ignoreSingleUse
 ignoreSingleUse boolean

ignorer l’utilisation unique
forceOptIn
 forceOptIn boolean

force Opt-In
statusId
 statusId integer

ID d’état
roundRobinById
 roundRobinById boolean

tourniquet par ID
globalRoundRobin
 globalRoundRobin boolean

Global Round Robin
status
 status string

status
pièce d'identité
 id integer

pièce d'identité
accountId
 accountId integer

ID de compte
créé
 created string

créé
modified
 modified string

modified
createdBy
 createdBy string

créé par
modifiedBy
 modifiedBy string

modifié par
schedules
 schedules array of

schedules

UserResponse

Nom Chemin d’accès Type Description
nom d’utilisateur
 userName string

nom d’utilisateur
accountId
 accountId integer

ID de compte
Messagerie électronique
 email string

Messagerie électronique
firstName
 firstName string

Prénom
lastName
 lastName string

Nom de famille
numéro de téléphone
 phoneNumber string

Numéro de téléphone
isAdmin
 isAdmin boolean

est Administrateur
key
 apiKey.key string

key
secret
 apiKey.secret string

secret
lastActivity
 apiKey.lastActivity string

dernière activité
typeId
 apiKey.typeId integer

ID de type
type
 apiKey.type integer

type
label
 apiKey.label string

label
nom d’utilisateur
 apiKey.userName string

nom d’utilisateur
validTo
 apiKey.validTo string

valide à
accountId
 apiKey.accountId integer

ID de compte
pièce d'identité
 apiKey.id integer

pièce d'identité
isChatUser
 isChatUser boolean

is Chat User
reportOnly
 reportOnly boolean

rapport uniquement
requestNumber
 requestNumber boolean

numéro de requête
canCreateContact
 canCreateContact boolean

peut créer un contact
isAlertAgent
 isAlertAgent boolean

is Alert Agent
convenu
 agreed boolean

convenu
commentaire
 comment string

commentaire
isApproved
 isApproved boolean

est approuvé
isLockedOut
 isLockedOut boolean

est verrouillé
lastLockoutDate
 lastLockoutDate string

date du dernier verrouillage
date de création
 creationDate string

date de création
lastLoginDate
 lastLoginDate string

date de la dernière connexion
lastActivityDate
 lastActivityDate string

date de la dernière activité
lastPasswordChangedDate
 lastPasswordChangedDate string

date de modification du dernier mot de passe