Compartir a través de


TrueDialog SMS

El conector de SMS TrueDialog permite enviar mensajes de texto masivos e individuales a través de código largo y código corto.

Este conector está disponible en los siguientes productos y regiones:

Service Class Regions
Copilot Studio Premium Todas las regiones de Power Automate excepto las siguientes:
     - Gobierno de EE. UU. (GCC)
     - Gobierno de EE. UU. (GCC High)
     - China Cloud operado por 21Vianet
     - Departamento de Defensa de EE. UU. (DoD)
Aplicaciones lógicas Estándar Todas las regiones de Logic Apps excepto las siguientes:
     - Regiones de Azure Government
     - Regiones de Azure China
     - Departamento de Defensa de EE. UU. (DoD)
Power Apps Premium Todas las regiones de Power Apps excepto las siguientes:
     - Gobierno de EE. UU. (GCC)
     - Gobierno de EE. UU. (GCC High)
     - China Cloud operado por 21Vianet
     - Departamento de Defensa de EE. UU. (DoD)
Power Automate Premium Todas las regiones de Power Automate excepto las siguientes:
     - Gobierno de EE. UU. (GCC)
     - Gobierno de EE. UU. (GCC High)
     - China Cloud operado por 21Vianet
     - Departamento de Defensa de EE. UU. (DoD)
Contacto
Nombre Compatibilidad con TrueDialog
URL https://www.truedialog.com/help/
Correo Electrónico support@truedialog.com
Metadatos del conector
Publicador TrueDialog Dynamics
Website https://www.truedialog.com/
Directiva de privacidad https://www.truedialog.com/privacy-policy/
Categorías Communication

La API de SMS de TrueDialog es de nivel empresarial con más características pregeneradas que cualquier otro software sms. Compilada para desarrolladores, nuestra API de SMS es altamente confiable, segura e incluye una base de datos ISO 9001 pregenerada para la protección adicional de exclusión y cumplimiento. También está disponible a través de nuestro completo Enterprise-Grade sms Texting Software.

Prerrequisitos

Necesitará estas credenciales para continuar:

  • Un plan de Microsoft Power Apps o Power Automate
  • Una cuenta y un plan de TrueDialog y su clave de API trueDialog y el código secreto de su cuenta. Haga clic aquí para registrarse.

Obtención de credenciales

Haga clic aquí para registrarse. Al registrarse en TrueDialog, la clave de API y el código secreto estarán en el correo electrónico de las credenciales. Para obtener ayuda para empezar, póngase en contacto con nuestro equipo. Nuestro equipo de Servicios de cliente de primera clase le guiará por el registro y la elección de la mejor cuenta para las necesidades de su empresa.

CONTÁCTENOS:

Correo electrónico support@truedialog.com
Chat en directo https://www.truedialog.com/
Teléfono 512-501-5940

Introducción al conector TrueDialog

Una vez que tenga sus credenciales, puede empezar a usar el conector.

Acciones

Envío de SMS

La acción más valiosa es "Enviar SMS". Permite enviar SMS a uno o varios destinatarios. Esta acción tiene varios campos obligatorios:

  • Id. de cuenta: se puede usar desde la respuesta Obtener información de usuario actual o se podría codificar de forma hardcode.
  • Canal: deje el valor predeterminado 22 para usar el número de teléfono asociado predeterminado.
  • Destinos: número de teléfono válido de EE. UU. sin formato (por ejemplo: +15125453809)
  • Mensaje: el propio mensaje.
  • Ejecutar: deje el valor predeterminado True si no desea posponer el envío.

Desencadenadores

La lista de devoluciones de llamada registradas para una cuenta se puede encontrar aquí: https://ui.truedialog.com/Callbacks

Mensaje entrante recibido

El desencadenador más importante. Esta operación desencadena un flujo cada vez que el usuario final escribe en el número de teléfono asociado.

El identificador de cuenta es necesario para registrar el desencadenador. Puede obtener un identificador de cuenta a través del portal de TD, que se encuentra junto al nombre de la cuenta en la esquina superior derecha.

El mensaje entrante contiene texto del mensaje y otros campos necesarios.

Detener mensaje recibido

Esta operación desencadena un flujo cada vez que el usuario final escribe en STOP o sinónimo. También opta automáticamente por no participar en el sistema TrueDialog. Para enviar un mensaje al contacto opt-out, establezca la marca forceOptIn en True al enviar SMS. Use esta característica ForceOptIt con precaución y asegúrese de realizar un seguimiento de los registros que optó.

Proporcione a los usuarios un proceso paso a paso para empezar a trabajar con el conector. Aquí es donde debe resaltar los casos de uso comunes, como los desencadenadores y acciones populares esperados, y cómo pueden ayudar en escenarios de automatización. Incluya imágenes siempre que sea posible.

Aviso de entrega recibido

Esta operación desencadena un flujo para cada recibo de aviso de entrega. Tenga en cuenta que no todos los transportistas móviles envían un recibo de aviso.

Destinos no válidos

Cuando uno de los teléfonos de destino no es válido o está en la lista negra, todavía es posible enviar SMS y no obtener un error. Para ello, debe establecer la propiedad "IgnoreInvalidTargets" en true cuando envíe un mensaje. Si se presentaron números de teléfono no válidos en la lista de destinatarios SMS enviados, esta operación desencadena un flujo.

Problemas y limitaciones conocidos

La API TrueDialog tiene más funcionalidades, en comparación con el conector personalizado.

Preguntas más frecuentes

Para obtener la descripción más reciente de la API sin problemas, visite AQUÍ.

Proporcione un desglose de las preguntas más frecuentes y sus respuestas respectivas aquí. Esto puede abarcar preguntas más frecuentes sobre la interacción con el servicio subyacente o sobre el propio conector.

Creación de una conexión

El conector admite los siguientes tipos de autenticación:

Predeterminado Parámetros para crear una conexión. Todas las regiones No se puede compartir

Predeterminado

Aplicable: Todas las regiones

Parámetros para crear una conexión.

Esta conexión no se puede compartir. Si la aplicación de energía se comparte con otro usuario, se pedirá a otro usuario que cree explícitamente una nueva conexión.

Nombre Tipo Description Obligatorio
nombre de usuario securestring El nombre de usuario de esta API Cierto
contraseña securestring La contraseña de esta API Cierto

Limitaciones

Nombre Llamadas Período de renovación
Llamadas API por conexión 100 60 segundos

Acciones

Actualización de contacto

Actualizar contacto

Búsqueda de contactos

Busca un contacto a través de un número de teléfono o dirección de correo electrónico.

Envío de SMS

Envío de SMS a uno o varios destinatarios

Obtener información de la cuenta

Obtener información sobre la cuenta

Obtener información de usuario actual

Obtener información sobre el usuario, cuyas credenciales se usaron en Connection

Ponerse en contacto con Create

Creación de un registro de contacto en TrueDialog

Actualización de contacto

Actualizar contacto

Parámetros

Nombre Clave Requerido Tipo Description
Id. de cuenta
accountId True string

Identificador de cuenta que se usaría como cuenta primaria para el contacto actualizado

ID de contacto
contactid True string

Identificador del contacto que se actualizaría

Número de teléfono
PhoneNumber string

Número de móvil si está disponible. Este o el campo Correo electrónico son OBLIGATORIOs

Correo Electrónico
Email string

Dirección de correo electrónico del contacto. Este o el campo PhoneNumber son OBLIGATORIOs.

Primer Nombre
FirstName string

Nombre del contacto.

Apellido
LastName string

Apellidos del contacto.

Devoluciones

Búsqueda de contactos

Busca un contacto a través de un número de teléfono o dirección de correo electrónico.

Parámetros

Nombre Clave Requerido Tipo Description
Identificador de cuenta de la suscripción
accountId True string

Cuenta a la que está visible el contacto.

Número de teléfono que se va a buscar
phone True string

Busque contactos existentes con el número de teléfono o el correo electrónico pasados.

Devoluciones

Envío de SMS

Envío de SMS a uno o varios destinatarios

Parámetros

Nombre Clave Requerido Tipo Description
Id. de cuenta
accountId True string

Identificador de cuenta que se usaría para enviar SMS

Canales
Channels True array of string

Canales

Targets
Targets True array of string

Targets

ContactListIds
ContactListIds array of string

Identificadores de lista de contactos

ExcludeListIds
ExcludeListIds array of string

Excluir identificadores de lista

Id. de medio
MediaId integer

Id. de medio

Message
Message True string

Message

Omitir uso único
IgnoreSingleUse boolean

Omitir uso único

ForceOptIn
ForceOptIn boolean

Forzar Opt-In

Horarios
Schedules array of string

Lista de programaciones asociadas a la acción

Execute
Execute True boolean

Establezca true si la acción se debe ejecutar al crearse

IgnoreInvalidTargets
IgnoreInvalidTargets boolean

Indica si se deben omitir números no válidos.

Devoluciones

Obtener información de la cuenta

Obtener información sobre la cuenta

Parámetros

Nombre Clave Requerido Tipo Description
Identificador de la cuenta, que se debe recuperar
accountId True string

ID de cuenta

Devoluciones

Obtener información de usuario actual

Obtener información sobre el usuario, cuyas credenciales se usaron en Connection

Devoluciones

Ponerse en contacto con Create

Creación de un registro de contacto en TrueDialog

Parámetros

Nombre Clave Requerido Tipo Description
Id. de cuenta
accountId True string

Identificador de cuenta que se usaría como cuenta primaria para el contacto creado

Número de teléfono
PhoneNumber string

Número de móvil si está disponible. Este o el campo Correo electrónico son OBLIGATORIOs

Correo Electrónico
Email string

Dirección de correo electrónico del contacto. Este o el campo PhoneNumber son OBLIGATORIOs.

Primer Nombre
FirstName string

Nombre del contacto.

Apellido
LastName string

Apellidos del contacto.

Devoluciones

Desencadenadores

Aviso de entrega recibido

Esta operación desencadena un flujo para cada recibo de aviso de entrega.

Destinos no válidos

Esta operación desencadena un flujo si los destinos se han filtrado durante el envío de SMS

Detener mensaje recibido

Esta operación desencadena un flujo cada vez que el usuario final escribe en STOP o sinónimo

Mensaje entrante recibido

Esta operación desencadena un flujo cada vez que el usuario final escribe en

Palabra clave recibida

Esta operación desencadena un flujo cada vez que el usuario final escribe en una palabra clave

Aviso de entrega recibido

Esta operación desencadena un flujo para cada recibo de aviso de entrega.

Parámetros

Nombre Clave Requerido Tipo Description
Identificador de cuenta de la suscripción
accountId True string

Use el identificador de cuenta raíz en la mayoría de los casos para suscribirse a las notificaciones.

Devoluciones

Nombre Ruta de acceso Tipo Description
Marca de tiempo de devolución de llamada
CallbackTimestamp string

Fecha y hora en que se ha enviado la devolución de llamada. Formato: aaaa-MM-ddTHH:mm:ss

CallbackToken
CallbackToken string

Token de devolución de llamada

TransactionId
TransactionId string

Identificador de transacción

AccountId
AccountId integer

ID de cuenta

Nombre de cuenta
AccountName string

Nombre de la cuenta a la que está asociada la devolución de llamada.

Id. de estado
StatusId integer

2 = Entregado; 3 = Sin entregar; 7 = Desconocido

Estado
Status string

Código de entrega: correcto para el mensaje entregado o el código de error. Para undelivered: null

ChannelId
ChannelId integer

Identificador de canal

Código de canal
ChannelCode string

Código del canal en el que se ha enviado el mensaje (el número de teléfono real para códigos largos)

MessageId
MessageId string

MessageId

Número de teléfono
PhoneNumber string

Número de teléfono

Identificación de contacto
ContactId integer

ID de contacto

ActionId
ActionId integer

Id. de acción

Message
Message string

Texto real del mensaje

Destinos no válidos

Esta operación desencadena un flujo si los destinos se han filtrado durante el envío de SMS

Parámetros

Nombre Clave Requerido Tipo Description
Identificador de cuenta de la suscripción
accountId True string

Use el identificador de cuenta raíz en la mayoría de los casos para suscribirse a las notificaciones.

Devoluciones

Nombre Ruta de acceso Tipo Description
Marca de tiempo de devolución de llamada
CallbackTimestamp string

Fecha y hora en que se ha enviado la devolución de llamada. Formato: aaaa-MM-ddTHH:mm:ss

CallbackURL
CallbackURL string

Dirección URL de devolución de llamadas

TransactionId
TransactionId string

Identificador de transacción

AccountId
AccountId integer

ID de cuenta

ActionId
ActionId integer

Id. de acción

RunId
RunId integer

Identificador de ejecución

InvalidTargets
InvalidTargets array of object

Destinos no válidos

Objetivo
InvalidTargets.Target string

Destino que se ha filtrado

ReasonId
InvalidTargets.ReasonId integer

Id. del motivo. 0 - No válido, 1 - Opt Out, 2 - Duplicate, 3 - Blocked, 4 - Undeliverable, 5 - Single Use

Motivo
InvalidTargets.Reason string

Descripción breve de una razón

Detener mensaje recibido

Esta operación desencadena un flujo cada vez que el usuario final escribe en STOP o sinónimo

Parámetros

Nombre Clave Requerido Tipo Description
Identificador de cuenta de la suscripción
accountId True string

Use el identificador de cuenta raíz en la mayoría de los casos para suscribirse a las notificaciones.

Devoluciones

Nombre Ruta de acceso Tipo Description
Marca de tiempo de devolución de llamada
CallbackTimestamp string

Fecha y hora en que se ha enviado la devolución de llamada. Formato: aaaa-MM-ddTHH:mm:ss

CallbackToken
CallbackToken string

Token de devolución de llamada

TransactionId
TransactionId string

Identificador de transacción

AccountId
AccountId integer

ID de cuenta

Nombre de cuenta
AccountName string

Nombre de la cuenta a la que está asociada la devolución de llamada.

ChannelId
ChannelId integer

Identificador de canal

Código de canal
ChannelCode string

Código del canal en el que se ha enviado el mensaje (el número de teléfono real para códigos largos)

Identificación de contacto
ContactId integer

ID de contacto

ContactAccountId
ContactAccountId integer

Identificador de la cuenta que posee el registro de contacto

ContactAccountName
ContactAccountName string

Nombre de la cuenta que posee el registro de contacto

Número de teléfono
PhoneNumber string

Número de teléfono del usuario final que se ha rechazado

Mensaje entrante recibido

Esta operación desencadena un flujo cada vez que el usuario final escribe en

Parámetros

Nombre Clave Requerido Tipo Description
Identificador de cuenta de la suscripción
AccountId True string

Use el identificador de cuenta raíz en la mayoría de los casos para suscribirse a las notificaciones.

Devoluciones

Nombre Ruta de acceso Tipo Description
Nombre de cuenta
AccountName string

Nombre de la cuenta a la que está asociada la devolución de llamada.

Código de canal
ChannelCode string

Código del canal en el que se ha enviado el mensaje (el número de teléfono real para códigos largos)

ChannelId
ChannelId integer

Identificador del canal en el que se ha enviado el mensaje

Identificación de contacto
ContactId integer

Identificador de contacto si existe (null para contactos desconocidos)

Message
Message string

Texto real del mensaje

Número de teléfono
PhoneNumber string

Número de teléfono de destino

AccountId
AccountId integer

Identificador de la cuenta a la que está asociada la devolución de llamada.

Marca de tiempo de devolución de llamada
CallbackTimestamp string

Fecha y hora en que se ha enviado la devolución de llamada. Formato: aaaa-MM-ddTHH:mm:ss

CallbackToken
CallbackToken string

Token de devolución de llamada

TransactionId
TransactionId string

Token único

Palabra clave recibida

Esta operación desencadena un flujo cada vez que el usuario final escribe en una palabra clave

Parámetros

Nombre Clave Requerido Tipo Description
Identificador de cuenta de la suscripción
accountId True string

Use el identificador de cuenta raíz en la mayoría de los casos para suscribirse a las notificaciones.

Devoluciones

Nombre Ruta de acceso Tipo Description
Marca de tiempo de devolución de llamada
CallbackTimestamp string

Fecha y hora en que se ha enviado la devolución de llamada formato: aaaa-MM-ddTHH:mm:ss

CallbackToken
CallbackToken string

Token de devolución de llamada

TransactionId
TransactionId string

Identificador de transacción

AccountId
AccountId integer

Identificador de la cuenta a la que está asociada la devolución de llamada.

Nombre de cuenta
AccountName string

Nombre de la cuenta a la que está asociada la devolución de llamada.

CampaignId
CampaignId integer

Id. de campaña

ChannelId
ChannelId integer

Identificador de canal

Código de canal
ChannelCode string

Código del canal en el que se ha enviado el mensaje (el número de teléfono real para códigos largos)

Identificación de contacto
ContactId integer

Identificador del contacto que envió la palabra clave

Keyword
Keyword string

Palabra clave real que se ha enviado

KeywordId
KeywordId integer

Identificador de la palabra clave que se ha enviado

Message
Message string

Texto real del mensaje

Número de teléfono
PhoneNumber string

Número de teléfono del usuario final que envió la palabra clave

Definiciones

AccountResponse

Nombre Ruta de acceso Tipo Description
id
id integer

Identificador de la cuenta.

estado
status integer

Estado actual de la cuenta.

parentId
parentId integer

Identificador de la cuenta que es el elemento primario de esta cuenta.

nombre
name string

El nombre de la cuenta

creado
created string

Cuando se creó la cuenta.

allowCallback
allowCallback boolean

Establezca si esta cuenta puede usar el mecanismo de devolución de llamada.

callbackToken
callbackToken string

Token de devolución de llamada

type
type integer

Tipo de cuenta (maestro o subcuenta)

AccountType
accountType integer

Nombre del tipo de cuenta

isApproved
isApproved boolean

La cuenta está aprobada o no

ContactResponse

Nombre Ruta de acceso Tipo Description
accountId
accountId integer

ID de cuenta

número de teléfono
phoneNumber string

Número de teléfono

Correo electrónico
email string

Correo electrónico

preferredLanguageId
preferredLanguageId string

id. de idioma preferido

preferredLanguage
preferredLanguage string

idioma preferido

assignedId
assignedId string

id. asignado

firstName
firstName string

Nombre

lastName
lastName string

Apellido

phoneStatusId
phoneStatusId integer

id. de estado del teléfono

phoneStatus
phoneStatus integer

estado del teléfono

phoneHardErrorCount
phoneHardErrorCount integer

número de errores duros del teléfono

phoneSoftErrorCount
phoneSoftErrorCount integer

phone Soft Error Count

phoneTotalHardErrorCount
phoneTotalHardErrorCount integer

número total de errores duros del teléfono

phoneTotalSoftErrorCount
phoneTotalSoftErrorCount integer

phone Total Soft Error Count

phoneLastHardError
phoneLastHardError string

phone Last Hard Error

phoneLastSoftError
phoneLastSoftError string

phone Last Soft Error

phoneHardErrorSince
phoneHardErrorSince string

phone Hard Error since

phoneSoftErrorSince
phoneSoftErrorSince string

phone Soft Error since

statusId
statusId integer

id. de estado

creado
created string

creado

modified
modified string

modified

createdBy
createdBy string

creado por

modifiedBy
modifiedBy string

modificado por

id
id integer

id

ContactSearchRequest

Nombre Ruta de acceso Tipo Description
id
id integer

id

accountId
accountId integer

ID de cuenta

statusId
statusId integer

id. de estado

número de teléfono
phoneNumber string

Número de teléfono

Correo electrónico
email string

Correo electrónico

assignedId
assignedId string

id. asignado

firstName
firstName string

Nombre

lastName
lastName string

Apellido

subscriptions
subscriptions array of

subscriptions

attributes
attributes array of

attributes

phoneStatusId
phoneStatusId integer

id. de estado del teléfono

creado
created string

creado

createdBy
createdBy string

creado por

modified
modified string

modified

modifiedBy
modifiedBy string

modificado por

PushCampaignResponse

Nombre Ruta de acceso Tipo Description
canales nueva
channels array of

canales nueva

targets
targets array of string

targets

targetsUrl
targetsUrl string

dirección URL de destinos

targetsColumn
targetsColumn string

columna de destinos

contactListIds
contactListIds array of

contact List Ids

excludeListIds
excludeListIds array of

exclude List Ids

campaignId
campaignId integer

id. de campaña

mediaId
mediaId string

id. multimedia

Mensaje
message string

Mensaje

desde
from string

desde

Asunto
subject string

Asunto

ignoreSingleUse
ignoreSingleUse boolean

omitir uso único

forceOptIn
forceOptIn boolean

forzar Opt-In

statusId
statusId integer

id. de estado

roundRobinById
roundRobinById boolean

round Robin By Id

globalRoundRobin
globalRoundRobin boolean

global Round Robin

estado
status string

estado

id
id integer

id

accountId
accountId integer

ID de cuenta

creado
created string

creado

modified
modified string

modified

createdBy
createdBy string

creado por

modifiedBy
modifiedBy string

modificado por

schedules
schedules array of

schedules

UserResponse

Nombre Ruta de acceso Tipo Description
nombre de usuario
userName string

nombre de usuario

accountId
accountId integer

ID de cuenta

Correo electrónico
email string

Correo electrónico

firstName
firstName string

Nombre

lastName
lastName string

Apellido

número de teléfono
phoneNumber string

Número de teléfono

isAdmin
isAdmin boolean

es Admin

key
apiKey.key string

key

secret
apiKey.secret string

secret

lastActivity
apiKey.lastActivity string

última actividad

typeId
apiKey.typeId integer

identificador de tipo

type
apiKey.type integer

type

label
apiKey.label string

label

nombre de usuario
apiKey.userName string

nombre de usuario

validTo
apiKey.validTo string

válido para

accountId
apiKey.accountId integer

ID de cuenta

id
apiKey.id integer

id

isChatUser
isChatUser boolean

es usuario de chat

reportOnly
reportOnly boolean

Solo informe

requestNumber
requestNumber boolean

número de solicitud

canCreateContact
canCreateContact boolean

puede crear contacto

isAlertAgent
isAlertAgent boolean

es el Agente de alertas

acordado
agreed boolean

acordado

comentario
comment string

comentario

isApproved
isApproved boolean

está aprobado

isLockedOut
isLockedOut boolean

está bloqueado

lastLockoutDate
lastLockoutDate string

última fecha de bloqueo

fechaDeCreación
creationDate string

fecha de creación

lastLoginDate
lastLoginDate string

última fecha de inicio de sesión

lastActivityDate
lastActivityDate string

última fecha de actividad

lastPasswordChangedDate
lastPasswordChangedDate string

última fecha de cambio de contraseña