Compartilhar via

SmartDialog

O SmartDialog é uma plataforma usada para enviar e receber mensagens SMS e WhatsApp. Ele oferece uma ampla variedade de serviços de mensagens inteligentes.

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

Conector SmartDialog

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

Pré-requisitos

  1. Uma assinatura e uma conta do SmartDialog. Entre em contato com sales@arenainteractive.fi
  2. O OAuth precisa ser habilitado para sua conta e um segredo do cliente precisa ser solicitado. Isso pode ser feito enviando-nos um email em support@arenainteractive.fi.

Configuração

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

Ações Suportadas

  • Nova mensagem (gatilho para receber mensagens)
  • Enviar Mensagem
  • Enviar mensagem do WhatsApp
  • Enviar mensagem de resposta de discussão
  • Enviar Mensagem de Resposta
  • Aceitar o WhatsApp
  • WhatsApp Opt Out
  • Criar modelo do WhatsApp
  • Obter contato de grupo
  • Criar contato de grupo
  • Atualizar Contato do Grupo
  • Excluir Contato de Grupo
  • Excluir todos os contatos de grupo

Limitações

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

Ações

Atualizar Contato do Grupo

Atualizar Contato do Grupo
Criar contato de grupo

Criar contato 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 um Replymessage aos destinatários.
Enviar mensagem de resposta de discussão

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

Enviar mensagem de modelo do WhatsApp.
Excluir Contato de Grupo

Excluir contato de grupo usando o número de telefone.
Excluir todos os contatos de grupo

Excluir todos os contatos de grupo
Obter contato de grupo

Obter contato de 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

ID da operação:
UpdateGroupContact

Atualizar Contato do Grupo

Parâmetros

Nome Chave Obrigatório Tipo Description
Customer
 Customer True string

O cliente para o qual buscar serviços de grupo.
Serviço de Grupo
 Group Service True string

O Serviço de Grupo a ser usado.
Telefone
 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 email do Contato.
Nome
 firstName string

Nome do contato.
Sobrenome
 lastName string

Sobrenome do Contato.
Gênero
 gender string

Gênero do Contato.
Ano de Nascimento
 birthYear integer

Ano de Nascimento do Contato.
Endereço
 streetAddress string

Endereço de rua 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 de país de 3 letras do Contato.
Nome
 name string

Nome da propriedade de contato personalizado.
Value
 value string

Valor da propriedade de contato personalizado.
Regiões phonenumber
 phoneNumberRegions array of string

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

Retornos

response
boolean

Criar contato de grupo

ID da operação:
CreateGroupContact

Criar contato de grupo

Parâmetros

Nome Chave Obrigatório Tipo Description
Customer
 Customer True string

O cliente para o qual buscar serviços de grupo.
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.
Telefone
 phone True string

Número de telefone do Contato.
Email
 email string

Endereço de email do Contato.
Nome
 firstName string

Nome do contato.
Sobrenome
 lastName string

Sobrenome do Contato.
Gênero
 gender string

Gênero do Contato.
Ano de Nascimento
 birthYear integer

Ano de Nascimento do Contato.
Endereço
 streetAddress string

Endereço de rua 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 de país de 3 letras do Contato.
Nome
 name string

Nome da propriedade personalizada.
Value
 value string

Valor da propriedade personalizada.
Regiões phonenumber
 phoneNumberRegions array of string

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

Retornos

ID exclusiva do Contato criado.

ID de contato
uuid

Criar modelo do WhatsApp

ID da operação:
CreateWhatsappTemplate

Crie um novo modelo do WhatsApp.

Parâmetros

Nome Chave Obrigatório Tipo Description
Customer
 Customer-Id True string

O cliente para o qual criar o modelo.
IdentityNumber
 IdentityNumber True string

WhatsApp IdentityNumber 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 de modelo
 Category True string

Categoria de modelo.
Linguagem de modelo
 Language True string

Código de 2 caracteres para linguagem de 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 de botão. URL (URL), número de telefone (Chamada) 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

ID da operação:
SendMessage

Envie uma mensagem aos destinatários.

Parâmetros

Nome Chave Obrigatório Tipo Description
Customer
 Customer-Id True string

O Cliente a ser usado para enviar.
Service
 Service-Id True string

O Serviço a ser usado para envio.
Remetente de Mensagens
 Sender True string

O remetente da mensagem pode ser alfanumérico, código longo ou código curto (as restrições se aplicam).
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.
Endereço
 Address True string

Endereço do destinatário da mensagem.
Uri de anexo
 AttachmentUri string

Uri do anexo a ser usado ao enviar uma mensagem do WhatsApp que contém um anexo.
Dados do Cliente
 CustomerData string

Dados de cobrança/agrupamento para essa mensagem, opcional.
Mensagem de 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 por meio de http-get. Você pode adicionar valores querystring à URL, eles serão preservados.
ID da solicitação
 RequestId string

ID de solicitação exclusiva opcional que pode ser usada para identificar solicitações duplicadas. Se uma ID de solicitação duplicada for detectada, o envio será cancelado. Não há garantia de que as solicitações com IDs de solicitação duplicadas serão bloqueadas em situações de alta taxa de transferência/tráfego. A requestId determinada será "lembrada" por 7 dias.

Retornos

Nome Caminho Tipo Description
ID da mensagem
 MessageId string

Identificador da mensagem recém-criada.
Contagem de partes de mensagem
 MessagePartCount integer

Número aproximado de partes de 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/email/id de 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

ID da operação:
SendReplyMessage

Envie um Replymessage aos destinatários.

Parâmetros

Nome Chave Obrigatório Tipo Description
ParentMessage Id
 ParentMessageId True string

A ID da mensagem pai à qual responder.
Customer
 Customer-Id True string

O Cliente a ser usado para enviar.
Service
 Service-Id True string

O Serviço a ser usado para envio.
Remetente de Mensagens
 Sender True string

O remetente da mensagem pode ser alfanumérico, código longo ou código curto (as restrições se aplicam).
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.
Endereço
 Address True string

Endereço do destinatário da mensagem.
Uri de anexo
 AttachmentUri string

Uri do anexo a ser usado ao enviar uma mensagem do WhatsApp que contém um anexo.
Dados do Cliente
 CustomerData string

Dados de cobrança/agrupamento para essa mensagem, opcional.
Mensagem de 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 por meio de http-get. Você pode adicionar valores querystring à URL, eles serão preservados.
ID da solicitação
 RequestId string

ID de solicitação exclusiva opcional que pode ser usada para identificar solicitações duplicadas. Se uma ID de solicitação duplicada for detectada, o envio será cancelado. Não há garantia de que as solicitações com IDs de solicitação duplicadas serão bloqueadas em situações de alta taxa de transferência/tráfego. A requestId determinada será "lembrada" por 7 dias.

Retornos

Nome Caminho Tipo Description
ID da mensagem
 MessageId string

Identificador da mensagem recém-criada.
Contagem de partes de mensagem
 MessagePartCount integer

Número aproximado de partes de 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/email/id de 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 de discussão

ID da operação:
SendDiscussionReplyMessage

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

Parâmetros

Nome Chave Obrigatório Tipo Description
Customer
 CustomerId True string

O Cliente a ser usado para enviar.
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 cobrança/agrupamento para essa mensagem, opcional.

Retornos

Nome Caminho Tipo Description
ID da mensagem
 MessageId string

Identificador da mensagem recém-criada.
Contagem de partes de mensagem
 MessagePartCount integer

Número aproximado de partes de 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/email/id de 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

ID da operação:
SendWhatsappTemplateMessage

Enviar mensagem de modelo do WhatsApp.

Parâmetros

Nome Chave Obrigatório Tipo Description
Customer
 Customer-Id True string

O Cliente a ser usado para enviar.
Service
 Service-Id True string

O Serviço a ser usado para envio.
Modelo do WhatsApp
 TemplateName True string

O modelo a ser usado para envio.
Endereço
 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 do Anexo se o modelo contiver um anexo.
Usar fallback de SMS
 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 cobrança/agrupamento para essa mensagem, opcional.
ID da solicitação
 RequestId string

ID de solicitação exclusiva opcional que pode ser usada para identificar solicitações duplicadas. Se uma ID de solicitação duplicada for detectada, o envio será cancelado. Não há garantia de que as solicitações com IDs de solicitação duplicadas serão bloqueadas em situações de alta taxa de transferência/tráfego. A requestId determinada será "lembrada" por 7 dias.

Retornos

Nome Caminho Tipo Description
ID da mensagem
 messageId string

Identificador da mensagem recém-criada.
Contagem de partes de mensagem
 messagePartCount integer

Número aproximado de partes de 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/email/id de 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 de Grupo

ID da operação:
DeleteGroupContact

Excluir contato de grupo usando o número de telefone.

Parâmetros

Nome Chave Obrigatório Tipo Description
Customer
 Customer True string

O cliente para o qual buscar serviços de grupo.
Serviço de Grupo
 Group Service True string

O Serviço de Grupo a ser usado.
Telefone
 Phone True string

O número de telefone do contato para Excluir.

Retornos

response
boolean

Excluir todos os contatos de grupo

ID da operação:
DeleteAllGroupContacts

Excluir todos os contatos de grupo

Parâmetros

Nome Chave Obrigatório Tipo Description
Customer
 Customer True string

O cliente para o qual buscar serviços de grupo.
Serviço de Grupo
 Group Service True string

O Serviço de Grupo a ser usado.

Retornos

response
boolean

Obter contato de grupo

ID da operação:
GetGroupContact

Obter contato de grupo

Parâmetros

Nome Chave Obrigatório Tipo Description
Customer
 Customer True string

O cliente para o qual buscar serviços de grupo.
Serviço de Grupo
 Group Service True string

O Serviço de Grupo a ser usado.
Telefone
 Phone True string

O número de telefone do Contato.
Região
 Region string

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

Retornos

Nome Caminho Tipo Description
Telefone
 phone string

Número de telefone do Contato.
Email
 email string

Endereço de email do Contato.
Nome
 firstName string

Nome do contato.
Sobrenome
 lastName string

Sobrenome do Contato.
Gênero
 gender string

Gênero do Contato.
Ano de Nascimento
 birthYear integer

Ano de Nascimento do Contato.
Endereço
 streetAddress string

Endereço de rua 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 contato.
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 Personalizada salva para o Contato.
Nome
 customContactProperties.name string

Nome da propriedade de contato personalizado.
Value
 customContactProperties.value string

Valor da propriedade de contato personalizado.

WhatsApp Opt In (preterido) [PRETERIDO]

ID da operação:
WhatsAppOptIn

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

Parâmetros

Nome Chave Obrigatório Tipo Description
Endereço do remetente.
 Sender True string

Número de identidade do Whatsapp registrado para o qual aceitar.
Endereço do destinatário
 Recipient True string

Número do destinatário a ser aceito.

WhatsApp Opt Out (preterido) [PRETERIDO]

ID da operação:
WhatsAppOptOut

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

Parâmetros

Nome Chave Obrigatório Tipo Description
Endereço do remetente.
 Sender True string

Número de identidade do Whatsapp registrado do qual recusar.
Endereço do destinatário
 Recipient True string

Número do recipent a ser removido da aceitação.

Gatilhos

Nova mensagem

Quando uma nova mensagem chega a um serviço 2-Way.

Nova mensagem

ID da operação:
NewMessage

Quando uma nova mensagem chega a um serviço 2-Way.

Parâmetros

Nome Chave Obrigatório Tipo Description
Customer
 Customer True string

O Cliente a ser usado.
Service
 Service True string

O serviço 2-Way a ser usado.

Retornos

Nome Caminho Tipo Description
Remetente de Mensagens
 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 de anexo
 attachments.name string

O nome do arquivo do anexo.
Tipo mime de anexo
 attachments.mimeType string

O tipo de mime do anexo.
Local do recurso de anexo
 attachments.resourceLocation string

O local do recurso de anexo.
ID da mensagem
 messageId string

A ID de mensagem exclusiva da mensagem recebida.

Definições

identificador único universal (UUID)

ID exclusiva do Contato criado.

ID exclusiva do Contato criado.

ID de contato
uuid

boolean

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