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 |
| 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
- Uma assinatura e uma conta SmartDialog. Por favor, entre em contato com sales@arenainteractive.fi
- 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
- Siga as instruções em Criar um conector personalizado a partir de uma definição OpenAPI.
- 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 Whats |
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 Whats |
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 |
|
Whats |
WhatsApp Opt In para remetente e destinatário. (preterido) |
|
Whats |
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
|
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
|
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
|
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)
Booleano
Este é o tipo de dados básico 'booleano'.