Compartilhar via

TrueDialog SMS

O conector DE SMS TrueDialog oferece a capacidade de enviar mensagens de texto individuais e de massa por meio de código longo e código curto.

Esse conector está disponível nos seguintes produtos e regiões:

Service Class Regions
Copilot Studio Premium Todas as regiões do Power Automate , exceto as seguintes:
     – Governo dos EUA (GCC)
     – Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Aplicativos Lógicos Standard Todas as regiões dos Aplicativos Lógicos , exceto as seguintes:
     – Regiões do Azure Governamental
     - Regiões do Azure China
     - Departamento de Defesa dos EUA (DoD)
Power Apps Premium Todas as regiões do Power Apps , exceto as seguintes:
     – Governo dos EUA (GCC)
     – Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Power Automate Premium Todas as regiões do Power Automate , exceto as seguintes:
     – Governo dos EUA (GCC)
     – Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Contato
Nome Suporte ao TrueDialog
URL https://www.truedialog.com/help/
Email support@truedialog.com
Metadados do conector
Publicador TrueDialog Dynamics
Site https://www.truedialog.com/
Política de privacidade https://www.truedialog.com/privacy-policy/
Categorias Communication

A API de SMS do TrueDialog é de nível empresarial com mais recursos predefinidos do que qualquer outro software SMS. Criada para desenvolvedores, nossa API de SMS é altamente confiável, segura e inclui um banco de dados ISO 9001 predefinido para proteção extra de aceitação e conformidade. Também disponível por meio do nosso software de texto sms de Enterprise-Grade completo.

Pré-requisitos

Você precisará dessas credenciais para continuar:

  • Um plano do Microsoft Power Apps ou do Power Automate
  • Uma conta e um plano TrueDialog e sua chave de API TrueDialog e código secreto para sua conta. Clique AQUI para se registrar.

Como obter credenciais

Clique AQUI para se registrar. Quando você se registrar no TrueDialog, a chave de API e o Código Secreto estarão em seu email de credenciais. Para obter ajuda para começar, entre em contato com nossa equipe. Nossa equipe de Serviços de Cliente de classe mundial orientará você no registro e escolherá a melhor conta para as necessidades da sua empresa.

ENTRE EM CONTATO CONOSCO:

email support@truedialog.com
Chat ao vivo https://www.truedialog.com/
Telefone 512-501-5940

Introdução ao conector TrueDialog

Depois de ter suas credenciais, você poderá começar a usar o conector.

Ações

Enviar SMS

A ação mais valiosa é "Enviar SMS". Ele permite o envio de SMS para um ou vários destinatários. Esta ação tem vários campos necessários:

  • ID da conta – pode ser usada na resposta Obter Informações do Usuário Atual ou pode ser codificada.
  • Canal – deixe o valor padrão 22 para usar o número de telefone associado padrão.
  • Destinos – número de telefone válido dos EUA sem formatação (por exemplo: +15125453809)
  • Mensagem – a mensagem em si.
  • Execute – deixe o valor padrão True se você não quiser adiar o envio.

Triggers

A lista de retornos de chamada registrados para uma conta pode ser encontrada aqui: https://ui.truedialog.com/Callbacks

Mensagem de entrada recebida

O gatilho mais importante. Essa operação dispara um fluxo sempre que o usuário final enviar textos para o número de telefone associado.

A ID da conta é necessária para registrar o gatilho. Você pode obter uma ID de conta por meio do Portal do TD, ela está localizada ao lado do nome da conta no canto superior direito.

A mensagem de entrada contém texto da mensagem e outros campos necessários.

Parar mensagem recebida

Essa operação dispara um fluxo sempre que o usuário final textos em STOP ou sinônimo. Ele também aceita automaticamente o contato no sistema TrueDialog. Para enviar uma mensagem para o contato opted-out, defina o sinalizador forceOptIn como True ao enviar SMS. Use esse recurso ForceOptIt com cuidado e certifique-se de acompanhar os registros optados.

Forneça aos usuários um processo passo a passo para começar a usar o conector. É aí que você deve realçar casos de uso comuns, como seus gatilhos e ações populares esperados, e como eles podem ajudar em cenários de automação. Inclua imagens sempre que possível.

Aviso de entrega recebido

Essa operação dispara um fluxo para cada confirmação de aviso de entrega. Observe que nem todas as operadoras móveis enviam um recibo de aviso prévio.

Destinos inválidos

Quando um dos telefones de destino é inválido ou está na lista negra, ainda é possível enviar SMS e não receber um erro. Para fazer isso, você deve definir a propriedade "IgnoreInvalidTargets" como true ao enviar uma mensagem. Se números de telefone inválidos forem apresentados na lista de destinatários de SMS enviados, essa operação disparará um Flows.

Problemas e limitações conhecidos

A API TrueDialog tem mais recursos em comparação com o conector personalizado

perguntas frequentes

Para obter a descrição mais recente da API sem correção, visite AQUI

Forneça um detalhamento das perguntas frequentes e suas respectivas respostas aqui. Isso pode abranger perguntas frequentes sobre como interagir com o serviço subjacente ou sobre o próprio conector.

Criando uma conexão

O conector dá suporte aos seguintes tipos de autenticação:
Default Parâmetros para criar conexão. Todas as regiões Não compartilhável

Padrão

Aplicável: todas as regiões

Parâmetros para criar conexão.

Essa não é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.

Nome Tipo Description Obrigatório
nome de usuário secureString O nome de usuário para esta api Verdade
senha secureString A senha dessa api Verdade

Limitações

Nome Chamadas Período de renovação
Chamadas à API por conexão 100 60 segundos

Ações

Atualização de Contato

Atualizar contato
Criar contato

Criar um registro de contato no TrueDialog
Enviar SMS

Enviar SMS para um único ou vários destinatários
Obter informações da conta

Obter informações sobre a conta
Obter informações do usuário atual

Obter informações sobre o Usuário, cujas credenciais foram usadas na Conexão
Pesquisa de Contatos

Procura um contato por meio de um número de telefone ou endereço de email.

Atualização de Contato

ID da operação:
Contact_Update

Atualizar contato

Parâmetros

Nome Chave Obrigatório Tipo Description
AccountID
 accountId True string

ID da conta que seria usada como conta pai para o contato atualizado
ID de contato
 contactid True string

ID do Contato que seria atualizado
Número de telefone
 PhoneNumber string

Número do celular, se disponível. Este ou o campo Email são OBRIGATÓRIOs
Email
 Email string

Endereço de email do contato. Este ou o campo PhoneNumber são OBRIGATÓRIOs.
Primeiro Nome
 FirstName string

Nome do contato.
LastName
 LastName string

Sobrenome do contato.

Retornos

Corpo
ContactResponse

Criar contato

ID da operação:
Contact_Create

Criar um registro de contato no TrueDialog

Parâmetros

Nome Chave Obrigatório Tipo Description
AccountID
 accountId True string

ID da conta que seria usada como conta pai para o contato criado
Número de telefone
 PhoneNumber string

Número do celular, se disponível. Este ou o campo Email são OBRIGATÓRIOs
Email
 Email string

Endereço de email do contato. Este ou o campo PhoneNumber são OBRIGATÓRIOs.
Primeiro Nome
 FirstName string

Nome do contato.
LastName
 LastName string

Sobrenome do contato.

Retornos

Corpo
ContactResponse

Enviar SMS

ID da operação:
Campaign_Push

Enviar SMS para um único ou vários destinatários

Parâmetros

Nome Chave Obrigatório Tipo Description
AccountID
 accountId True string

ID da conta que seria usada para enviar SMS
Canais
 Channels True array of string

Canais
Metas
 Targets True array of string

Metas
ContactListIds
 ContactListIds array of string

IDs da Lista de Contatos
ExcludeListIds
 ExcludeListIds array of string

Excluir IDs de Lista
ID de mídia
 MediaId integer

ID de mídia
Message
 Message True string

Message
Ignorar uso único
 IgnoreSingleUse boolean

Ignorar uso único
ForceOptIn
 ForceOptIn boolean

Forçar Opt-In
Schedules
 Schedules array of string

A lista de agendas associadas à ação
Execute
 Execute True boolean

Definir true se a ação deve ser executada na criação
IgnoreInvalidTargets
 IgnoreInvalidTargets boolean

Indica se números inválidos devem ser ignorados

Retornos

Corpo
PushCampaignResponse

Obter informações da conta

ID da operação:
Account_Get_Info

Obter informações sobre a conta

Parâmetros

Nome Chave Obrigatório Tipo Description
ID da conta, que deve ser recuperada
 accountId True string

ID da conta

Retornos

Corpo
AccountResponse

Obter informações do usuário atual

ID da operação:
User_Get_Self_Info

Obter informações sobre o Usuário, cujas credenciais foram usadas na Conexão

Retornos

Corpo
UserResponse

Pesquisa de Contatos

ID da operação:
Contact_Search

Procura um contato por meio de um número de telefone ou endereço de email.

Parâmetros

Nome Chave Obrigatório Tipo Description
ID da conta para assinatura
 accountId True string

A conta à qual o contato está visível.
Número de telefone a ser pesquisado
 phone True string

Encontre contatos existentes com o número de telefone ou email passado.

Retornos

Itens
ContactSearchRequest

Gatilhos

Aviso de entrega recebido

Esta operação dispara um fluxo para cada confirmação de aviso de entrega
Destinos inválidos

Essa operação dispara um fluxo se os destinos tiverem sido filtrados durante o envio de SMS
Mensagem de entrada recebida

Essa operação dispara um fluxo sempre que o usuário final recebe textos em
Palavra-chave Recebida

Esta operação dispara um fluxo sempre que o usuário final textos em uma palavra-chave
Parar mensagem recebida

Esta operação dispara um fluxo sempre que o usuário final textos em STOP ou sinônimo

Aviso de entrega recebido

ID da operação:
Delivery_Notice_received

Esta operação dispara um fluxo para cada confirmação de aviso de entrega

Parâmetros

Nome Chave Obrigatório Tipo Description
ID da conta para assinatura
 accountId True string

Use a ID da Conta Raiz na maioria dos casos para assinar notificações.

Retornos

Nome Caminho Tipo Description
Carimbo de data/hora de retorno de chamada
 CallbackTimestamp string

Data e hora em que o retorno de chamada foi enviado. Formato: yyyyy-MM-ddTHH:mm:ss
CallbackToken
 CallbackToken string

Token de retorno de chamada
TransactionId
 TransactionId string

ID da transação
ID da conta
 AccountId integer

ID da conta
Nome da Conta
 AccountName string

O nome da conta à qual o retorno de chamada está associado
Status Id
 StatusId integer

2 = Entregue; 3 = Não entregue; 7 = Desconhecido
Situação
 Status string

Código de entrega – OK para mensagem entregue ou código de erro. Para não entregue – nulo
ChannelId
 ChannelId integer

ID do Canal
Código do canal
 ChannelCode string

Código do canal pelo qual a mensagem foi enviada (o número de telefone real para códigos longos)
MessageId
 MessageId string

MessageId
Número de telefone
 PhoneNumber string

Número de Telefone
Identificação do contato
 ContactId integer

ID de contato
ActionId
 ActionId integer

ID da ação
Message
 Message string

O texto da mensagem real

Destinos inválidos

ID da operação:
Invalid_Targets

Essa operação dispara um fluxo se os destinos tiverem sido filtrados durante o envio de SMS

Parâmetros

Nome Chave Obrigatório Tipo Description
ID da conta para assinatura
 accountId True string

Use a ID da Conta Raiz na maioria dos casos para assinar notificações.

Retornos

Nome Caminho Tipo Description
Carimbo de data/hora de retorno de chamada
 CallbackTimestamp string

Data e hora em que o retorno de chamada foi enviado. Formato: yyyyy-MM-ddTHH:mm:ss
Retorno de chamadaURL
 CallbackURL string

URL de retorno de chamada
TransactionId
 TransactionId string

ID da transação
ID da conta
 AccountId integer

ID da conta
ActionId
 ActionId integer

ID da ação
RunId
 RunId integer

Executar ID
InvalidTargets
 InvalidTargets array of object

Destinos inválidos
Meta
 InvalidTargets.Target string

O destino que foi filtrado
ReasonId
 InvalidTargets.ReasonId integer

ID do motivo. 0 - Inválido, 1 - Opted Out, 2 - Duplicate, 3 - Bloqueado, 4 - Não Entregue, 5 - Uso Único
Reason
 InvalidTargets.Reason string

Breve descrição de um motivo

Mensagem de entrada recebida

ID da operação:
Incoming_SMS_Received

Essa operação dispara um fluxo sempre que o usuário final recebe textos em

Parâmetros

Nome Chave Obrigatório Tipo Description
ID da conta para assinatura
 AccountId True string

Use a ID da Conta Raiz na maioria dos casos para assinar notificações.

Retornos

Nome Caminho Tipo Description
Nome da Conta
 AccountName string

O nome da conta à qual o retorno de chamada está associado
Código do canal
 ChannelCode string

Código do canal pelo qual a mensagem foi enviada (o número de telefone real para códigos longos)
ChannelId
 ChannelId integer

ID do canal em que a mensagem foi enviada
Identificação do contato
 ContactId integer

ID de contato se houver (nulo para contatos desconhecidos)
Message
 Message string

O texto da mensagem real
Número de telefone
 PhoneNumber string

Número de telefone de destino
ID da conta
 AccountId integer

A ID da conta à qual o retorno de chamada está associado
Carimbo de data/hora de retorno de chamada
 CallbackTimestamp string

Data e hora em que o retorno de chamada foi enviado. Formato: yyyyy-MM-ddTHH:mm:ss
CallbackToken
 CallbackToken string

Token de retorno de chamada
TransactionId
 TransactionId string

Token exclusivo

Palavra-chave Recebida

ID da operação:
Keyword_received

Esta operação dispara um fluxo sempre que o usuário final textos em uma palavra-chave

Parâmetros

Nome Chave Obrigatório Tipo Description
ID da conta para assinatura
 accountId True string

Use a ID da Conta Raiz na maioria dos casos para assinar notificações.

Retornos

Nome Caminho Tipo Description
Carimbo de data/hora de retorno de chamada
 CallbackTimestamp string

Data e hora em que o retorno de chamada foi enviado Formato: yyyy-MM-ddTHH:mm:ss
CallbackToken
 CallbackToken string

Token de retorno de chamada
TransactionId
 TransactionId string

ID da transação
ID da conta
 AccountId integer

A ID da conta à qual o retorno de chamada está associado
Nome da Conta
 AccountName string

O nome da conta à qual o retorno de chamada está associado
ID da campanha
 CampaignId integer

ID da campanha
ChannelId
 ChannelId integer

ID do Canal
Código do canal
 ChannelCode string

Código do canal pelo qual a mensagem foi enviada (o número de telefone real para códigos longos)
Identificação do contato
 ContactId integer

ID do contato que enviou a palavra-chave
Keyword
 Keyword string

A palavra-chave real que foi enviada
KeywordId
 KeywordId integer

ID da palavra-chave que foi enviada
Message
 Message string

O texto da mensagem real
Número de telefone
 PhoneNumber string

O número de telefone do usuário final que enviou a palavra-chave

Parar mensagem recebida

ID da operação:
Stop_received

Esta operação dispara um fluxo sempre que o usuário final textos em STOP ou sinônimo

Parâmetros

Nome Chave Obrigatório Tipo Description
ID da conta para assinatura
 accountId True string

Use a ID da Conta Raiz na maioria dos casos para assinar notificações.

Retornos

Nome Caminho Tipo Description
Carimbo de data/hora de retorno de chamada
 CallbackTimestamp string

Data e hora em que o retorno de chamada foi enviado. Formato: yyyyy-MM-ddTHH:mm:ss
CallbackToken
 CallbackToken string

Token de retorno de chamada
TransactionId
 TransactionId string

ID da transação
ID da conta
 AccountId integer

ID da conta
Nome da Conta
 AccountName string

O nome da conta à qual o retorno de chamada está associado
ChannelId
 ChannelId integer

ID do Canal
Código do canal
 ChannelCode string

Código do canal pelo qual a mensagem foi enviada (o número de telefone real para códigos longos)
Identificação do contato
 ContactId integer

ID de contato
ContactAccountId
 ContactAccountId integer

A ID da conta que possui o registro de contato
ContactAccountName
 ContactAccountName string

O nome da conta que possui o registro de contato
Número de telefone
 PhoneNumber string

O número de telefone do usuário final que foi desativado

Definições

AccountResponse

Nome Caminho Tipo Description
id
 id integer

A ID da conta.
status
 status integer

O status atual da conta.
ID do pai
 parentId integer

O identificador da conta que é o pai dessa conta.
nome
 name string

O nome da conta
criadas
 created string

Quando a conta foi criada.
allowCallback
 allowCallback boolean

Defina se essa conta tiver permissão para usar o mecanismo de retorno de chamada.
callbackToken
 callbackToken string

Token de retorno de chamada
tipo
 type integer

Tipo de conta (mestre ou subcontagem)
tipo de conta
 accountType integer

Nome do tipo de conta
isApproved
 isApproved boolean

A conta é aprovada ou não

ContactResponse

Nome Caminho Tipo Description
ID da conta
 accountId integer

ID da conta
número de telefone
 phoneNumber string

Número de Telefone
email
 email string

email
preferredLanguageId
 preferredLanguageId string

ID de idioma preferencial
preferredLanguage
 preferredLanguage string

Idioma preferencial
assignedId
 assignedId string

ID atribuída
primeiro nome
 firstName string

Primeiro Nome
sobrenome
 lastName string

Apelido
phoneStatusId
 phoneStatusId integer

ID de status do telefone
phoneStatus
 phoneStatus integer

Status do telefone
phoneHardErrorCount
 phoneHardErrorCount integer

Contagem de erros rígidos do telefone
phoneSoftErrorCount
 phoneSoftErrorCount integer

Contagem de erros suaves do telefone
phoneTotalHardErrorCount
 phoneTotalHardErrorCount integer

Contagem total de erros rígidos do telefone
phoneTotalSoftErrorCount
 phoneTotalSoftErrorCount integer

Contagem total de erros suaves do telefone
phoneLastHardError
 phoneLastHardError string

Erro de Última Dificuldade do Telefone
phoneLastSoftError
 phoneLastSoftError string

Erro de último soft do telefone
phoneHardErrorSince
 phoneHardErrorSince string

Erro de telefone rígido desde
phoneSoftErrorSince
 phoneSoftErrorSince string

Erro suave do telefone desde
statusId
 statusId integer

ID de status
criadas
 created string

criadas
modified
 modified string

modified
createdBy
 createdBy string

criado por
modifiedBy
 modifiedBy string

modificado por
id
 id integer

id

ContactSearchRequest

Nome Caminho Tipo Description
id
 id integer

id
ID da conta
 accountId integer

ID da conta
statusId
 statusId integer

ID de status
número de telefone
 phoneNumber string

Número de Telefone
email
 email string

email
assignedId
 assignedId string

ID atribuída
primeiro nome
 firstName string

Primeiro Nome
sobrenome
 lastName string

Apelido
subscriptions
 subscriptions array of

subscriptions
attributes
 attributes array of

attributes
phoneStatusId
 phoneStatusId integer

ID de status do telefone
criadas
 created string

criadas
createdBy
 createdBy string

criado por
modified
 modified string

modified
modifiedBy
 modifiedBy string

modificado por

PushCampaignResponse

Nome Caminho Tipo Description
canais
 channels array of

canais
targets
 targets array of string

targets
targetsUrl
 targetsUrl string

URL de destinos
targetsColumn
 targetsColumn string

Coluna de destinos
contactListIds
 contactListIds array of

IDs de lista de contatos
excludeListIds
 excludeListIds array of

excluir IDs de lista
campaignId
 campaignId integer

ID da campanha
mediaId
 mediaId string

ID de mídia
mensagem
 message string

mensagem
from
 from string

from
assunto
 subject string

assunto
ignoreSingleUse
 ignoreSingleUse boolean

ignorar uso único
forceOptIn
 forceOptIn boolean

forçar Opt-In
statusId
 statusId integer

ID de status
roundRobinById
 roundRobinById boolean

round Robin By Id
globalRoundRobin
 globalRoundRobin boolean

round robin global
status
 status string

status
id
 id integer

id
ID da conta
 accountId integer

ID da conta
criadas
 created string

criadas
modified
 modified string

modified
createdBy
 createdBy string

criado por
modifiedBy
 modifiedBy string

modificado por
schedules
 schedules array of

schedules

UserResponse

Nome Caminho Tipo Description
userName
 userName string

userName
ID da conta
 accountId integer

ID da conta
email
 email string

email
primeiro nome
 firstName string

Primeiro Nome
sobrenome
 lastName string

Apelido
número de telefone
 phoneNumber string

Número de Telefone
isAdmin
 isAdmin boolean

é Administrador
chave
 apiKey.key string

chave
segredo
 apiKey.secret string

segredo
lastActivity
 apiKey.lastActivity string

última atividade
ID do tipo
 apiKey.typeId integer

ID do tipo
tipo
 apiKey.type integer

tipo
etiqueta
 apiKey.label string

etiqueta
userName
 apiKey.userName string

userName
validTo
 apiKey.validTo string

valid To
ID da conta
 apiKey.accountId integer

ID da conta
id
 apiKey.id integer

id
isChatUser
 isChatUser boolean

é Usuário de Chat
reportOnly
 reportOnly boolean

Somente relatório
requestNumber
 requestNumber boolean

Número da solicitação
canCreateContact
 canCreateContact boolean

pode criar contato
isAlertAgent
 isAlertAgent boolean

é o Agente de Alerta
combinado
 agreed boolean

combinado
comentário
 comment string

comentário
isApproved
 isApproved boolean

é Aprovado
isLockedOut
 isLockedOut boolean

está bloqueado
lastLockoutDate
 lastLockoutDate string

Data do último bloqueio
data de criação
 creationDate string

Data de criação
lastLoginDate
 lastLoginDate string

última Data de Logon
lastActivityDate
 lastActivityDate string

Data da última atividade
lastPasswordChangedDate
 lastPasswordChangedDate string

Data da última alteração da senha