Partilhar via


Diálogo inteligente

SmartDialog é uma plataforma usada para enviar e receber mensagens SMS e WhatsApp. Oferece uma grande variedade de serviços de mensagens inteligentes.

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 interativo Arena
URL https://www.arenainteractive.fi/contact
Email support@arenainteractive.fi
Metadados do conector
Editora Arena Interactive Oy
Sítio Web https://www.arenainteractive.fi
Política de privacidade https://www.arenainteractive.fi/privacypolicy
Categorias Comunicação; Colaboração

Conector SmartDialog

Este conector pode ser usado para enviar e receber mensagens SMS usando a plataforma SmartDialog.

Pré-requisitos

  1. Uma assinatura e uma conta SmartDialog. Por favor, entre em contato com sales@arenainteractive.fi
  2. O OAuth precisa ser habilitado para sua conta e um segredo do cliente precisa ser solicitado. Isto pode ser feito enviando-nos um e-mail para support@arenainteractive.fi.

Configuração

  1. Siga as instruções em Criar um conector personalizado a partir de uma definição OpenAPI.
  2. Crie um Flow ou PowerApp e adicione uma ação SmartDialog na seção personalizada. Inicie sessão com a sua conta SmartDialog.

Ações Suportadas

  • Nova mensagem (gatilho para receber mensagens)
  • Enviar Mensagem
  • Enviar mensagem do WhatsApp
  • Enviar mensagem de resposta à discussão
  • Enviar mensagem de resposta
  • WhatsApp Opt In
  • Desativação do WhatsApp
  • Criar modelo do WhatsApp
  • Obter contato do grupo
  • Criar Contacto de Grupo
  • Atualizar contato do grupo
  • Excluir contato do grupo
  • Excluir todos os contatos do grupo

Limites de Limitação

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

Ações

Atualizar contato do grupo

Atualizar contato do grupo

Criar contacto de grupo

Criar contacto de grupo

Criar modelo do WhatsApp

Crie um novo modelo do WhatsApp.

Enviar Mensagem

Envie uma mensagem aos destinatários.

Enviar mensagem de resposta

Envie uma mensagem de resposta aos destinatários.

Enviar mensagem de resposta à discussão

Enviar uma mensagem de resposta de discussão aos destinatários.

Enviar mensagem do WhatsApp

Envie uma mensagem modelo do WhatsApp.

Excluir contato do grupo

Exclua o contato do grupo usando o número de telefone.

Excluir todos os contatos do grupo

Excluir todos os contatos do grupo

Obter contato do grupo

Obter contato do grupo

WhatsApp Opt In (preterido) [PRETERIDO]

WhatsApp Opt In para remetente e destinatário. (preterido)

WhatsApp Opt out (preterido) [PRETERIDO]

WhatsApp Opt out para remetente e destinatário. (preterido)

Atualizar contato do grupo

Atualizar contato do grupo

Parâmetros

Name Chave Necessário Tipo Description
Cliente
Customer True string

O Cliente para buscar Serviços de Grupo para.

Serviço de Grupo
Group Service True string

O Serviço de Grupo a ser usado.

Telemóvel
Phone True string

O número de telefone do contato a ser atualizado.

Active
active boolean

Sinalizador que indica se o Contato está Ativo.

Email
email string

Endereço de e-mail do Contacto.

Nome próprio
firstName string

Nome próprio do contacto.

Apelido
lastName string

Apelido do Contacto.

Sexo
gender string

Sexo do Contacto.

Ano de nascimento
birthYear integer

Ano de nascimento do contato.

Endereço
streetAddress string

Endereço do contato.

Código Postal
zipCode string

CEP do contato.

City
city string

Cidade do Contato.

Código do país
countryCode string

Código do país do contacto com 3 letras.

Nome
name string

Nome da propriedade de contato personalizado.

Valor
value string

Valor da propriedade de contato personalizada.

Regiões de número de telefone
phoneNumberRegions array of string

Regiões de número de telefone a serem usadas para analisar números. O padrão é Finlândia se deixado vazio.

Devoluções

response
boolean

Criar contacto de grupo

Criar contacto de grupo

Parâmetros

Name Chave Necessário Tipo Description
Cliente
Customer True string

O Cliente para buscar Serviços de Grupo para.

Serviço de Grupo
Group Service True string

O Serviço de Grupo a ser usado.

Active
active boolean

Sinalizador que indica se o Contato está Ativo.

Telemóvel
phone True string

Número de telefone do Contacto.

Email
email string

Endereço de e-mail do Contacto.

Nome próprio
firstName string

Nome próprio do contacto.

Apelido
lastName string

Apelido do Contacto.

Sexo
gender string

Sexo do Contacto.

Ano de nascimento
birthYear integer

Ano de nascimento do contato.

Endereço
streetAddress string

Endereço do contato.

Código Postal
zipCode string

CEP do contato.

City
city string

Cidade do Contato.

Código do país
countryCode string

Código do país do contacto com 3 letras.

Nome
name string

Nome da propriedade personalizada.

Valor
value string

Valor da propriedade personalizada.

Regiões de número de telefone
phoneNumberRegions array of string

Regiões de número de telefone a serem usadas para analisar números. O padrão é Finlândia se deixado vazio.

Devoluções

ID exclusivo do contato criado.

ID de contato
uuid

Criar modelo do WhatsApp

Crie um novo modelo do WhatsApp.

Parâmetros

Name Chave Necessário Tipo Description
Cliente
Customer-Id True string

O Cliente para o qual criar o Modelo.

Número de Identidade
IdentityNumber True string

Número de identidade do WhatsApp usado para o modelo.

Nome de exibição
DisplayName True string

Nome de exibição do modelo.

Content
RawContent True string

Conteúdo do modelo.

Categoria do modelo
Category True string

Categoria do modelo.

Idioma do modelo
Language True string

Código de 2 caracteres para a linguagem do modelo.

Tipo de botão
Type string

Tipo de botão.

Rótulo do botão
Label string

Rótulo do botão.

Dados do botão
Data string

Dados do botão. Url (Url), número de telefone (Call) ou texto (QuickReply). O comprimento máximo é 2000 para URL e 20 para número de telefone e texto.

URL do anexo
AttachmentUrl string

URL para um anexo de exemplo.

Enviar Mensagem

Envie uma mensagem aos destinatários.

Parâmetros

Name Chave Necessário Tipo Description
Cliente
Customer-Id True string

O Cliente a utilizar para o envio.

Serviço
Service-Id True string

O Serviço a utilizar para envio.

Remetente da mensagem
Sender True string

O remetente da mensagem, pode ser alfanumérico, código longo ou código curto (aplicam-se restrições).

Conteúdo da mensagem
Content True string

O conteúdo da mensagem.

Protocolo de Mensagem
Protocol True string

O protocolo a ser usado para enviar a mensagem.

Enviar Datetime
SendDateTime date-time

A data e a hora para enviar a mensagem. Deixe vazio para enviar instantaneamente.

Address
Address True string

Endereço do destinatário da mensagem.

Uri de anexo
AttachmentUri string

Uri de anexo para ser usado ao enviar mensagem do WhatsApp que contém um anexo.

Dados do Cliente
CustomerData string

Dados de faturação/agrupamento para esta mensagem, opcional.

Mensagem do anúncio
AdMessage boolean

Sinalizador de substituição opcional para marcar a mensagem como uma mensagem de anúncio

Dlr Url
DlrUrl string

Url para retorno de chamada de status de entrega via http-get. Você pode adicionar valores querystring para url, eles serão preservados.

ID do pedido
RequestId string

ID de solicitação exclusiva opcional que pode ser usada para identificar solicitações duplicadas. Se for detetado um ID de pedido duplicado, o envio é cancelado. Não há garantia de que solicitações com IDs de solicitação duplicadas serão bloqueadas em situações de alta taxa de transferência/tráfego. O requestId dado será "lembrado" por 7 dias.

Devoluções

Name Caminho Tipo Description
ID da mensagem
MessageId string

Identificador da mensagem recém-criada.

Contagem de peças de mensagens
MessagePartCount integer

Número aproximado de partes da mensagem para esta mensagem.

Destinatários
Recipients array of object

Destinatários

Endereço do destinatário
Recipients.Address string

Endereço do destinatário (número de telefone/e-mail/ID do usuário, etc.).

ID do destinatário
Recipients.Id string

Identificador de destinatário usado para receber informações de status de entrega.

Enviar mensagem de resposta

Envie uma mensagem de resposta aos destinatários.

Parâmetros

Name Chave Necessário Tipo Description
ID da Mensagem Parental
ParentMessageId True string

O ID da mensagem pai para responder.

Cliente
Customer-Id True string

O Cliente a utilizar para o envio.

Serviço
Service-Id True string

O Serviço a utilizar para envio.

Remetente da mensagem
Sender True string

O remetente da mensagem, pode ser alfanumérico, código longo ou código curto (aplicam-se restrições).

Conteúdo da mensagem
Content True string

O conteúdo da mensagem.

Protocolo de Mensagem
Protocol True string

O protocolo a ser usado para enviar a mensagem.

Enviar Datetime
SendDateTime date-time

A data e a hora para enviar a mensagem. Deixe vazio para enviar instantaneamente.

Address
Address True string

Endereço do destinatário da mensagem.

Uri de anexo
AttachmentUri string

Uri de anexo para ser usado ao enviar mensagem do WhatsApp que contém um anexo.

Dados do Cliente
CustomerData string

Dados de faturação/agrupamento para esta mensagem, opcional.

Mensagem do anúncio
AdMessage boolean

Sinalizador de substituição opcional para marcar a mensagem como uma mensagem de anúncio

Dlr Url
DlrUrl string

Url para retorno de chamada de status de entrega via http-get. Você pode adicionar valores querystring para url, eles serão preservados.

ID do pedido
RequestId string

ID de solicitação exclusiva opcional que pode ser usada para identificar solicitações duplicadas. Se for detetado um ID de pedido duplicado, o envio é cancelado. Não há garantia de que solicitações com IDs de solicitação duplicadas serão bloqueadas em situações de alta taxa de transferência/tráfego. O requestId dado será "lembrado" por 7 dias.

Devoluções

Name Caminho Tipo Description
ID da mensagem
MessageId string

Identificador da mensagem recém-criada.

Contagem de peças de mensagens
MessagePartCount integer

Número aproximado de partes da mensagem para esta mensagem.

Destinatários
Recipients array of object

Destinatários

Endereço do destinatário
Recipients.Address string

Endereço do destinatário (número de telefone/e-mail/ID do usuário, etc.).

ID do destinatário
Recipients.Id string

Identificador de destinatário usado para receber informações de status de entrega.

Enviar mensagem de resposta à discussão

Enviar uma mensagem de resposta de discussão aos destinatários.

Parâmetros

Name Chave Necessário Tipo Description
Cliente
CustomerId True string

O Cliente a utilizar para o envio.

Thread Id
ThreadId True string

Id do Thread existente para responder.

Conteúdo da mensagem
Content True string

O conteúdo da mensagem.

Dados do Cliente
CustomerData string

Dados de faturação/agrupamento para esta mensagem, opcional.

Devoluções

Name Caminho Tipo Description
ID da mensagem
MessageId string

Identificador da mensagem recém-criada.

Contagem de peças de mensagens
MessagePartCount integer

Número aproximado de partes da mensagem para esta mensagem.

Destinatários
Recipients array of object

Destinatários

Endereço do destinatário
Recipients.Address string

Endereço do destinatário (número de telefone/e-mail/ID do usuário, etc.).

ID do destinatário
Recipients.Id string

Identificador de destinatário usado para receber informações de status de entrega.

ThreadId
ThreadId string

Identificador do thread para o qual a mensagem foi enviada.

Enviar mensagem do WhatsApp

Envie uma mensagem modelo do WhatsApp.

Parâmetros

Name Chave Necessário Tipo Description
Cliente
Customer-Id True string

O Cliente a utilizar para o envio.

Serviço
Service-Id True string

O Serviço a utilizar para envio.

Modelo do WhatsApp
TemplateName True string

O modelo a ser usado para envio.

Address
Address True string

Endereço do destinatário da mensagem.

BodyParameters
BodyParameters array of string

BodyParameters

HeaderParameters
HeaderParameters array of string

HeaderParameters

Tipo
Type string

O tipo de botão. Apenas um tipo por modelo, pode conter vários do mesmo tipo.

Texto
Data string

O texto do botão.

Enviar Datetime
SendDateTime string

A data e a hora para enviar a mensagem. Deixe vazio para enviar instantaneamente.

Uri de anexo
AttachmentUri string

O Uri de Anexo se o modelo contiver um anexo.

Usar o SMS Fallback
UseSmsFallback boolean

O SMS deve ser usado como fallback.

Dlr Url
DlrUrl string

URL do relatório de entrega que receberá um retorno de chamada quando o processo de envio for concluído.

Dados do Cliente
CustomerData string

Dados de faturação/agrupamento para esta mensagem, opcional.

ID do pedido
RequestId string

ID de solicitação exclusiva opcional que pode ser usada para identificar solicitações duplicadas. Se for detetado um ID de pedido duplicado, o envio é cancelado. Não há garantia de que solicitações com IDs de solicitação duplicadas serão bloqueadas em situações de alta taxa de transferência/tráfego. O requestId dado será "lembrado" por 7 dias.

Devoluções

Name Caminho Tipo Description
ID da mensagem
messageId string

Identificador da mensagem recém-criada.

Contagem de peças de mensagens
messagePartCount integer

Número aproximado de partes da mensagem para esta mensagem.

recipients
recipients array of object

recipients

Endereço do destinatário
recipients.address string

Endereço do destinatário (número de telefone/e-mail/ID do usuário, etc.).

ID do destinatário
recipients.id string

Identificador de destinatário usado para receber informações de status de entrega.

Excluir contato do grupo

Exclua o contato do grupo usando o número de telefone.

Parâmetros

Name Chave Necessário Tipo Description
Cliente
Customer True string

O Cliente para buscar Serviços de Grupo para.

Serviço de Grupo
Group Service True string

O Serviço de Grupo a ser usado.

Telemóvel
Phone True string

O número de telefone do contato a ser excluído.

Devoluções

response
boolean

Excluir todos os contatos do grupo

Excluir todos os contatos do grupo

Parâmetros

Name Chave Necessário Tipo Description
Cliente
Customer True string

O Cliente para buscar Serviços de Grupo para.

Serviço de Grupo
Group Service True string

O Serviço de Grupo a ser usado.

Devoluções

response
boolean

Obter contato do grupo

Obter contato do grupo

Parâmetros

Name Chave Necessário Tipo Description
Cliente
Customer True string

O Cliente para buscar Serviços de Grupo para.

Serviço de Grupo
Group Service True string

O Serviço de Grupo a ser usado.

Telemóvel
Phone True string

O número de telefone do contato.

Região
Region string

Região opcional do número de telefone a ser usada para analisar o número de telefone.

Devoluções

Name Caminho Tipo Description
Telemóvel
phone string

Número de telefone do Contacto.

Email
email string

Endereço de e-mail do Contacto.

Nome próprio
firstName string

Nome próprio do contacto.

Apelido
lastName string

Apelido do Contacto.

Sexo
gender string

Sexo do Contacto.

Ano de nascimento
birthYear integer

Ano de nascimento do contato.

Endereço
streetAddress string

Endereço do contato.

Código Postal
zipCode string

CEP do contato.

City
city string

Cidade do Contato.

Código do país
countryCode string

Código do país do contacto.

Mensagens com falha
failedMessages integer

Número de mensagens com falha para o Contato.

Propriedades personalizadas
customContactProperties array of object

Coleção de Propriedades de Contato Personalizadas salvas para o Contato.

Nome
customContactProperties.name string

Nome da propriedade de contato personalizado.

Valor
customContactProperties.value string

Valor da propriedade de contato personalizada.

WhatsApp Opt In (preterido) [PRETERIDO]

WhatsApp Opt In para remetente e destinatário. (preterido)

Parâmetros

Name Chave Necessário Tipo Description
Endereço do remetente
Sender True string

Número de identidade do Whatsapp registrado para opt-in.

Endereço do destinatário
Recipient True string

Número do destinatário para aceitar.

WhatsApp Opt out (preterido) [PRETERIDO]

WhatsApp Opt out para remetente e destinatário. (preterido)

Parâmetros

Name Chave Necessário Tipo Description
Endereço do remetente
Sender True string

Número de identidade do Whatsapp registrado para desativar.

Endereço do destinatário
Recipient True string

Número de recipente a remover do opt-in.

Acionadores

Nova Mensagem

Quando uma nova mensagem chega a um serviço de 2 vias.

Nova Mensagem

Quando uma nova mensagem chega a um serviço de 2 vias.

Parâmetros

Name Chave Necessário Tipo Description
Cliente
Customer True string

O Cliente a utilizar.

Serviço
Service True string

O serviço de 2 vias a utilizar.

Devoluções

Name Caminho Tipo Description
Remetente da mensagem
sender string

O remetente da mensagem.

Destinatário da mensagem
recipient string

O destinatário da mensagem.

Conteúdo da mensagem
content string

O conteúdo da mensagem recebida.

Carimbo de data/hora da mensagem
timestamp date-time

O carimbo de data/hora da mensagem.

Protocolo de Mensagem
protocol string

O protocolo da mensagem recebida.

attachments
attachments array of object

attachments

Nome do arquivo do anexo
attachments.name string

O nome do arquivo do anexo.

Tipo de mímica de anexo
attachments.mimeType string

O tipo mime do anexo.

Local do recurso de anexo
attachments.resourceLocation string

O local do recurso de anexo.

ID da mensagem
messageId string

O ID exclusivo da mensagem recebida.

Definições

Identificador Único Universal (UUID)

ID exclusivo do contato criado.

ID exclusivo do contato criado.

ID de contato
uuid

Booleano

Este é o tipo de dados básico 'booleano'.