Condividi tramite


Mensagia (anteprima)

Mensagia offre messaggi SMS, e-mail e vocali affidabili per la comunicazione di automazione aziendale.

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 Mensagia
URL https://mensagia.com/
Email support@mensagia.com
Metadati del connettore
Editore Mensagia
Sito web https://mensagia.com/
Informativa sulla privacy https://mensagia.com/legal#privacidad
Categorie Communication

Mensagia offre messaggi SMS, e-mail e vocali affidabili per la comunicazione di automazione aziendale.

Prerequisiti

Per procedere, è necessario quanto segue:

  • Un account "Client API" mensagia.
  • Assicurati di avere abbastanza saldo nel tuo conto Mensagia.

Come ottenere le credenziali

La chiave API può essere ottenuta immettendo il portale dell'account Mensagia.

Introduzione al connettore

Problemi noti e limitazioni

I metodi GET non consentono parametri.

Errori e rimedi comuni

Nessun errore commor e rimedi.

Domande frequenti

Si prega di cottarci se avete domande.

Creazione di una connessione

Il connettore supporta i tipi di autenticazione seguenti:

Predefinita Parametri per la creazione della connessione. Tutte le aree geografiche Non condivisibile

Predefinito

Applicabile: tutte le aree

Parametri per la creazione della connessione.

Questa non è una connessione condivisibile. Se l'app power viene condivisa con un altro utente, verrà richiesto a un altro utente di creare una nuova connessione in modo esplicito.

Nome TIPO Description Obbligatorio
Chiave API securestring Chiave API per questa API. Vero

Limiti per la limitazione delle richieste

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

Azioni

Creare un contatto

Creare un contatto all'interno dell'account di Mensagia.

Invia campagne SMS

Invia campagne SMS ai tuoi contatti tramite il tuo account Mensagia.

Invia messaggio di posta elettronica transazionale

Inviare un messaggio di posta elettronica transazionale ai contatti usando i modelli personalizzati di Mensagia.

Invia messaggio vocale

Questo metodo consente di effettuare campagne vocali ai numeri di telefono in Spagna. I destinatari della campagna vocale possono essere: agenda, agenda e numeri di telefono o numeri di telefono.

Invia SMS

Invia SMS ai tuoi contatti tramite il tuo account Mensagia.

Ottenere i numeri di SMS 2 Way

Ottenere un elenco dei numeri di 2 Vie SMS tramite il tuo account Mensagia.

Ottieni SMS bidirezionale

Ottieni un elenco di 2 vie SMS tramite il tuo account Mensagia.

Send 2 Way SMS

Invia un SMS 2 Way ai tuoi contatti tramite il tuo account Mensagia.

Creare un contatto

Creare un contatto all'interno dell'account di Mensagia.

Parametri

Nome Chiave Necessario Tipo Descrizione
Elenco elementi non consentiti
in_mail_blacklist boolean

Specificare se il contatto è presente nell'elenco elementi non consentiti tramite posta elettronica.

È incluso nell'elenco elementi non consentiti tramite SMS
in_sms_blacklist boolean

Specificare se il contatto è in in_voice_blacklist.

La voce è nell'elenco elementi non consentiti
in_voice_blacklist boolean

Specificare se il contatto è presente nell'elenco elementi non consentiti.

Number
number True string

Numero di cellulare del contatto senza spazi vuoti, con il prefisso internazionale e senza il segno +.

Nome
name string

Nome del contatto all'interno di Mensagia.

Email
email True string

Contatta email all'interno di Mensagia.

Città
city string

Posizione del contatto.

Language
language string

Linguaggio del contatto nel codice ISO.

Agenda
groups string

Aggiungere il contatto a una rubrica

Restituisce

Nome Percorso Tipo Descrizione
ID contatto
data.id integer

ID contatto in Mensagia

Numero contatto
data.number string

Numero del contatto

Operatore Push
data.push_operator_destination_id string

Destinazione dell'operatore Push del contatto

Nome del contatto
data.name string

Nome del contatto

Indirizzo di posta elettronica contatto
data.email string

Messaggio di posta elettronica del contatto

Posizione contatto
data.city string

Posizione del contatto

Lingua contatto
data.language string

Lingua del contatto

Paese di contatto
data.country_id integer

ID paese del contatto

Nome paese
data.country_name string

Nome paese del contatto

È incluso nell'elenco elementi non consentiti tramite SMS
data.in_sms_blacklist boolean

Determina se il contatto si trova nell'SMS Blacklist

La voce è nell'elenco elementi non consentiti
data.in_voice_blacklist boolean

Determina se il contatto si trova nell'elenco voci nere

È incluso nell'elenco elementi non consentiti tramite posta elettronica
data.in_mail_blacklist boolean

Determina se il contatto si trova nell'elenco elementi non consentiti

Creato all'indirizzo
data.created_at string

Contatto creato all'indirizzo

Aggiornato all'indirizzo
data.updated_at string

Contatto aggiornato all'indirizzo

data
data.groups.data array of object

data

ID del Gruppo
data.groups.data.id integer

ID del Gruppo

Nome del gruppo
data.groups.data.name string

Nome del gruppo

Totale utenti del gruppo
data.groups.data.total_users integer

Totale utenti del gruppo

Il gruppo è occupato
data.groups.data.busy integer

Il gruppo è occupato

Gruppo creato all'indirizzo
data.groups.data.created_at string

Gruppo creato all'indirizzo

Gruppo aggiornato all'indirizzo
data.groups.data.updated_at string

Gruppo aggiornato all'indirizzo

Invia campagne SMS

Invia campagne SMS ai tuoi contatti tramite il tuo account Mensagia.

Parametri

Nome Chiave Necessario Tipo Descrizione
Nome configurazione
configuration_name True string

Selezionare il nome che verrà visualizzato nell'intestazione dell'SMS.

Message
message True string

Testo da inviare (non più di 160 caratteri).

Nome della campagna
name string

Nome della campagna

Gruppo disponibile
available_groups True string

Assegnare il gruppo a cui verrà indirizzata la campagna.

Data di inizio
start_date date-time

Data di invio nel formato "AAAA-MM-DD hh:mm". Se non si specifica questo parametro, il messaggio verrà inviato immediatamente.

Chiamate per blocco
smsxblock integer

Numero di destinatari per blocco. Obbligatorio in presenza di "Minuti per blocco". Se vengono inviati i due parametri, la configurazione della campagna viene definita come "configurazione personalizzata" e il valore dei parametri 'Days' e 'Time Intervals' verranno considerati.

Minuti per blocco
minutesxblock integer

Ogni pochi minuti verrà inviato il blocco di destinatari scelti in "Chiamate per blocco". Obbligatorio in presenza di 'Chiamate per blocco'. Se vengono inviati i due parametri, la configurazione della campagna viene definita come "configurazione personalizzata" e il valore dei parametri 'Days' e 'Time Intervals' verranno considerati.

Giorni
days string

Elenco di giorni della settimana separati da virgole e senza spazi su cui è possibile effettuare chiamate. (1,2,3,4,5,6,7)

Intervalli di tempo
time_intervals string

Elenco di intervalli di tempo separati da virgole e senza spazi, in cui è possibile inviare la chiamata. Verrà preso in considerazione solo se vengono inviati 'Minuti per blocco' e 'Chiamate per blocco'.(hh:mm-hh:mm,hh:mm-hh:mm...)

URL Paremeters
url_parameters string

Assegnazione di tag ai collegamenti se è presente un collegamento abbreviato, Landing o Form nel messaggio.

Modalità extracampi URL
url_extrafields_mode string

Se includi collegamenti abbreviati o atterraggi nelle spedizioni, puoi scegliere il valore che verranno visualizzati dai campi personalizzati quando il destinatario visualizza il contenuto.

Restituisce

Nome Percorso Tipo Descrizione
ID configurazione
data.configuration_id integer

ID intestazione invio

ID messaggio
data.id integer

ID messaggio

Nome messaggio
data.name string

Nome del messaggio

Corpo del messaggio
data.message string

Corpo del messaggio

Prezzo
data.price float

Prezzo del messaggio

Prezzo con pacchetti
data.price_with_packs float

Prezzo con pacchetti

Intestazione mittente
data.push_sender_name string

Eseguire il push del nome del mittente

Nome route
data.route_name string

Nome del percorso

Messaggi inviati
data.total_messages_sent integer

Totale messaggi inviati

Pacchetti inviati ai messaggi
data.total_messages_sent_with_packs integer

Totale messaggi inviati con pacchetti

dlrs
data.dlrs array of object

dlrs

ID messaggio
data.dlrs.message_id string

ID messaggio

A numero
data.dlrs.number string

Numero del ricevitore

Messaggi inviati
data.dlrs.messages_sent integer

Totale messaggi al numero

È incluso nell'elenco elementi non consentiti tramite SMS
data.dlrs.in_SMS_blacklist boolean

Determina se il contatto si trova nell'SMS Blacklist

Callback URL (URL callback)
data.callback_url string

Callback URL (URL callback)

Data di inizio
data.start_date string

Data di inizio

Invia messaggio di posta elettronica transazionale

Inviare un messaggio di posta elettronica transazionale ai contatti usando i modelli personalizzati di Mensagia.

Parametri

Nome Chiave Necessario Tipo Descrizione
Da
from True string

Indirizzo di posta elettronica che fungerà da mittente. Deve essere un indirizzo di invio creato nella piattaforma o un indirizzo di invio con un dominio convalidato e autenticato nella piattaforma.

Nome mittente
from_name string

Invia questo campo se vuoi usare un nome di mittente diverso da quello archiviato in un indirizzo di invio sulla piattaforma, se ne userai uno già creato.

Per
to True string

Indirizzo di posta elettronica a cui viene effettuata la spedizione.

Oggetto
subject True string

Oggetto da inviare.

HTML
html string

CODICE HTML da inviare. Obbligatorio senza parametro Template.

Template
template_id integer

È possibile usare un modello di posta elettronica configurato nell'account Mensagia per ottenere il codice HTML per l'invio. Se questo parametro viene inviato, il parametro HTML verrà ignorato.

Invia all'indirizzo
start_date string

Data di spedizione nel formato "AAAA-MM-DD hh:mm". Se non si invia questo parametro, l'invio verrà eseguito immediatamente.

Parametri URL
url_parameters string

Assegnazione di tag ai collegamenti nel contenuto del messaggio di posta elettronica.

Attachments
attachments string

Elenco delimitato da virgole di URL con i file da allegare. È possibile allegare fino a 5M nei file.

Restituisce

Nome Percorso Tipo Descrizione
ID configurazione app
data.app_configuration_id integer

ID configurazione app

Data di inizio
data.start_date string

Data di inizio

ID dominio
data.domain_id integer

ID del dominio registrato da cui viene inviato il messaggio di posta elettronica.

ID indirizzo mittente
data.sender_address_id integer

ID indirizzo mittente

Da
data.from string

Mittente del messaggio.

Nome mittente
data.from_name string

Nome della persona che invia il messaggio.

Messaggi di posta elettronica validi
data.to.valids array of string

Messaggi di posta elettronica validi,

Messaggi di posta elettronica rimossi
data.to.discardeds array of string

Messaggi di posta elettronica rimossi,

Messaggi di posta elettronica nell'elenco elementi non consentiti
data.to.blacklisteds array of string

Messo nel libro nero

Oggetto
data.subject string

Oggetto del messaggio di posta elettronica.

attachments
data.attachments array of string

attachments

Invia messaggio vocale

Questo metodo consente di effettuare campagne vocali ai numeri di telefono in Spagna. I destinatari della campagna vocale possono essere: agenda, agenda e numeri di telefono o numeri di telefono.

Parametri

Nome Chiave Necessario Tipo Descrizione
Nome
name True string

Nome della nuova campagna vocale.

Telefono convalidato
vm_validated_phone_id True integer

Telefono che verrà utilizzato in questa campagna vocale.

Locuzione di tipo
type True string

Tipo di voiceover che verrà usato in questa campagna vocale.

Message
message string

Testo da sintetizzare per riprodurre nella chiamata. Campo obbligatorio se text2speech è il tipo di voce scelto.

Lingua dei messaggi
message_language string

Codice della lingua con cui si desidera sintetizzare il testo che verrà riprodotto nella chiamata. Campo obbligatorio se text2speech è il tipo di voce scelto.

File vocale
voice_file_id string

File di libreria audio che verrà usato come voiceover. Campo obbligatorio se il file è il tipo di voce scelto.

Numeri
numbers string

Elenco di numeri di telefono separati da virgole, senza spazi e con il prefisso internazionale.

Gruppi disponibili
available_groups string

Elenco dei contatti a cui verrà inviata la campagna.

Timeout chiamata
vm_timeout integer

Durata massima della chiamata in minuti.

Numero massimo tentativi
max_retries integer

Numero di tentativi da eseguire se il destinatario della chiamata non risponde.

Minuti di ripetizione dei tentativi 1
minutes_retry_1 integer

Intervallo in minuti in cui il primo tentativo verrà effettuato dopo la prima chiamata non viene risposto. Questo campo è obbligatorio se "Numero massimo tentativi" è maggiore di 1.

Minuti di ripetizione dei tentativi 2
minutes_retry_2 integer

Intervallo in minuti in cui il primo tentativo verrà effettuato dopo la prima chiamata non viene risposto. Questo campo è obbligatorio se "Numero massimo tentativi" è maggiore di 2.

Minuti di ripetizione dei tentativi 3
minutes_retry_3 integer

Intervallo in minuti in cui il primo tentativo verrà effettuato dopo la prima chiamata non viene risposto. Questo campo è obbligatorio se "Numero massimo tentativi" è maggiore di 3.

Minuti di ripetizione dei tentativi 4
minutes_retry_4 integer

Intervallo in minuti in cui il primo tentativo verrà effettuato dopo la prima chiamata non viene risposto. Questo campo è obbligatorio se "Numero massimo tentativi" è maggiore di 4.

Timeout circuito
ring_timeout integer

Tempo in secondi in cui il telefono del destinatario verrà squillato per ricevere la chiamata.

Codici di risposta
response_codes string

(JSON) Codici di risposta che possono essere premuti dal destinatario che genererà un'azione sulla chiamata.

Timeout dei codici di risposta
response_codes_timeout integer

Tempo in secondi in cui il destinatario potrà premere un codice di risposta. Questo campo è obbligatorio in presenza di "Codici di risposta"

Data di inizio
start_date string

Data di inizio campagna nel formato "AAAA-MM-DD hh:mm". Se non invii questo parametro, la campagna inizierà due minuti dopo la creazione della nuova campagna.

Chiamate per blocco
callsxblock integer

Numero di destinatari per blocco. Obbligatorio in presenza di "Minuti per blocco". Se vengono inviati i due parametri, la configurazione della campagna viene definita come "configurazione personalizzata" e il valore dei parametri 'Days' e 'Time Intervals' verranno considerati.

Minuti per blocco
minutesxblock integer

Ogni pochi minuti verrà inviato il blocco di destinatari scelti in "Chiamate per blocco". Obbligatorio in presenza di 'Chiamate per blocco'. Se vengono inviati i due parametri, la configurazione della campagna viene definita come "configurazione personalizzata" e il valore dei parametri 'Days' e 'Time Intervals' verranno considerati.

Giorni
days integer

Elenco di giorni della settimana separati da virgole e senza spazi su cui è possibile effettuare chiamate. (1,2,3,4,5,6,7)

Intervalli di tempo
time_intervals string

Elenco di intervalli di tempo separati da virgole e senza spazi, in cui è possibile inviare la chiamata. Verrà preso in considerazione solo se vengono inviati 'Minuti per blocco' e 'Chiamate per blocco'.(hh:mm-hh:mm,hh:mm-hh:mm...)

Restituisce

Nome Percorso Tipo Descrizione
Nome mittente
data.configuration_id integer

Nome dell'intestazione del mittente

ID campagna vocale
data.id integer

ID campagna vocale

Nome campagna vocale
data.name string

Nome della campagna vocale

Campagna attiva
data.active integer

Determina se la campagna è attualmente attiva

ID stato
data.state_id integer

Determina l'identificazione dello stato di invio

stato
data.state_name string

Nome stato

Messaggio vocale
data.message string

Corpo del messaggio inviato

Data di inizio
data.start_date string

Data pianificata per l'invio

ID telefono convalidato
data.vm_validated_phone_id integer

ID telefono convalidato per inviare la campagna

Numero di telefono convalidato
data.vm_validated_phone_number string

Numero di telefono convalidato

Agende
data.groups array of object

Agenda a cui viene indirizzata la campagna.

Agenda ID
data.groups.id integer

ID del Gruppo

Nome agenda
data.groups.name string

Nome agenda

Numeri
data.numbers string

Numeri a cui viene indirizzata la campagna.

Interruzione temporanea
data.vm_timeout integer

Timeout della chiamata

Numero massimo tentativi
data.max_retries integer

Numero massimo di tentativi di chiamata

Minuti minimi tentativi
data.min_retry_minutes integer

Intervallo minimo di minuti per attendere fino al tentativo successivo.

Numero massimo di tentativi
data.max_retry_minutes integer

Intervallo massimo di minuti di attesa fino al tentativo successivo.

Codici di risposta
data.response_codes array of object

Codici di risposta assegnati alla chiamata.

Codice
data.response_codes.code string

Nome del codice

Action
data.response_codes.action string

Azione del codice

Trasferisci a
data.response_codes.transfer_to string

Specifica il numero a cui verrà reindirizzata la chiamata, se necessario.

ID telefono convalidato
data.response_codes.vm_validated_phone_id string

ID telefono convalidato

Timeout dei codici di risposta
data.response_codes_timeout string

Timeout dei codici di risposta

Callback URL (URL callback)
data.callback_url string

URL di callback

TIPO
data.type string

Tipo di chiamata

Chiamate per blocco
data.callsxblock integer

Chiamate per blocco

Minuti per blocco
data.minutesxblock integer

Minuti per blocco

Giorni consentiti
data.days_allowed array of string

Giorni consentiti per inviare la campagna vocale,

Intervalli di tempo consentiti
data.time_intervals_allowed array of string

Intervalli di tempo consentiti per inviare la campagna vocale,

Timeout dell'anello vocale
data.ring_timeout integer

Tempo massimo in cui l'anello di chiamata sarà audio fino al completamento del tentativo.

Invia SMS

Invia SMS ai tuoi contatti tramite il tuo account Mensagia.

Parametri

Nome Chiave Necessario Tipo Descrizione
Nome configurazione
configuration_name True string

Selezionare il nome che verrà visualizzato nell'intestazione dell'SMS.

Message
message True string

Testo da inviare (non più di 160 caratteri).

Numeri
numbers True string

Numero di cellulare del destinatario del messaggio. IMPORTANTE: il numero deve avere il prefisso del paese corrispondente.

Data di inizio
start_date string

Data di invio nel formato "AAAA-MM-DD hh:mm". Se non si specifica questo parametro, il messaggio verrà inviato immediatamente.

URL Paremeters
url_parameters string

Assegnazione di tag ai collegamenti se è presente un collegamento abbreviato, Landing o Form nel messaggio.

Modalità extracampi URL
url_extrafields_mode string

Se includi collegamenti abbreviati o atterraggi nelle spedizioni, puoi scegliere il valore che verranno visualizzati dai campi personalizzati quando il destinatario visualizza il contenuto.

Restituisce

Nome Percorso Tipo Descrizione
ID configurazione
data.configuration_id integer

ID intestazione invio

ID messaggio
data.id integer

ID messaggio

Nome messaggio
data.name string

Nome del messaggio

Corpo del messaggio
data.message string

Corpo del messaggio

Prezzo
data.price float

Prezzo del messaggio

Prezzo con pacchetti
data.price_with_packs float

Prezzo con pacchetti

Intestazione mittente
data.push_sender_name string

Eseguire il push del nome del mittente

Nome route
data.route_name string

Nome del percorso

Messaggi inviati
data.total_messages_sent integer

Totale messaggi inviati

Pacchetti inviati ai messaggi
data.total_messages_sent_with_packs integer

Totale messaggi inviati con pacchetti

dlrs
data.dlrs array of object

dlrs

ID messaggio
data.dlrs.message_id string

ID messaggio

A numero
data.dlrs.number string

Numero del ricevitore

Messaggi inviati
data.dlrs.messages_sent integer

Totale messaggi al numero

È incluso nell'elenco elementi non consentiti tramite SMS
data.dlrs.in_SMS_blacklist boolean

Determina se il contatto si trova nell'SMS Blacklist

Callback URL (URL callback)
data.callback_url string

Callback URL (URL callback)

Data di inizio
data.start_date string

Data di inizio

Ottenere i numeri di SMS 2 Way

Ottenere un elenco dei numeri di 2 Vie SMS tramite il tuo account Mensagia.

Restituisce

Nome Percorso Tipo Descrizione
data
data array of object
ID messaggio
data.id integer

ID messaggio

Number
data.number string

Number

Callback URL (URL callback)
data.callback_url string

Callback URL (URL callback)

Creato all'indirizzo
data.created_at string

Creato all'indirizzo

Total
meta.pagination.total integer

Total

Conteggio
meta.pagination.count integer

Conteggio

Per pagina
meta.pagination.per_page integer

Risultati per pagina

Pagina corrente
meta.pagination.current_page integer

Pagina corrente

Totale pagine
meta.pagination.total_pages integer

Totale pagine

links
meta.pagination.links array of string

links

Ottieni SMS bidirezionale

Ottieni un elenco di 2 vie SMS tramite il tuo account Mensagia.

Restituisce

Nome Percorso Tipo Descrizione
ID messaggio
id integer

ID messaggio

ID dell'applicazione
application_id string

ID dell'applicazione

ID configurazione
configuration_id integer

ID intestazione invio

Number
number string

Number

TIPO
type string

Tipo di SMS (MO o MT)

A numero
enduser_number string

Numero del ricevitore

Corpo del messaggio
message string

Corpo del messaggio

Creato all'indirizzo
created_at string

Creato all'indirizzo

Send 2 Way SMS

Invia un SMS 2 Way ai tuoi contatti tramite il tuo account Mensagia.

Parametri

Nome Chiave Necessario Tipo Descrizione
Number
number True string

Numero 2 Via SMS da cui inviare il messaggio

A numero
enduser_number True string

Numero del ricevitore

Message
message True string

Testo da inviare (non più di 160 caratteri).

Restituisce

Nome Percorso Tipo Descrizione
ID messaggio
id integer

ID messaggio

ID dell'applicazione
application_id string

ID dell'applicazione

ID configurazione
configuration_id integer

ID intestazione invio

Number
number string

Number

TIPO
type string

Tipo di SMS (MO o MT)

A numero
enduser_number string

Numero del ricevitore

Corpo del messaggio
message string

Corpo del messaggio

Creato all'indirizzo
created_at string

Creato all'indirizzo