SmartDialog
SmartDialog es una plataforma que se usa para enviar y recibir mensajes SMS y WhatsApp. Ofrece una amplia variedad de servicios de mensajería inteligente.
Este conector está disponible en los siguientes productos y regiones:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Todas las regiones de Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Aplicaciones lógicas | Estándar | Todas las regiones de Logic Apps excepto las siguientes: - Regiones de Azure Government - Regiones de Azure China - Departamento de Defensa de EE. UU. (DoD) |
| Power Apps | Premium | Todas las regiones de Power Apps excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Power Automate | Premium | Todas las regiones de Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Contacto | |
|---|---|
| Nombre | Compatibilidad interactiva con Arena |
| URL | https://www.arenainteractive.fi/contact |
| Correo Electrónico | support@arenainteractive.fi |
| Metadatos del conector | |
|---|---|
| Publicador | Arena Interactive Oy |
| Sitio web | https://www.arenainteractive.fi |
| Directiva de privacidad | https://www.arenainteractive.fi/privacypolicy |
| Categorías | Comunicación; Colaboración |
Conector smartDialog
Este conector se puede usar para enviar y recibir mensajes SMS mediante la plataforma SmartDialog.
Prerrequisitos
- Una suscripción y una cuenta de SmartDialog. Póngase en contacto con sales@arenainteractive.fi
- OAuth debe estar habilitado para su cuenta y se debe solicitar un secreto de cliente. Esto se puede hacer enviando un correo electrónico a support@arenainteractive.fi.
Configuración
- Siga las instrucciones de Creación de un conector personalizado a partir de una definición de OpenAPI.
- Cree un flujo o PowerApp y agregue una acción SmartDialog desde la sección personalizada. Inicie sesión con su cuenta de SmartDialog.
Acciones admitidas
- Nuevo mensaje (desencadenador para recibir mensajes)
- Enviar mensaje
- Enviar mensaje de WhatsApp
- Enviar mensaje de respuesta de discusión
- Enviar mensaje de respuesta
- WhatsApp Opt In
- WhatsApp Opt Out
- Creación de una plantilla de WhatsApp
- Obtener contacto de grupo
- Crear contacto de grupo
- Actualizar contacto de grupo
- Eliminar contacto de grupo
- Eliminar todos los contactos de grupo
Limitaciones
| Nombre | Llamadas | Período de renovación |
|---|---|---|
| Llamadas API por conexión | 100 | 60 segundos |
Acciones
| Actualizar contacto de grupo |
Actualizar contacto de grupo |
|
Creación de una plantilla de Whats |
Cree una nueva plantilla de WhatsApp. |
| Crear contacto de grupo |
Crear contacto de grupo |
| Eliminar contacto de grupo |
Elimine el contacto de grupo mediante el número de teléfono. |
| Eliminar todos los contactos de grupo |
Eliminar todos los contactos de grupo |
| Enviar mensaje |
Enviar un mensaje a los destinatarios. |
| Enviar mensaje de respuesta |
Enviar un mensaje de respuesta a los destinatarios. |
| Enviar mensaje de respuesta de discusión |
Enviar un mensaje de respuesta de discusión a los destinatarios. |
|
Enviar mensaje de Whats |
Envíe un mensaje de plantilla de WhatsApp. |
| Obtener contacto de grupo |
Obtener contacto de grupo |
|
Whats |
WhatsApp opte por remitente y destinatario. (en desuso) |
|
Whats |
WhatsApp Opt Out para remitente y destinatario. (en desuso) |
Actualizar contacto de grupo
Actualizar contacto de grupo
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Cliente
|
Customer | True | string |
Cliente para el que se van a capturar los servicios de grupo. |
|
Servicio de grupo
|
Group Service | True | string |
Servicio de grupo que se va a usar. |
|
Teléfono
|
Phone | True | string |
Número de teléfono del contacto que se va a actualizar. |
|
Active
|
active | boolean |
Marca que indica si el contacto es Activo. |
|
|
Correo Electrónico
|
string |
Dirección de correo electrónico del contacto. |
||
|
Firstname
|
firstName | string |
Nombre del contacto. |
|
|
Apellidos
|
lastName | string |
Apellido del contacto. |
|
|
Gender
|
gender | string |
Sexo del contacto. |
|
|
Año de nacimiento
|
birthYear | integer |
Año de nacimiento del contacto. |
|
|
Dirección de la calle
|
streetAddress | string |
Dirección postal del contacto. |
|
|
Código postal
|
zipCode | string |
Código postal del contacto. |
|
|
City
|
city | string |
Ciudad del contacto. |
|
|
Código de país
|
countryCode | string |
Código de país de 3 letras del contacto. |
|
|
Nombre
|
name | string |
Nombre de propiedad de contacto personalizado. |
|
|
Importancia
|
value | string |
Valor de propiedad de contacto personalizado. |
|
|
Regiones de número de teléfono
|
phoneNumberRegions | array of string |
Regiones de número telefónico que se usarán para analizar números. El valor predeterminado es Finlandia si se deja vacío. |
Devoluciones
- response
- boolean
Creación de una plantilla de WhatsApp
Cree una nueva plantilla de WhatsApp.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Cliente
|
Customer-Id | True | string |
Cliente para el que se va a crear la plantilla. |
|
IdentityNumber
|
IdentityNumber | True | string |
WhatsApp IdentityNumber usado para la plantilla. |
|
Displayname
|
DisplayName | True | string |
Nombre para mostrar de plantilla. |
|
Content
|
RawContent | True | string |
Contenido de la plantilla. |
|
Categoría de plantilla
|
Category | True | string |
Categoría de plantilla. |
|
Lenguaje de plantilla
|
Language | True | string |
Código de 2 caracteres para el lenguaje de plantilla. |
|
Tipo de botón
|
Type | string |
Tipo de Botón. |
|
|
Etiqueta de botón
|
Label | string |
Etiqueta del botón. |
|
|
Datos de botón
|
Data | string |
Datos de botón. Url (Url), número de teléfono (llamada) o texto (QuickReply). La longitud máxima es 2000 para url y 20 para el número de teléfono y el texto. |
|
|
Dirección URL de datos adjuntos
|
AttachmentUrl | string |
Dirección URL a un ejemplo de datos adjuntos. |
Crear contacto de grupo
Crear contacto de grupo
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Cliente
|
Customer | True | string |
Cliente para el que se van a capturar los servicios de grupo. |
|
Servicio de grupo
|
Group Service | True | string |
Servicio de grupo que se va a usar. |
|
Active
|
active | boolean |
Marca que indica si el contacto es Activo. |
|
|
Teléfono
|
phone | True | string |
Número de teléfono del contacto. |
|
Correo Electrónico
|
string |
Dirección de correo electrónico del contacto. |
||
|
Firstname
|
firstName | string |
Nombre del contacto. |
|
|
Apellidos
|
lastName | string |
Apellido del contacto. |
|
|
Gender
|
gender | string |
Sexo del contacto. |
|
|
Año de nacimiento
|
birthYear | integer |
Año de nacimiento del contacto. |
|
|
Dirección de la calle
|
streetAddress | string |
Dirección postal del contacto. |
|
|
Código postal
|
zipCode | string |
Código postal del contacto. |
|
|
City
|
city | string |
Ciudad del contacto. |
|
|
Código de país
|
countryCode | string |
Código de país de 3 letras del contacto. |
|
|
Nombre
|
name | string |
Nombre de propiedad personalizado. |
|
|
Importancia
|
value | string |
Valor de propiedad personalizado. |
|
|
Regiones de número de teléfono
|
phoneNumberRegions | array of string |
Regiones de número telefónico que se usarán para analizar números. El valor predeterminado es Finlandia si se deja vacío. |
Devoluciones
Identificador único del contacto creado.
- ID de contacto
- uuid
Eliminar contacto de grupo
Elimine el contacto de grupo mediante el número de teléfono.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Cliente
|
Customer | True | string |
Cliente para el que se van a capturar los servicios de grupo. |
|
Servicio de grupo
|
Group Service | True | string |
Servicio de grupo que se va a usar. |
|
Teléfono
|
Phone | True | string |
Número de teléfono del contacto que se va a eliminar. |
Devoluciones
- response
- boolean
Eliminar todos los contactos de grupo
Eliminar todos los contactos de grupo
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Cliente
|
Customer | True | string |
Cliente para el que se van a capturar los servicios de grupo. |
|
Servicio de grupo
|
Group Service | True | string |
Servicio de grupo que se va a usar. |
Devoluciones
- response
- boolean
Enviar mensaje
Enviar un mensaje a los destinatarios.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Cliente
|
Customer-Id | True | string |
Cliente que se va a usar para el envío. |
|
Service
|
Service-Id | True | string |
Servicio que se va a usar para el envío. |
|
Remitente del mensaje
|
Sender | True | string |
El remitente del mensaje puede ser alfanumérico, código largo o código corto (se aplican restricciones). |
|
Contenido del mensaje
|
Content | True | string |
Contenido del mensaje. |
|
Protocolo de mensajes
|
Protocol | True | string |
Protocolo que se va a usar para enviar el mensaje. |
|
Enviar fecha y hora
|
SendDateTime | date-time |
Fecha y hora de envío del mensaje. Deje vacío para enviar al instante. |
|
|
Dirección
|
Address | True | string |
Dirección del destinatario del mensaje. |
|
Uri de datos adjuntos
|
AttachmentUri | string |
Uri de datos adjuntos que se va a usar al enviar un mensaje de WhatsApp que contiene datos adjuntos. |
|
|
Datos del cliente
|
CustomerData | string |
Datos de facturación o agrupación para este mensaje, opcional. |
|
|
Mensaje de anuncio
|
AdMessage | boolean |
Marcador de invalidación opcional para marcar el mensaje como un mensaje de anuncio |
|
|
Dlr Url
|
DlrUrl | string |
Dirección URL de devolución de llamada de estado de entrega a través de http-get. Puede agregar valores de cadena de consulta a la dirección URL, que se conservarán. |
|
|
Id. de solicitud
|
RequestId | string |
Identificador de solicitud único opcional que se puede usar para identificar solicitudes duplicadas. Si se detecta un identificador de solicitud duplicado, se cancela el envío. No hay ninguna garantía de que las solicitudes con identificadores de solicitud duplicados se bloqueen en situaciones de alto rendimiento y tráfico. El requestId especificado se "recordará" durante 7 días. |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Id. de mensaje
|
MessageId | string |
Identificador del mensaje recién creado. |
|
Recuento de elementos de mensaje
|
MessagePartCount | integer |
Número aproximado de elementos de mensaje para este mensaje. |
|
Recipientes
|
Recipients | array of object |
Recipientes |
|
Dirección del destinatario
|
Recipients.Address | string |
Dirección del destinatario (número de teléfono, correo electrónico o identificador de usuario, etc.). |
|
Id. de destinatario
|
Recipients.Id | string |
Identificador de destinatario usado para recibir información de estado de entrega. |
Enviar mensaje de respuesta
Enviar un mensaje de respuesta a los destinatarios.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
ParentMessage Id
|
ParentMessageId | True | string |
Identificador de mensaje primario al que responder. |
|
Cliente
|
Customer-Id | True | string |
Cliente que se va a usar para el envío. |
|
Service
|
Service-Id | True | string |
Servicio que se va a usar para el envío. |
|
Remitente del mensaje
|
Sender | True | string |
El remitente del mensaje puede ser alfanumérico, código largo o código corto (se aplican restricciones). |
|
Contenido del mensaje
|
Content | True | string |
Contenido del mensaje. |
|
Protocolo de mensajes
|
Protocol | True | string |
Protocolo que se va a usar para enviar el mensaje. |
|
Enviar fecha y hora
|
SendDateTime | date-time |
Fecha y hora de envío del mensaje. Deje vacío para enviar al instante. |
|
|
Dirección
|
Address | True | string |
Dirección del destinatario del mensaje. |
|
Uri de datos adjuntos
|
AttachmentUri | string |
Uri de datos adjuntos que se va a usar al enviar un mensaje de WhatsApp que contiene datos adjuntos. |
|
|
Datos del cliente
|
CustomerData | string |
Datos de facturación o agrupación para este mensaje, opcional. |
|
|
Mensaje de anuncio
|
AdMessage | boolean |
Marcador de invalidación opcional para marcar el mensaje como un mensaje de anuncio |
|
|
Dlr Url
|
DlrUrl | string |
Dirección URL de devolución de llamada de estado de entrega a través de http-get. Puede agregar valores de cadena de consulta a la dirección URL, que se conservarán. |
|
|
Id. de solicitud
|
RequestId | string |
Identificador de solicitud único opcional que se puede usar para identificar solicitudes duplicadas. Si se detecta un identificador de solicitud duplicado, se cancela el envío. No hay ninguna garantía de que las solicitudes con identificadores de solicitud duplicados se bloqueen en situaciones de alto rendimiento y tráfico. El requestId especificado se "recordará" durante 7 días. |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Id. de mensaje
|
MessageId | string |
Identificador del mensaje recién creado. |
|
Recuento de elementos de mensaje
|
MessagePartCount | integer |
Número aproximado de elementos de mensaje para este mensaje. |
|
Recipientes
|
Recipients | array of object |
Recipientes |
|
Dirección del destinatario
|
Recipients.Address | string |
Dirección del destinatario (número de teléfono, correo electrónico o identificador de usuario, etc.). |
|
Id. de destinatario
|
Recipients.Id | string |
Identificador de destinatario usado para recibir información de estado de entrega. |
Enviar mensaje de respuesta de discusión
Enviar un mensaje de respuesta de discusión a los destinatarios.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Cliente
|
CustomerId | True | string |
Cliente que se va a usar para el envío. |
|
Identificador de subproceso
|
ThreadId | True | string |
Identificador del subproceso existente al que responder. |
|
Contenido del mensaje
|
Content | True | string |
Contenido del mensaje. |
|
Datos del cliente
|
CustomerData | string |
Datos de facturación o agrupación para este mensaje, opcional. |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Id. de mensaje
|
MessageId | string |
Identificador del mensaje recién creado. |
|
Recuento de elementos de mensaje
|
MessagePartCount | integer |
Número aproximado de elementos de mensaje para este mensaje. |
|
Recipientes
|
Recipients | array of object |
Recipientes |
|
Dirección del destinatario
|
Recipients.Address | string |
Dirección del destinatario (número de teléfono, correo electrónico o identificador de usuario, etc.). |
|
Id. de destinatario
|
Recipients.Id | string |
Identificador de destinatario usado para recibir información de estado de entrega. |
|
ThreadId
|
ThreadId | string |
Identificador del subproceso al que se envió el mensaje. |
Enviar mensaje de WhatsApp
Envíe un mensaje de plantilla de WhatsApp.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Cliente
|
Customer-Id | True | string |
Cliente que se va a usar para el envío. |
|
Service
|
Service-Id | True | string |
Servicio que se va a usar para el envío. |
|
Plantilla de WhatsApp
|
TemplateName | True | string |
Plantilla que se va a usar para el envío. |
|
Dirección
|
Address | True | string |
Dirección del destinatario del mensaje. |
|
BodyParameters
|
BodyParameters | array of string |
BodyParameters |
|
|
HeaderParameters
|
HeaderParameters | array of string |
HeaderParameters |
|
|
Tipo
|
Type | string |
Tipo de botón. Solo un tipo por plantilla puede contener varios del mismo tipo. |
|
|
Mensaje de texto
|
Data | string |
Texto del botón. |
|
|
Enviar fecha y hora
|
SendDateTime | string |
Fecha y hora de envío del mensaje. Deje vacío para enviar al instante. |
|
|
Uri de datos adjuntos
|
AttachmentUri | string |
Uri de datos adjuntos si la plantilla contiene datos adjuntos. |
|
|
Uso de reserva de SMS
|
UseSmsFallback | boolean |
Debe usarse SMS como reserva. |
|
|
Dlr Url
|
DlrUrl | string |
Dirección URL del informe de entrega que recibirá una devolución de llamada cuando se complete el proceso de envío. |
|
|
Datos del cliente
|
CustomerData | string |
Datos de facturación o agrupación para este mensaje, opcional. |
|
|
Id. de solicitud
|
RequestId | string |
Identificador de solicitud único opcional que se puede usar para identificar solicitudes duplicadas. Si se detecta un identificador de solicitud duplicado, se cancela el envío. No hay ninguna garantía de que las solicitudes con identificadores de solicitud duplicados se bloqueen en situaciones de alto rendimiento y tráfico. El requestId especificado se "recordará" durante 7 días. |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Id. de mensaje
|
messageId | string |
Identificador del mensaje recién creado. |
|
Recuento de elementos de mensaje
|
messagePartCount | integer |
Número aproximado de elementos de mensaje para este mensaje. |
|
destinatarios
|
recipients | array of object |
destinatarios |
|
Dirección del destinatario
|
recipients.address | string |
Dirección del destinatario (número de teléfono, correo electrónico o identificador de usuario, etc.). |
|
Id. de destinatario
|
recipients.id | string |
Identificador de destinatario usado para recibir información de estado de entrega. |
Obtener contacto de grupo
Obtener contacto de grupo
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Cliente
|
Customer | True | string |
Cliente para el que se van a capturar los servicios de grupo. |
|
Servicio de grupo
|
Group Service | True | string |
Servicio de grupo que se va a usar. |
|
Teléfono
|
Phone | True | string |
Número de teléfono del contacto. |
|
Región
|
Region | string |
Región phonenumber opcional que se va a usar para analizar el número de teléfono. |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Teléfono
|
phone | string |
Número de teléfono del contacto. |
|
Correo Electrónico
|
string |
Dirección de correo electrónico del contacto. |
|
|
Firstname
|
firstName | string |
Nombre del contacto. |
|
Apellidos
|
lastName | string |
Apellido del contacto. |
|
Gender
|
gender | string |
Sexo del contacto. |
|
Año de nacimiento
|
birthYear | integer |
Año de nacimiento del contacto. |
|
Dirección de la calle
|
streetAddress | string |
Dirección postal del contacto. |
|
Código postal
|
zipCode | string |
Código postal del contacto. |
|
City
|
city | string |
Ciudad del contacto. |
|
Código de país
|
countryCode | string |
Código de país del contacto. |
|
Mensajes con error
|
failedMessages | integer |
Número de mensajes con error para el contacto. |
|
Propiedades personalizadas
|
customContactProperties | array of object |
Colección propiedad contact personalizada guardada para el contacto. |
|
Nombre
|
customContactProperties.name | string |
Nombre de propiedad de contacto personalizado. |
|
Importancia
|
customContactProperties.value | string |
Valor de propiedad de contacto personalizado. |
WhatsApp Opt In (en desuso) [EN DESUSO]
WhatsApp opte por remitente y destinatario. (en desuso)
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Dirección del remitente
|
Sender | True | string |
Número de identidad registrado de WhatsApp para participar. |
|
Dirección del destinatario
|
Recipient | True | string |
Número de destinatario para participar. |
WhatsApp Opt Out (en desuso) [EN DESUSO]
WhatsApp Opt Out para remitente y destinatario. (en desuso)
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Dirección del remitente
|
Sender | True | string |
Número de identidad de WhatsApp registrado para rechazarlo. |
|
Dirección del destinatario
|
Recipient | True | string |
Número de recetante que se va a quitar de la participación. |
Desencadenadores
| Nuevo mensaje |
Cuando llega un nuevo mensaje a un servicio 2-Way. |
Nuevo mensaje
Cuando llega un nuevo mensaje a un servicio 2-Way.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Cliente
|
Customer | True | string |
Cliente que se va a usar. |
|
Service
|
Service | True | string |
El servicio 2-Way que se va a usar. |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Remitente del mensaje
|
sender | string |
Remitente del mensaje. |
|
Destinatario del mensaje
|
recipient | string |
Destinatario del mensaje. |
|
Contenido del mensaje
|
content | string |
Contenido del mensaje recibido. |
|
Marca de tiempo del mensaje
|
timestamp | date-time |
Marca de tiempo del mensaje. |
|
Protocolo de mensajes
|
protocol | string |
Protocolo del mensaje recibido. |
|
attachments
|
attachments | array of object |
attachments |
|
Nombre de archivo adjunto
|
attachments.name | string |
Nombre de archivo de los datos adjuntos. |
|
Tipo mime de datos adjuntos
|
attachments.mimeType | string |
Tipo mime de los datos adjuntos. |
|
Ubicación del recurso de datos adjuntos
|
attachments.resourceLocation | string |
Ubicación del recurso de datos adjuntos. |
|
Id. de mensaje
|
messageId | string |
Identificador de mensaje único del mensaje recibido. |
Definiciones
Identificador Único Universal (UUID)
Identificador único del contacto creado.
Identificador único del contacto creado.
- ID de contacto
- uuid
boolean
Este es el tipo de datos básico "booleano".