Partilhar via

TrueDialog SMS

TrueDialog conector SMS dá uma capacidade de enviar em massa e mensagens de texto individuais através de código longo e código curto.

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

Serviço Class Regiões
Estúdio Copiloto Premium Todas as regiões do Power Automatic , exceto as seguintes:
     - Governo dos EUA (CCG)
     - Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Aplicações Lógicas Standard Todas as regiões do Logic Apps , exceto as seguintes:
     - Regiões do Azure Government
     - Regiões do Azure China
     - Departamento de Defesa dos EUA (DoD)
Aplicações Power Premium Todas as regiões do Power Apps , exceto as seguintes:
     - Governo dos EUA (CCG)
     - Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Automatize o poder Premium Todas as regiões do Power Automatic , exceto as seguintes:
     - Governo dos EUA (CCG)
     - Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Contato
Nome Suporte a TrueDialog
URL https://www.truedialog.com/help/
Email support@truedialog.com
Metadados do conector
Editora Dinâmica TrueDialog
Sítio Web https://www.truedialog.com/
Política de privacidade https://www.truedialog.com/privacy-policy/
Categorias Communication

A API SMS do TrueDialog, com mais recursos pré-construídos do que qualquer outro software SMS. Criada para desenvolvedores, nossa API SMS é altamente confiável, segura e inclui um banco de dados ISO 9001 pré-construído para proteção extra de exclusão e conformidade. Também disponível através do nosso software completo de Enterprise-Grade SMS Texting.

Pré-requisitos

Você precisará destas credenciais para prosseguir:

  • Um plano Microsoft Power Apps ou 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 inscrever.

Como obter credenciais

Clique AQUI para se inscrever. Quando você se registra no TrueDialog, a chave da API e o código secreto estarão em seu e-mail de credenciais. Para obter ajuda para começar, entre em contato com nossa equipe. A nossa equipa de Serviços ao Cliente de classe mundial irá orientá-lo através do registo e da escolha da melhor conta para as necessidades da sua empresa.

CONTACTE-NOS:

e-mail support@truedialog.com
Bate-papo ao vivo https://www.truedialog.com/
Telemóvel 512-501-5940

Introdução ao conector TrueDialog

Depois de ter suas credenciais, você pode 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 obrigatórios:

  • ID da conta – pode ser usado a partir da resposta Obter informações atuais do usuário ou pode ser codificado.
  • Canal – deixe o valor padrão 22 para usar o número de telefone associado padrão.
  • Alvos – número de telefone válido dos EUA sem formatação (ex.: +15125453809)
  • Mensagem – a própria mensagem.
  • Executar – deixe o valor padrão True se não quiser adiar o envio.

Acionadores

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

Mensagem recebida recebida

O gatilho mais importante. Esta operação desencadeia um fluxo sempre que o utilizador final envia mensagens de texto para o número de telefone associado.

O ID da conta é necessário para registrar o gatilho. Você pode obter um ID de conta através do TD Portal, ele está localizado ao lado do nome da conta no canto superior direito.

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

Parar mensagem recebida

Esta operação aciona um fluxo sempre que o usuário final escreve em STOP ou sinônimo. Ele também desativa automaticamente o contato no sistema TrueDialog. Para enviar uma mensagem para o contato excluído, defina o sinalizador forceOptIn como True ao enviar SMS. Por favor, use este recurso ForceOptIt com cuidado e certifique-se de manter o controle dos registros excluídos.

Forneça aos usuários um processo passo a passo para começar a usar seu conector. É aqui que você deve destacar 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

Esta operação desencadeia um fluxo para cada recibo de aviso de entrega. Tenha em atenção que nem todas as operadoras móveis enviam um recibo de aviso.

Destinos inválidos

Quando um dos telefones alvo é 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 foram apresentados na lista de destinatários SMS enviados, essa operação aciona um Flows.

Problemas conhecidos e limitações

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

FAQ

Para obter a descrição mais recente da API undrlying visite AQUI

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

A criar uma ligação

O conector suporta os seguintes tipos de autenticação:
Predefinição 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.

Esta conexão não é compartilhável. Se o aplicativo avançado 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 utilizador securestring O nome de usuário para esta api Verdade
palavra-passe securestring A senha para esta api Verdade

Limites de Limitação

Name Chamadas Período de Renovação
Chamadas de API por conexão 100 60 segundos

Ações

Atualização de contato

Atualizar contato
Contato Criar

Criar um registro de contato em TrueDialog
Enviar SMS

Enviar SMS para um ou vários destinatários
Obter informações atuais do usuário

Obter informações sobre o Usuário, cujas credenciais foram usadas no Connection
Obter informações da conta

Obter informações sobre a conta
Pesquisa de Contactos

Procura um contacto através de um número de telefone ou endereço de e-mail.

Atualização de contato

ID da Operação:
Contact_Update

Atualizar contato

Parâmetros

Name Chave Necessário Tipo Description
ID da conta
 accountId True string

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

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

Número de telemóvel, se disponível. Este ou o campo E-mail são OBRIGATÓRIOS
Email
 Email string

Endereço de e-mail do contato. Este ou o campo Número de Telefone são OBRIGATÓRIOS.
Primeiro Nome
 FirstName string

Nome próprio do contacto.
Apelido
 LastName string

Apelido do contacto.

Devoluções

Body
ContactResponse

Contato Criar

ID da Operação:
Contact_Create

Criar um registro de contato em TrueDialog

Parâmetros

Name Chave Necessário Tipo Description
ID da conta
 accountId True string

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

Número de telemóvel, se disponível. Este ou o campo E-mail são OBRIGATÓRIOS
Email
 Email string

Endereço de e-mail do contato. Este ou o campo Número de Telefone são OBRIGATÓRIOS.
Primeiro Nome
 FirstName string

Nome próprio do contacto.
Apelido
 LastName string

Apelido do contacto.

Devoluções

Body
ContactResponse

Enviar SMS

ID da Operação:
Campaign_Push

Enviar SMS para um ou vários destinatários

Parâmetros

Name Chave Necessário Tipo Description
ID da conta
 accountId True string

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

Channels
Targets
 Targets True array of string

Targets
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ça Opt-In
Horários
 Schedules array of string

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

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

Indica se números inválidos devem ser ignorados

Devoluções

Body
PushCampaignResponse

Obter informações atuais do usuário

ID da Operação:
User_Get_Self_Info

Obter informações sobre o Usuário, cujas credenciais foram usadas no Connection

Devoluções

Body
UserResponse

Obter informações da conta

ID da Operação:
Account_Get_Info

Obter informações sobre a conta

Parâmetros

Name Chave Necessário Tipo Description
ID da conta, que deve ser recuperada
 accountId True string

ID da conta

Devoluções

Body
AccountResponse

Pesquisa de Contactos

ID da Operação:
Contact_Search

Procura um contacto através de um número de telefone ou endereço de e-mail.

Parâmetros

Name Chave Necessário Tipo Description
ID da conta para subscrição
 accountId True string

A conta para a qual o contato é visível.
Número de telefone para pesquisar
 phone True string

Encontre contatos existentes com o número de telefone ou e-mail passado.

Devoluções

Itens
ContactSearchRequest

Acionadores

Aviso de Entrega Recebido

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

Esta operação dispara um fluxo se os alvos tiverem sido filtrados durante o envio de SMS
Mensagem recebida recebida

Esta operação dispara um fluxo sempre que o usuário final envia textos em
Palavra-chave recebida

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

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

Aviso de Entrega Recebido

ID da Operação:
Delivery_Notice_received

Esta operação desencadeia um fluxo para cada recibo de aviso de entrega

Parâmetros

Name Chave Necessário Tipo Description
ID da conta para subscrição
 accountId True string

Use o ID da Conta Root na maioria dos casos para se inscrever para receber notificações.

Devoluções

Name 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: aaaa-MM-ddTHH:mm:ss
CallbackToken
 CallbackToken string

Token de retorno de chamada
TransactionId
 TransactionId string

ID da Transação
AccountId
 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 - null
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
ContactId
 ContactId integer

ID de contato
ActionId
 ActionId integer

Id da ação
Message
 Message string

O texto real da mensagem

Destinos inválidos

ID da Operação:
Invalid_Targets

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

Parâmetros

Name Chave Necessário Tipo Description
ID da conta para subscrição
 accountId True string

Use o ID da Conta Root na maioria dos casos para se inscrever para receber notificações.

Devoluções

Name 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: aaaa-MM-ddTHH:mm:ss
URL de retorno de chamada
 CallbackURL string

URL de retorno de chamada
TransactionId
 TransactionId string

ID da Transação
AccountId
 AccountId integer

ID da conta
ActionId
 ActionId integer

Id da ação
RunId
 RunId integer

Id de execução
InvalidTargets
 InvalidTargets array of object

Destinos inválidos
Target
 InvalidTargets.Target string

O destino que foi filtrado
RazãoId
 InvalidTargets.ReasonId integer

ID do motivo. 0 - Inválido, 1 - Excluído, 2 - Duplicado, 3 - Bloqueado, 4 - Não entregue, 5 - Uso único
Reason
 InvalidTargets.Reason string

Breve descrição de um motivo

Mensagem recebida recebida

ID da Operação:
Incoming_SMS_Received

Esta operação dispara um fluxo sempre que o usuário final envia textos em

Parâmetros

Name Chave Necessário Tipo Description
ID da conta para subscrição
 AccountId True string

Use o ID da Conta Root na maioria dos casos para se inscrever para receber notificações.

Devoluções

Name 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 pelo qual a mensagem foi enviada
ContactId
 ContactId integer

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

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

Número de telefone de destino
AccountId
 AccountId integer

O 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: aaaa-MM-ddTHH:mm:ss
CallbackToken
 CallbackToken string

Token de retorno de chamada
TransactionId
 TransactionId string

Token único

Palavra-chave recebida

ID da Operação:
Keyword_received

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

Parâmetros

Name Chave Necessário Tipo Description
ID da conta para subscrição
 accountId True string

Use o ID da Conta Root na maioria dos casos para se inscrever para receber notificações.

Devoluções

Name 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: aaaa-MM-ddTHH:mm:ss
CallbackToken
 CallbackToken string

Token de retorno de chamada
TransactionId
 TransactionId string

ID da Transação
AccountId
 AccountId integer

O 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
CampaignId
 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)
ContactId
 ContactId integer

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

A palavra-chave real que foi enviada
Palavra-chaveId
 KeywordId integer

ID da palavra-chave que foi enviada
Message
 Message string

O texto real da mensagem
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 escreve em STOP ou sinônimo

Parâmetros

Name Chave Necessário Tipo Description
ID da conta para subscrição
 accountId True string

Use o ID da Conta Root na maioria dos casos para se inscrever para receber notificações.

Devoluções

Name 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: aaaa-MM-ddTHH:mm:ss
CallbackToken
 CallbackToken string

Token de retorno de chamada
TransactionId
 TransactionId string

ID da Transação
AccountId
 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)
ContactId
 ContactId integer

ID de contato
ContactAccountId
 ContactAccountId integer

A ID da conta proprietária do registro de contato
ContactAccountName
 ContactAccountName string

O nome da conta proprietária do registro de contato
Número de telefone
 PhoneNumber string

O número de telefone do utilizador final que foi excluído

Definições

AccountResponse

Name Caminho Tipo Description
id
 id integer

O ID da conta.
estado
 status integer

O status atual da conta.
parentId
 parentId integer

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

O nome da conta
criado
 created string

Quando a conta foi criada.
allowCallback
 allowCallback boolean

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

Token de retorno de chamada
tipo
 type integer

Tipo de conta (principal ou subconta)
Tipo de conta
 accountType integer

Nome do tipo de conta
isAprovado
 isApproved boolean

A conta foi aprovada ou não

ContactResponse

Name Caminho Tipo Description
accountId
 accountId integer

ID da conta
Número de telefone
 phoneNumber string

Número de Telefone
e-mail
 email string

e-mail
preferredLanguageId
 preferredLanguageId string

ID do idioma preferido
linguagemPreferida
 preferredLanguage string

língua preferida
assignedId
 assignedId string

ID atribuído
primeiroNome
 firstName string

Nome Próprio
sobrenome
 lastName string

Apelido
phoneStatusId
 phoneStatusId integer

ID de status do telefone
phoneStatus
 phoneStatus integer

Estado 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

telefone último erro rígido
telefoneLastSoftError
 phoneLastSoftError string

telefone último erro suave
phoneHardErrorDesde
 phoneHardErrorSince string

telefone Hard Error Desde
phoneSoftErrorSince
 phoneSoftErrorSince string

telefone Erro suave desde
statusId
 statusId integer

status Id
criado
 created string

criado
modified
 modified string

modified
criado por
 createdBy string

criado por
modificadoPor
 modifiedBy string

modificado por
id
 id integer

id

ContactSearchRequest

Name Caminho Tipo Description
id
 id integer

id
accountId
 accountId integer

ID da conta
statusId
 statusId integer

status Id
Número de telefone
 phoneNumber string

Número de Telefone
e-mail
 email string

e-mail
assignedId
 assignedId string

ID atribuído
primeiroNome
 firstName string

Nome Próprio
sobrenome
 lastName string

Apelido
subscriptions
 subscriptions array of

subscriptions
attributes
 attributes array of

attributes
phoneStatusId
 phoneStatusId integer

ID de status do telefone
criado
 created string

criado
criado por
 createdBy string

criado por
modified
 modified string

modified
modificadoPor
 modifiedBy string

modificado por

PushCampaignResponse

Name Caminho Tipo Description
channels
 channels array of

channels
targets
 targets array of string

targets
targetsUrl
 targetsUrl string

Url de alvos
targetsColumn
 targetsColumn string

Coluna de destinos
contatoListIds
 contactListIds array of

Ids da 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
de
 from string

de
Assunto
 subject string

Assunto
ignorarSingleUse
 ignoreSingleUse boolean

ignorar Utilização Única
forceOptIn
 forceOptIn boolean

força Opt-In
statusId
 statusId integer

status Id
rodadaRobinById
 roundRobinById boolean

rodada Robin Por Id
globalRoundRobin
 globalRoundRobin boolean

Round Robin global
estado
 status string

estado
id
 id integer

id
accountId
 accountId integer

ID da conta
criado
 created string

criado
modified
 modified string

modified
criado por
 createdBy string

criado por
modificadoPor
 modifiedBy string

modificado por
schedules
 schedules array of

schedules

Resposta do usuário

Name Caminho Tipo Description
nome de utilizador
 userName string

nome de utilizador
accountId
 accountId integer

ID da conta
e-mail
 email string

e-mail
primeiroNome
 firstName string

Nome Próprio
sobrenome
 lastName string

Apelido
Número de telefone
 phoneNumber string

Número de Telefone
isAdmin
 isAdmin boolean

é Admin
chave
 apiKey.key string

chave
segredo
 apiKey.secret string

segredo
lastAtividade
 apiKey.lastActivity string

última atividade
typeId
 apiKey.typeId integer

digite Id
tipo
 apiKey.type integer

tipo
etiqueta
 apiKey.label string

etiqueta
nome de utilizador
 apiKey.userName string

nome de utilizador
validTo
 apiKey.validTo string

válido Para
accountId
 apiKey.accountId integer

ID da conta
id
 apiKey.id integer

id
isChatUser
 isChatUser boolean

é usuário de bate-papo
reportOnly
 reportOnly boolean

Apenas relatório
requestNumber
 requestNumber boolean

número do pedido
canCreateContact
 canCreateContact boolean

pode criar contato
isAlertAgent
 isAlertAgent boolean

é o Agente de Alerta
concordou
 agreed boolean

concordou
comentário
 comment string

comentário
isAprovado
 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

Data do último login
lastActivityDate
 lastActivityDate string

Data da última atividade
lastPasswordChangedDate
 lastPasswordChangedDate string

Data da última alteração da palavra-passe