Delen via

TrueDialog SMS

TrueDialog SMS-connector biedt een mogelijkheid om massa- en afzonderlijke sms-berichten te verzenden via lange code en korte code.

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 Ondersteuning voor TrueDialog
URL https://www.truedialog.com/help/
E-mailen support@truedialog.com
Connectormetagegevens
Uitgever TrueDialog Dynamics
Webpagina https://www.truedialog.com/
Privacybeleid https://www.truedialog.com/privacy-policy/
Categorieën Communication

De SMS-API van TrueDialog is bedrijfsmatig met meer vooraf gebouwde functies dan andere SMS-software. Gebouwd voor ontwikkelaars is onze SMS-API zeer betrouwbaar, veilig en bevat een vooraf gebouwde ISO 9001-database voor extra opt-out- en nalevingsbeveiliging. Ook beschikbaar via onze volledige Enterprise-Grade SMS Texting Software.

Vereiste voorwaarden

U hebt deze referenties nodig om door te gaan:

  • Een Microsoft Power Apps- of Power Automate-abonnement
  • Een TrueDialog-account en plan en uw TrueDialog-API-sleutel en geheime code voor uw account. Klik HIER om u te registreren.

Referenties ophalen

Klik HIER om u te registreren. Wanneer u zich registreert voor TrueDialog, staan de API-sleutel en Geheime code in uw e-mailadressen. Neem contact op met ons team voor hulp om aan de slag te gaan. Ons eersteklas clientservicesteam begeleidt u bij de registratie en het kiezen van het beste account voor de behoeften van uw bedrijf.

NEEM CONTACT MET ONS OP:

e-mailadres support@truedialog.com
Live chatten https://www.truedialog.com/
Telefoon 512-501-5940

Aan de slag met TrueDialog-connector

Zodra u uw referenties hebt, kunt u de connector gaan gebruiken.

Acties

Sms verzenden

De meest waardevolle actie is 'Sms verzenden'. Hiermee kunt u sms verzenden naar één of meerdere geadresseerden. Deze actie heeft verschillende vereiste velden:

  • Account-id: kan worden gebruikt vanuit het antwoord Huidige gebruikersgegevens ophalen of kan in code worden vastgelegd.
  • Kanaal: laat de standaardwaarde 22 staan voor het gebruik van het standaard gekoppelde telefoonnummer.
  • Doelen: geldig amerikaans telefoonnummer zonder opmaak (bijvoorbeeld + 15125453809)
  • Bericht: het bericht zelf.
  • Uitvoeren: laat de standaardwaarde Waar staan als u het verzenden niet wilt uitstellen.

Triggers

De lijst met callbacks die zijn geregistreerd voor een account, vindt u hier: https://ui.truedialog.com/Callbacks

Ontvangen binnenkomend bericht

De belangrijkste trigger. Met deze bewerking wordt een stroom geactiveerd wanneer de eindgebruiker naar het bijbehorende telefoonnummer sms'en.

Account-id is vereist om de trigger te registreren. U kunt een account-id ophalen via de TD-portal. Deze bevindt zich naast de accountnaam in de rechterbovenhoek.

Binnenkomend bericht bevat berichttekst en andere benodigde velden.

Bericht stoppen dat is ontvangen

Met deze bewerking wordt een stroom geactiveerd wanneer eindgebruikers sms'en in STOP of synoniem. Er wordt ook automatisch een opt-out-contactpersoon in het TrueDialog-systeem weergegeven. Als u een bericht naar de afmeldingscontactpersoon wilt verzenden, stelt u de vlag forceOptIn in op True wanneer u sms verzendt. Gebruik deze ForceOptIt-functie met voorzichtigheid en zorg ervoor dat u de uitgestelde records bijhoudt.

Gebruikers een stapsgewijs proces bieden om aan de slag te gaan met uw connector. Hier moet u veelvoorkomende use cases markeren, zoals uw verwachte populaire triggers en acties, en hoe ze kunnen helpen bij automatiseringsscenario's. Voeg waar mogelijk afbeeldingen toe.

Ontvangen bezorgingsbericht

Met deze bewerking wordt een stroom geactiveerd voor elke ontvangstbevestiging. Houd er rekening mee dat niet alle mobiele providers een ontvangstbewijs verzenden.

Ongeldige doelen

Wanneer een van de doeltelefoons ongeldig is of op de zwarte lijst staat, is het nog steeds mogelijk om sms te verzenden en krijgt u geen foutmelding. Hiervoor moet u de eigenschap IgnoreInvalidTargets instellen op true wanneer u een bericht verzendt. Als er ongeldige telefoonnummers worden weergegeven in de lijst met verzonden sms-geadresseerden, activeert deze bewerking een stromen.

Bekende problemen en beperkingen

TrueDialog-API heeft meer mogelijkheden, vergeleken met de aangepaste connector

Veelgestelde vragen

Als u de meest recente beschrijving van de ongedaan makende API wilt ophalen, gaat u hier naar

Geef hier een overzicht van veelgestelde vragen en hun respectieve antwoorden. Dit kan betrekking hebben op veelgestelde vragen over interactie met de onderliggende service of over de connector zelf.

Een verbinding maken

De connector ondersteunt de volgende verificatietypen:
standaard Parameters voor het maken van verbinding. Alle regio's Niet deelbaar

Verstek

Van toepassing: Alle regio's

Parameters voor het maken van verbinding.

Dit is geen deelbare verbinding. Als de power-app wordt gedeeld met een andere gebruiker, wordt een andere gebruiker gevraagd om expliciet een nieuwe verbinding te maken.

Naam Typologie Description Verplicht
username beveiligde string De gebruikersnaam voor deze API Klopt
wachtwoord beveiligde string Het wachtwoord voor deze API Klopt

Beperkingslimieten

Name Aanroepen Verlengingsperiode
API-aanroepen per verbinding 100 60 seconden

Acties

Accountgegevens ophalen

Informatie over account ophalen
Contact bijwerken

Contactpersoon bijwerken
Contactpersoon maken

Een contactpersoonrecord maken in TrueDialog
Huidige gebruikersgegevens ophalen

Informatie ophalen over de gebruiker, waarvan de referenties zijn gebruikt in Verbinding
Sms verzenden

Sms verzenden naar één of meerdere geadresseerden
Zoeken naar contactpersonen

Zoekt naar een contactpersoon via een telefoonnummer of e-mailadres.

Accountgegevens ophalen

Bewerkings-id:
Account_Get_Info

Informatie over account ophalen

Parameters

Name Sleutel Vereist Type Description
Id van het account, dat moet worden opgehaald
 accountId True string

Account-ID

Retouren

Body
AccountResponse

Contact bijwerken

Bewerkings-id:
Contact_Update

Contactpersoon bijwerken

Parameters

Name Sleutel Vereist Type Description
Account-ID
 accountId True string

Account-id die wordt gebruikt als bovenliggend account voor bijgewerkte contactpersoon
Contactpersoon-id
 contactid True string

Id van de contactpersoon die wordt bijgewerkt
Telefoonnummer
 PhoneNumber string

Mobiel nummer indien beschikbaar. Dit of het veld E-mail zijn VEREIST
E-mailen
 Email string

E-mailadres van de contactpersoon. Dit of het veld PhoneNumber zijn VEREIST.
Voornaam
 FirstName string

Voornaam van de contactpersoon.
Achternaam
 LastName string

Achternaam van de contactpersoon.

Retouren

Body
ContactResponse

Contactpersoon maken

Bewerkings-id:
Contact_Create

Een contactpersoonrecord maken in TrueDialog

Parameters

Name Sleutel Vereist Type Description
Account-ID
 accountId True string

Account-id die wordt gebruikt als bovenliggend account voor gemaakte contactpersoon
Telefoonnummer
 PhoneNumber string

Mobiel nummer indien beschikbaar. Dit of het veld E-mail zijn VEREIST
E-mailen
 Email string

E-mailadres van de contactpersoon. Dit of het veld PhoneNumber zijn VEREIST.
Voornaam
 FirstName string

Voornaam van de contactpersoon.
Achternaam
 LastName string

Achternaam van de contactpersoon.

Retouren

Body
ContactResponse

Huidige gebruikersgegevens ophalen

Bewerkings-id:
User_Get_Self_Info

Informatie ophalen over de gebruiker, waarvan de referenties zijn gebruikt in Verbinding

Retouren

Body
UserResponse

Sms verzenden

Bewerkings-id:
Campaign_Push

Sms verzenden naar één of meerdere geadresseerden

Parameters

Name Sleutel Vereist Type Description
Account-ID
 accountId True string

Account-id die wordt gebruikt voor het verzenden van sms
Kanalen
 Channels True array of string

Kanalen
Targets
 Targets True array of string

Targets
ContactListIds
 ContactListIds array of string

Lijst-id's van contactpersonen
ExcludeListIds
 ExcludeListIds array of string

Lijst-id's uitsluiten
Media-id
 MediaId integer

Media-id
Message
 Message True string

Message
Eén gebruik negeren
 IgnoreSingleUse boolean

Eén gebruik negeren
ForceOptIn
 ForceOptIn boolean

Forceer Opt-In
Planningen
 Schedules array of string

De lijst met planningen die zijn gekoppeld aan de actie
Execute
 Execute True boolean

Stel waar in als de actie moet worden uitgevoerd bij het maken
IgnoreInvalidTargets
 IgnoreInvalidTargets boolean

Geeft aan of ongeldige getallen moeten worden genegeerd

Retouren

Body
PushCampaignResponse

Zoeken naar contactpersonen

Bewerkings-id:
Contact_Search

Zoekt naar een contactpersoon via een telefoonnummer of e-mailadres.

Parameters

Name Sleutel Vereist Type Description
Account-id voor abonnement
 accountId True string

Het account waarop de contactpersoon zichtbaar is.
Telefoonnummer om te zoeken
 phone True string

Zoek bestaande contactpersonen met het doorgegeven telefoonnummer of e-mailadres.

Retouren

Artikelen
ContactSearchRequest

Triggers

Bericht stoppen dat is ontvangen

Deze bewerking activeert een stroom wanneer eindgebruikers teksten in STOP of synoniem
Ongeldige doelen

Met deze bewerking wordt een stroom geactiveerd als doelen zijn gefilterd tijdens het verzenden van sms
Ontvangen bezorgingsbericht

Met deze bewerking wordt een stroom geactiveerd voor elke ontvangstbevestiging
Ontvangen binnenkomend bericht

Met deze bewerking wordt een stroom geactiveerd wanneer eindgebruikers sms'en in
Trefwoord ontvangen

Deze bewerking activeert een stroom wanneer eindgebruikers teksten in een trefwoord

Bericht stoppen dat is ontvangen

Bewerkings-id:
Stop_received

Deze bewerking activeert een stroom wanneer eindgebruikers teksten in STOP of synoniem

Parameters

Name Sleutel Vereist Type Description
Account-id voor abonnement
 accountId True string

Gebruik de hoofdaccount-id in de meeste gevallen om u te abonneren op meldingen.

Retouren

Name Pad Type Description
Tijdstempel van callback
 CallbackTimestamp string

De datum en tijd waarop de callback is verzonden. Indeling: jjjj-MM-ddTHH:mm:ss
CallbackToken
 CallbackToken string

Callback-token
TransactionId
 TransactionId string

Transactie-id
Account-id
 AccountId integer

Account-ID
Accountnaam
 AccountName string

De naam van het account waaraan de callback is gekoppeld
ChannelId
 ChannelId integer

Methode-id
Kanaalcode
 ChannelCode string

Code van het kanaal dat het bericht heeft verzonden (het werkelijke telefoonnummer voor lange codes)
Contact-ID
 ContactId integer

Contactpersoon-ID
ContactAccountId
 ContactAccountId integer

De id van het account dat eigenaar is van de contactpersoonrecord
ContactAccountName
 ContactAccountName string

De naam van het account dat eigenaar is van de record van de contactpersoon
Telefoonnummer
 PhoneNumber string

Het telefoonnummer van de eindgebruiker die is afgemeld

Ongeldige doelen

Bewerkings-id:
Invalid_Targets

Met deze bewerking wordt een stroom geactiveerd als doelen zijn gefilterd tijdens het verzenden van sms

Parameters

Name Sleutel Vereist Type Description
Account-id voor abonnement
 accountId True string

Gebruik de hoofdaccount-id in de meeste gevallen om u te abonneren op meldingen.

Retouren

Name Pad Type Description
Tijdstempel van callback
 CallbackTimestamp string

De datum en tijd waarop de callback is verzonden. Indeling: jjjj-MM-ddTHH:mm:ss
CallbackURL
 CallbackURL string

URL voor aanroep
TransactionId
 TransactionId string

Transactie-id
Account-id
 AccountId integer

Account-ID
ActionId
 ActionId integer

Actie-id
RunId
 RunId integer

Run Id
InvalidTargets
 InvalidTargets array of object

Ongeldige doelen
Doel
 InvalidTargets.Target string

Het doel dat is uitgefilterd
ReasonId
 InvalidTargets.ReasonId integer

Id van de reden. 0 - Ongeldig, 1 - Opted Out, 2 - Duplicate, 3 - Blocked, 4 - Undeliverable, 5 - Single Use
Reden
 InvalidTargets.Reason string

Korte beschrijving van een reden

Ontvangen bezorgingsbericht

Bewerkings-id:
Delivery_Notice_received

Met deze bewerking wordt een stroom geactiveerd voor elke ontvangstbevestiging

Parameters

Name Sleutel Vereist Type Description
Account-id voor abonnement
 accountId True string

Gebruik de hoofdaccount-id in de meeste gevallen om u te abonneren op meldingen.

Retouren

Name Pad Type Description
Tijdstempel van callback
 CallbackTimestamp string

De datum en tijd waarop de callback is verzonden. Indeling: jjjj-MM-ddTHH:mm:ss
CallbackToken
 CallbackToken string

Callback-token
TransactionId
 TransactionId string

Transactie-id
Account-id
 AccountId integer

Account-ID
Accountnaam
 AccountName string

De naam van het account waaraan de callback is gekoppeld
Status-id
 StatusId integer

2 = Geleverd; 3 = Niet bezorgd; 7 = Onbekend
Toestand
 Status string

Bezorgingscode - OK voor bezorgd bericht of foutcode. Voor onbestelbaar - null
ChannelId
 ChannelId integer

Methode-id
Kanaalcode
 ChannelCode string

Code van het kanaal dat het bericht heeft verzonden (het werkelijke telefoonnummer voor lange codes)
MessageId
 MessageId string

MessageId
Telefoonnummer
 PhoneNumber string

Telefoonnummer
Contact-ID
 ContactId integer

Contactpersoon-ID
ActionId
 ActionId integer

Actie-id
Message
 Message string

De werkelijke berichttekst

Ontvangen binnenkomend bericht

Bewerkings-id:
Incoming_SMS_Received

Met deze bewerking wordt een stroom geactiveerd wanneer eindgebruikers sms'en in

Parameters

Name Sleutel Vereist Type Description
Account-id voor abonnement
 AccountId True string

Gebruik de hoofdaccount-id in de meeste gevallen om u te abonneren op meldingen.

Retouren

Name Pad Type Description
Accountnaam
 AccountName string

De naam van het account waaraan de callback is gekoppeld
Kanaalcode
 ChannelCode string

Code van het kanaal dat het bericht heeft verzonden (het werkelijke telefoonnummer voor lange codes)
ChannelId
 ChannelId integer

Id van het kanaal dat het bericht is verzonden
Contact-ID
 ContactId integer

Contactpersoon-id indien aanwezig (null voor onbekende contactpersonen)
Message
 Message string

De werkelijke berichttekst
Telefoonnummer
 PhoneNumber string

Doeltelefoonnummer
Account-id
 AccountId integer

De id van het account waaraan de callback is gekoppeld
Tijdstempel van callback
 CallbackTimestamp string

De datum en tijd waarop de callback is verzonden. Indeling: jjjj-MM-ddTHH:mm:ss
CallbackToken
 CallbackToken string

Callback-token
TransactionId
 TransactionId string

Uniek token

Trefwoord ontvangen

Bewerkings-id:
Keyword_received

Deze bewerking activeert een stroom wanneer eindgebruikers teksten in een trefwoord

Parameters

Name Sleutel Vereist Type Description
Account-id voor abonnement
 accountId True string

Gebruik de hoofdaccount-id in de meeste gevallen om u te abonneren op meldingen.

Retouren

Name Pad Type Description
Tijdstempel van callback
 CallbackTimestamp string

Datum en tijd waarop de callback is verzonden: jjjj-MM-ddTHH:mm:ss
CallbackToken
 CallbackToken string

Callback-token
TransactionId
 TransactionId string

Transactie-id
Account-id
 AccountId integer

De id van het account waaraan de callback is gekoppeld
Accountnaam
 AccountName string

De naam van het account waaraan de callback is gekoppeld
Campagne-ID
 CampaignId integer

Campagne-id
ChannelId
 ChannelId integer

Methode-id
Kanaalcode
 ChannelCode string

Code van het kanaal dat het bericht heeft verzonden (het werkelijke telefoonnummer voor lange codes)
Contact-ID
 ContactId integer

Id van de contactpersoon die het trefwoord heeft ingediend
Keyword
 Keyword string

Het werkelijke trefwoord dat is verzonden
KeywordId
 KeywordId integer

Id van het trefwoord dat is verzonden
Message
 Message string

De werkelijke berichttekst
Telefoonnummer
 PhoneNumber string

Het telefoonnummer van de eindgebruiker die het trefwoord heeft ingediend

Definities

AccountResponse

Name Pad Type Description
identiteitskaart
 id integer

De id van het account.
status
 status integer

De huidige status van het account.
ouder-ID
 parentId integer

De id van het account dat het bovenliggende account is.
naam
 name string

De naam van het account
geschapen
 created string

Toen het account is gemaakt.
allowCallback
 allowCallback boolean

Instellen of dit account het callback-mechanisme mag gebruiken.
callbackToken
 callbackToken string

Callback-token
type
 type integer

Accounttype (hoofd- of subaccount)
accountType
 accountType integer

Accounttypenaam
isApproved
 isApproved boolean

Account is goedgekeurd of niet

ContactResponse

Name Pad Type Description
accountId
 accountId integer

Account-ID
telefoonnummer
 phoneNumber string

Telefoonnummer
e-mailadres
 email string

e-mailadres
preferredLanguageId
 preferredLanguageId string

voorkeurstaal-id
voorkeurstaal
 preferredLanguage string

Voorkeurstaal
assignedId
 assignedId string

toegewezen id
voornaam
 firstName string

Voornaam
achternaam
 lastName string

Achternaam
phoneStatusId
 phoneStatusId integer

telefoonstatus-id
phoneStatus
 phoneStatus integer

telefoonstatus
phoneHardErrorCount
 phoneHardErrorCount integer

aantal harde fouten
phoneSoftErrorCount
 phoneSoftErrorCount integer

aantal zachte telefoonfouten
phoneTotalHardErrorCount
 phoneTotalHardErrorCount integer

totaal aantal harde fouten per telefoon
phoneTotalSoftErrorCount
 phoneTotalSoftErrorCount integer

totaal aantal zachte fouten per telefoon
phoneLastHardError
 phoneLastHardError string

laatste harde telefoonfout
phoneLastSoftError
 phoneLastSoftError string

laatste zachte telefoonfout
phoneHardErrorSince
 phoneHardErrorSince string

harde telefoonfout sinds
phoneSoftErrorSince
 phoneSoftErrorSince string

zachte telefoonfout sinds
statusId
 statusId integer

status-id
geschapen
 created string

geschapen
modified
 modified string

modified
gemaakt door
 createdBy string

gemaakt door
modifiedBy
 modifiedBy string

gewijzigd door
identiteitskaart
 id integer

identiteitskaart

ContactSearchRequest

Name Pad Type Description
identiteitskaart
 id integer

identiteitskaart
accountId
 accountId integer

Account-ID
statusId
 statusId integer

status-id
telefoonnummer
 phoneNumber string

Telefoonnummer
e-mailadres
 email string

e-mailadres
assignedId
 assignedId string

toegewezen id
voornaam
 firstName string

Voornaam
achternaam
 lastName string

Achternaam
subscriptions
 subscriptions array of

subscriptions
attributes
 attributes array of

attributes
phoneStatusId
 phoneStatusId integer

telefoonstatus-id
geschapen
 created string

geschapen
gemaakt door
 createdBy string

gemaakt door
modified
 modified string

modified
modifiedBy
 modifiedBy string

gewijzigd door

PushCampaignResponse

Name Pad Type Description
Kanalen
 channels array of

Kanalen
targets
 targets array of string

targets
targetsUrl
 targetsUrl string

doel-URL
targetsColumn
 targetsColumn string

doelen kolom
contactListIds
 contactListIds array of

Lijst-id's van contactpersonen
excludeListIds
 excludeListIds array of

lijst-id's uitsluiten
campaignId
 campaignId integer

campagne-id
mediaId
 mediaId string

media-id
message
 message string

message
van
 from string

van
Onderwerp
 subject string

Onderwerp
ignoreSingleUse
 ignoreSingleUse boolean

single use negeren
forceOptIn
 forceOptIn boolean

forceren Opt-In
statusId
 statusId integer

status-id
roundRobinById
 roundRobinById boolean

round Robin By Id
globalRoundRobin
 globalRoundRobin boolean

global Round Robin
status
 status string

status
identiteitskaart
 id integer

identiteitskaart
accountId
 accountId integer

Account-ID
geschapen
 created string

geschapen
modified
 modified string

modified
gemaakt door
 createdBy string

gemaakt door
modifiedBy
 modifiedBy string

gewijzigd door
Planningen
 schedules array of

Planningen

UserResponse

Name Pad Type Description
gebruikersnaam
 userName string

gebruikersnaam
accountId
 accountId integer

Account-ID
e-mailadres
 email string

e-mailadres
voornaam
 firstName string

Voornaam
achternaam
 lastName string

Achternaam
telefoonnummer
 phoneNumber string

Telefoonnummer
isAdmin
 isAdmin boolean

is beheerder
key
 apiKey.key string

key
secret
 apiKey.secret string

secret
lastActivity
 apiKey.lastActivity string

laatste activiteit
typeId
 apiKey.typeId integer

type-id
type
 apiKey.type integer

type
label
 apiKey.label string

label
gebruikersnaam
 apiKey.userName string

gebruikersnaam
validTo
 apiKey.validTo string

geldig tot
accountId
 apiKey.accountId integer

Account-ID
identiteitskaart
 apiKey.id integer

identiteitskaart
isChatUser
 isChatUser boolean

is Chatgebruiker
reportOnly
 reportOnly boolean

alleen rapport
requestNumber
 requestNumber boolean

aanvraagnummer
canCreateContact
 canCreateContact boolean

kan contactpersoon maken
isAlertAgent
 isAlertAgent boolean

is waarschuwingsagent
afgesproken
 agreed boolean

afgesproken
reactie
 comment string

reactie
isApproved
 isApproved boolean

is goedgekeurd
isLockedOut
 isLockedOut boolean

is vergrendeld
lastLockoutDate
 lastLockoutDate string

laatste vergrendelingsdatum
creatiedatum
 creationDate string

aanmaakdatum
lastLoginDate
 lastLoginDate string

laatste aanmeldingsdatum
lastActivityDate
 lastActivityDate string

datum van laatste activiteit
lastPasswordChangedDate
 lastPasswordChangedDate string

Datum van laatste wachtwoord gewijzigd