Condividi tramite

SmartDialog

SmartDialog è una piattaforma usata per inviare e ricevere messaggi SMS e WhatsApp. Offre un'ampia gamma di servizi di messaggistica intelligente.

Questo connettore è disponibile nei prodotti e nelle aree seguenti:

Servizio Class Regions
Copilot Studio Di alta qualità Tutte le aree di Power Automate , ad eccezione delle seguenti:
     - Governo degli Stati Uniti (GCC)
     - Us Government (GCC High)
     - China Cloud gestito da 21Vianet
     - Dipartimento della Difesa degli Stati Uniti (DoD)
App per la logica Normale Tutte le aree di App per la logica , ad eccezione delle seguenti:
     - Aree di Azure per enti pubblici
     - Aree di Azure Cina
     - Dipartimento della Difesa degli Stati Uniti (DoD)
Power Apps Di alta qualità Tutte le aree di Power Apps , ad eccezione dei seguenti:
     - Governo degli Stati Uniti (GCC)
     - Us Government (GCC High)
     - China Cloud gestito da 21Vianet
     - Dipartimento della Difesa degli Stati Uniti (DoD)
Power Automate Di alta qualità Tutte le aree di Power Automate , ad eccezione delle seguenti:
     - Governo degli Stati Uniti (GCC)
     - Us Government (GCC High)
     - China Cloud gestito da 21Vianet
     - Dipartimento della Difesa degli Stati Uniti (DoD)
Contatto
Nome Supporto interattivo Arena
URL https://www.arenainteractive.fi/contact
Email support@arenainteractive.fi
Metadati del connettore
Editore Arena Interactive Oy
Sito web https://www.arenainteractive.fi
Informativa sulla privacy https://www.arenainteractive.fi/privacypolicy
Categorie Comunicazione; Collaborazione

Connettore SmartDialog

Questo connettore può essere usato per inviare e ricevere messaggi SMS tramite la piattaforma SmartDialog.

Prerequisiti

  1. Sottoscrizione e account SmartDialog. Si prega di essere in contatto con sales@arenainteractive.fi
  2. È necessario abilitare OAuth per l'account e è necessario richiedere un segreto client. A tale scopo, inviare un messaggio di posta elettronica all'indirizzo support@arenainteractive.fi.

Configurazione

  1. Seguire le istruzioni in Creare un connettore personalizzato da una definizione OpenAPI.
  2. Creare un flusso o PowerApp e aggiungere un'azione SmartDialog dalla sezione personalizzata. Accedere con l'account SmartDialog.

Azioni supportate

  • Nuovo messaggio (trigger per la ricezione di messaggi)
  • Invia messaggio
  • Invia messaggio WhatsApp
  • Invia messaggio di risposta discussione
  • Invia messaggio di risposta
  • WhatsApp Opt In
  • WhatsApp Rifiutare esplicitamente
  • Creare un modello WhatsApp
  • Ottenere un contatto di gruppo
  • Crea contatto gruppo
  • Aggiornare il contatto del gruppo
  • Elimina contatto gruppo
  • Elimina tutti i contatti del gruppo

Limiti per la limitazione delle richieste

Nome Chiamate Periodo di rinnovo
Chiamate API per connessione 100 60 secondi

Azioni

Aggiornare il contatto del gruppo

Aggiornare il contatto del gruppo
Creare un contatto di gruppo

Creare un contatto di gruppo
Creare un modello WhatsApp

Crea un nuovo modello WhatsApp.
Elimina contatto gruppo

Eliminare il contatto del gruppo usando il numero di telefono.
Elimina tutti i contatti del gruppo

Elimina tutti i contatti del gruppo
Invia messaggio

Inviare un messaggio ai destinatari.
Invia messaggio di risposta

Inviare un messaggio di risposta ai destinatari.
Invia messaggio di risposta discussione

Inviare un messaggio di risposta di discussione ai destinatari.
Invia messaggio WhatsApp

Invia messaggio di modello WhatsApp.
Ottenere un contatto di gruppo

Ottenere un contatto di gruppo
WhatsApp Opt In (deprecato) [DEPRECATO]

WhatsApp Acconsentire esplicitamente al mittente e al destinatario. (deprecato)
WhatsApp Opt Out (deprecato) [DEPRECATO]

WhatsApp Rifiutare esplicitamente il mittente e il destinatario. (deprecato)

Aggiornare il contatto del gruppo

ID operazione:
UpdateGroupContact

Aggiornare il contatto del gruppo

Parametri

Nome Chiave Necessario Tipo Descrizione
Cliente
 Customer True string

Il cliente per cui recuperare i servizi di gruppo.
Servizio di gruppo
 Group Service True string

Servizio di gruppo da usare.
Telefono
 Phone True string

Numero di telefono del contatto da aggiornare.
Active
 active boolean

Flag che indica se il contatto è attivo.
Email
 email string

Indirizzo di posta elettronica del contatto.
Nome
 firstName string

Nome del contatto.
Cognome
 lastName string

Cognome del contatto.
Sesso
 gender string

Sesso del contatto.
Anno di nascita
 birthYear integer

Anno di nascita del contatto.
Indirizzo stradale
 streetAddress string

Indirizzo dell'indirizzo del contatto.
CAP
 zipCode string

Cap del contatto.
Città
 city string

Città del contatto.
Codice paese
 countryCode string

Codice paese di 3 lettere del contatto.
Nome
 name string

Nome della proprietà del contatto personalizzato.
Value
 value string

Valore della proprietà del contatto personalizzato.
Phonenumber Regions
 phoneNumberRegions array of string

Aree numeri di telefono da usare per l'analisi dei numeri. Il valore predefinito è Finlandia se lasciato vuoto.

Restituisce

response
boolean

Creare un contatto di gruppo

ID operazione:
CreateGroupContact

Creare un contatto di gruppo

Parametri

Nome Chiave Necessario Tipo Descrizione
Cliente
 Customer True string

Il cliente per cui recuperare i servizi di gruppo.
Servizio di gruppo
 Group Service True string

Servizio di gruppo da usare.
Active
 active boolean

Flag che indica se il contatto è attivo.
Telefono
 phone True string

Numero di telefono del contatto.
Email
 email string

Indirizzo di posta elettronica del contatto.
Nome
 firstName string

Nome del contatto.
Cognome
 lastName string

Cognome del contatto.
Sesso
 gender string

Sesso del contatto.
Anno di nascita
 birthYear integer

Anno di nascita del contatto.
Indirizzo stradale
 streetAddress string

Indirizzo dell'indirizzo del contatto.
CAP
 zipCode string

Cap del contatto.
Città
 city string

Città del contatto.
Codice paese
 countryCode string

Codice paese di 3 lettere del contatto.
Nome
 name string

Nome della proprietà personalizzata.
Value
 value string

Valore della proprietà personalizzata.
Phonenumber Regions
 phoneNumberRegions array of string

Aree numeri di telefono da usare per l'analisi dei numeri. Il valore predefinito è Finlandia se lasciato vuoto.

Restituisce

ID univoco del contatto creato.

ID contatto
uuid

Creare un modello WhatsApp

ID operazione:
CreateWhatsappTemplate

Crea un nuovo modello WhatsApp.

Parametri

Nome Chiave Necessario Tipo Descrizione
Cliente
 Customer-Id True string

Il cliente per cui creare il modello.
IdentityNumber
 IdentityNumber True string

WhatsApp IdentityNumber usato per il modello.
Displayname
 DisplayName True string

Modello Displayname.
Content
 RawContent True string

Contenuto del modello.
Categoria modello
 Category True string

Categoria di modelli.
Lingua modello
 Language True string

Codice di 2 caratteri per la lingua del modello.
Tipo di pulsante
 Type string

Tipo di pulsante.
Etichetta pulsante
 Label string

Etichetta pulsante.
Dati pulsante
 Data string

Dati dei pulsanti. URL (URL), numero di telefono (chiamata) o testo (QuickReply). La lunghezza massima è 2000 per URL e 20 per numero di telefono e testo.
URL allegato
 AttachmentUrl string

URL di un allegato di esempio.

Elimina contatto gruppo

ID operazione:
DeleteGroupContact

Eliminare il contatto del gruppo usando il numero di telefono.

Parametri

Nome Chiave Necessario Tipo Descrizione
Cliente
 Customer True string

Il cliente per cui recuperare i servizi di gruppo.
Servizio di gruppo
 Group Service True string

Servizio di gruppo da usare.
Telefono
 Phone True string

Numero di telefono del contatto da eliminare.

Restituisce

response
boolean

Elimina tutti i contatti del gruppo

ID operazione:
DeleteAllGroupContacts

Elimina tutti i contatti del gruppo

Parametri

Nome Chiave Necessario Tipo Descrizione
Cliente
 Customer True string

Il cliente per cui recuperare i servizi di gruppo.
Servizio di gruppo
 Group Service True string

Servizio di gruppo da usare.

Restituisce

response
boolean

Invia messaggio

ID operazione:
SendMessage

Inviare un messaggio ai destinatari.

Parametri

Nome Chiave Necessario Tipo Descrizione
Cliente
 Customer-Id True string

Il cliente da usare per l'invio.
Servizio
 Service-Id True string

Servizio da usare per l'invio.
Mittente del messaggio
 Sender True string

Il mittente del messaggio può essere alfanumerico, codice lungo o codice breve (si applicano restrizioni).
Contenuto del messaggio
 Content True string

Il contenuto del messaggio.
Protocollo di messaggio
 Protocol True string

Protocollo da usare per l'invio del messaggio.
Invia data/ora
 SendDateTime date-time

Data e ora di invio del messaggio. Lasciare vuoto per l'invio immediato.
Address
 Address True string

Indirizzo del destinatario del messaggio.
Uri allegato
 AttachmentUri string

Uri allegato da utilizzare quando si invia un messaggio WhatsApp che contiene un allegato.
Dati dei clienti
 CustomerData string

Dati di fatturazione/raggruppamento per questo messaggio, facoltativi.
Messaggio pubblicitario
 AdMessage boolean

Flag di override facoltativo per contrassegnare il messaggio come messaggio pubblicitario
Dlr Url
 DlrUrl string

URL per il callback dello stato del recapito tramite http-get. È possibile aggiungere valori di querystring all'URL, che verranno mantenuti.
ID richiesta
 RequestId string

ID richiesta univoco facoltativo che può essere usato per identificare le richieste duplicate. Se viene rilevato un ID richiesta duplicato, l'invio viene annullato. Non esiste alcuna garanzia che le richieste con ID richiesta duplicati vengano bloccate in situazioni di velocità effettiva/traffico elevate. Il valore requestId specificato verrà "memorizzato" per 7 giorni.

Restituisce

Nome Percorso Tipo Descrizione
ID messaggio
 MessageId string

Identificatore del messaggio appena creato.
Conteggio parti messaggio
 MessagePartCount integer

Numero approssimativo di parti del messaggio per questo messaggio.
Destinatari
 Recipients array of object

Destinatari
Indirizzo destinatario
 Recipients.Address string

Indirizzo del destinatario (numero di telefono/indirizzo di posta elettronica/ID utente e così via).
ID destinatario
 Recipients.Id string

Identificatore del destinatario utilizzato per ricevere informazioni sullo stato del recapito.

Invia messaggio di risposta

ID operazione:
SendReplyMessage

Inviare un messaggio di risposta ai destinatari.

Parametri

Nome Chiave Necessario Tipo Descrizione
ParentMessage Id
 ParentMessageId True string

ID messaggio padre a cui rispondere.
Cliente
 Customer-Id True string

Il cliente da usare per l'invio.
Servizio
 Service-Id True string

Servizio da usare per l'invio.
Mittente del messaggio
 Sender True string

Il mittente del messaggio può essere alfanumerico, codice lungo o codice breve (si applicano restrizioni).
Contenuto del messaggio
 Content True string

Il contenuto del messaggio.
Protocollo di messaggio
 Protocol True string

Protocollo da usare per l'invio del messaggio.
Invia data/ora
 SendDateTime date-time

Data e ora di invio del messaggio. Lasciare vuoto per l'invio immediato.
Address
 Address True string

Indirizzo del destinatario del messaggio.
Uri allegato
 AttachmentUri string

Uri allegato da utilizzare quando si invia un messaggio WhatsApp che contiene un allegato.
Dati dei clienti
 CustomerData string

Dati di fatturazione/raggruppamento per questo messaggio, facoltativi.
Messaggio pubblicitario
 AdMessage boolean

Flag di override facoltativo per contrassegnare il messaggio come messaggio pubblicitario
Dlr Url
 DlrUrl string

URL per il callback dello stato del recapito tramite http-get. È possibile aggiungere valori di querystring all'URL, che verranno mantenuti.
ID richiesta
 RequestId string

ID richiesta univoco facoltativo che può essere usato per identificare le richieste duplicate. Se viene rilevato un ID richiesta duplicato, l'invio viene annullato. Non esiste alcuna garanzia che le richieste con ID richiesta duplicati vengano bloccate in situazioni di velocità effettiva/traffico elevate. Il valore requestId specificato verrà "memorizzato" per 7 giorni.

Restituisce

Nome Percorso Tipo Descrizione
ID messaggio
 MessageId string

Identificatore del messaggio appena creato.
Conteggio parti messaggio
 MessagePartCount integer

Numero approssimativo di parti del messaggio per questo messaggio.
Destinatari
 Recipients array of object

Destinatari
Indirizzo destinatario
 Recipients.Address string

Indirizzo del destinatario (numero di telefono/indirizzo di posta elettronica/ID utente e così via).
ID destinatario
 Recipients.Id string

Identificatore del destinatario utilizzato per ricevere informazioni sullo stato del recapito.

Invia messaggio di risposta discussione

ID operazione:
SendDiscussionReplyMessage

Inviare un messaggio di risposta di discussione ai destinatari.

Parametri

Nome Chiave Necessario Tipo Descrizione
Cliente
 CustomerId True string

Il cliente da usare per l'invio.
Thread Id
 ThreadId True string

ID del thread esistente a cui rispondere.
Contenuto del messaggio
 Content True string

Il contenuto del messaggio.
Dati dei clienti
 CustomerData string

Dati di fatturazione/raggruppamento per questo messaggio, facoltativi.

Restituisce

Nome Percorso Tipo Descrizione
ID messaggio
 MessageId string

Identificatore del messaggio appena creato.
Conteggio parti messaggio
 MessagePartCount integer

Numero approssimativo di parti del messaggio per questo messaggio.
Destinatari
 Recipients array of object

Destinatari
Indirizzo destinatario
 Recipients.Address string

Indirizzo del destinatario (numero di telefono/indirizzo di posta elettronica/ID utente e così via).
ID destinatario
 Recipients.Id string

Identificatore del destinatario utilizzato per ricevere informazioni sullo stato del recapito.
ThreadId
 ThreadId string

Identificatore del thread a cui è stato inviato il messaggio.

Invia messaggio WhatsApp

ID operazione:
SendWhatsappTemplateMessage

Invia messaggio di modello WhatsApp.

Parametri

Nome Chiave Necessario Tipo Descrizione
Cliente
 Customer-Id True string

Il cliente da usare per l'invio.
Servizio
 Service-Id True string

Servizio da usare per l'invio.
Modello WhatsApp
 TemplateName True string

Modello da usare per l'invio.
Address
 Address True string

Indirizzo del destinatario del messaggio.
BodyParameters
 BodyParameters array of string

BodyParameters
HeaderParameters
 HeaderParameters array of string

HeaderParameters
TIPO
 Type string

Tipo di pulsante. Un solo tipo per modello può contenere più dello stesso tipo.
Testo
 Data string

Testo del pulsante.
Invia data/ora
 SendDateTime string

Data e ora di invio del messaggio. Lasciare vuoto per l'invio immediato.
Uri allegato
 AttachmentUri string

Uri allegato se il modello contiene un allegato.
Usare il fallback SMS
 UseSmsFallback boolean

Se l'SMS deve essere usato come fallback.
Dlr Url
 DlrUrl string

URL del report di recapito che riceverà un callback al termine del processo di invio.
Dati dei clienti
 CustomerData string

Dati di fatturazione/raggruppamento per questo messaggio, facoltativi.
ID richiesta
 RequestId string

ID richiesta univoco facoltativo che può essere usato per identificare le richieste duplicate. Se viene rilevato un ID richiesta duplicato, l'invio viene annullato. Non esiste alcuna garanzia che le richieste con ID richiesta duplicati vengano bloccate in situazioni di velocità effettiva/traffico elevate. Il valore requestId specificato verrà "memorizzato" per 7 giorni.

Restituisce

Nome Percorso Tipo Descrizione
ID messaggio
 messageId string

Identificatore del messaggio appena creato.
Conteggio parti messaggio
 messagePartCount integer

Numero approssimativo di parti del messaggio per questo messaggio.
Destinatari
 recipients array of object

Destinatari
Indirizzo destinatario
 recipients.address string

Indirizzo del destinatario (numero di telefono/indirizzo di posta elettronica/ID utente e così via).
ID destinatario
 recipients.id string

Identificatore del destinatario utilizzato per ricevere informazioni sullo stato del recapito.

Ottenere un contatto di gruppo

ID operazione:
GetGroupContact

Ottenere un contatto di gruppo

Parametri

Nome Chiave Necessario Tipo Descrizione
Cliente
 Customer True string

Il cliente per cui recuperare i servizi di gruppo.
Servizio di gruppo
 Group Service True string

Servizio di gruppo da usare.
Telefono
 Phone True string

Numero di telefono del contatto.
Area geografica
 Region string

Area phonenumber facoltativa da usare per l'analisi del numero di telefono.

Restituisce

Nome Percorso Tipo Descrizione
Telefono
 phone string

Numero di telefono del contatto.
Email
 email string

Indirizzo di posta elettronica del contatto.
Nome
 firstName string

Nome del contatto.
Cognome
 lastName string

Cognome del contatto.
Sesso
 gender string

Sesso del contatto.
Anno di nascita
 birthYear integer

Anno di nascita del contatto.
Indirizzo stradale
 streetAddress string

Indirizzo dell'indirizzo del contatto.
CAP
 zipCode string

Cap del contatto.
Città
 city string

Città del contatto.
Codice paese
 countryCode string

Codice paese del contatto.
Messaggi non riusciti
 failedMessages integer

Numero di messaggi non riusciti per il contatto.
Proprietà personalizzate
 customContactProperties array of object

Raccolta di proprietà contatto personalizzata salvata per il contatto.
Nome
 customContactProperties.name string

Nome della proprietà del contatto personalizzato.
Value
 customContactProperties.value string

Valore della proprietà del contatto personalizzato.

WhatsApp Opt In (deprecato) [DEPRECATO]

ID operazione:
WhatsAppOptIn

WhatsApp Acconsentire esplicitamente al mittente e al destinatario. (deprecato)

Parametri

Nome Chiave Necessario Tipo Descrizione
Indirizzo del mittente
 Sender True string

Numero di identità Di Whatsapp registrato a cui acconsentire esplicitamente.
Indirizzo destinatario
 Recipient True string

Numero destinatario da acconsentire esplicitamente.

WhatsApp Opt Out (deprecato) [DEPRECATO]

ID operazione:
WhatsAppOptOut

WhatsApp Rifiutare esplicitamente il mittente e il destinatario. (deprecato)

Parametri

Nome Chiave Necessario Tipo Descrizione
Indirizzo del mittente
 Sender True string

Numero di identità Di Whatsapp registrato per rifiutare esplicitamente.
Indirizzo destinatario
 Recipient True string

Numero ricettante da rimuovere dal consenso esplicito.

Trigger

Nuovo messaggio

Quando arriva un nuovo messaggio a un servizio bidirezionale.

Nuovo messaggio

ID operazione:
NewMessage

Quando arriva un nuovo messaggio a un servizio bidirezionale.

Parametri

Nome Chiave Necessario Tipo Descrizione
Cliente
 Customer True string

Il cliente da usare.
Servizio
 Service True string

Servizio 2-Way da usare.

Restituisce

Nome Percorso Tipo Descrizione
Mittente del messaggio
 sender string

Mittente del messaggio.
Destinatario messaggio
 recipient string

Destinatario del messaggio.
Contenuto del messaggio
 content string

Contenuto del messaggio ricevuto.
Timestamp messaggio
 timestamp date-time

Timestamp del messaggio.
Protocollo di messaggio
 protocol string

Protocollo del messaggio ricevuto.
attachments
 attachments array of object

attachments
Nome file allegato
 attachments.name string

Nome file dell'allegato.
Tipo mime allegato
 attachments.mimeType string

Tipo mime dell'allegato.
Percorso risorsa allegati
 attachments.resourceLocation string

Percorso della risorsa allegato.
ID messaggio
 messageId string

ID messaggio univoco del messaggio ricevuto.

Definizioni

UUID (Identificatore Unico Universale)

ID univoco del contatto creato.

ID univoco del contatto creato.

ID contatto
uuid

boolean

Si tratta del tipo di dati di base 'boolean'.