Udostępnij przez


Mensagia (niezależny wydawca) (wersja zapoznawcza)

Mensagia oferuje niezawodną komunikację SMS, Email i Voice na potrzeby automatyzacji biznesowej.

Ten łącznik jest dostępny w następujących produktach i regionach:

Usługa Class Regions
Copilot Studio Premium Wszystkie regiony usługi Power Automate z wyjątkiem następujących:
     - Rząd USA (GCC)
     - Rząd USA (GCC High)
     - China Cloud obsługiwane przez firmę 21Vianet
     - Departament Obrony USA (DoD)
Logic Apps Standard Wszystkie regiony usługi Logic Apps z wyjątkiem następujących:
     — Regiony platformy Azure Government
     — Regiony platformy Azure (Chiny)
     - Departament Obrony USA (DoD)
Power Apps Premium Wszystkie regiony usługi Power Apps z wyjątkiem następujących:
     - Rząd USA (GCC)
     - Rząd USA (GCC High)
     - China Cloud obsługiwane przez firmę 21Vianet
     - Departament Obrony USA (DoD)
Power Automate Premium Wszystkie regiony usługi Power Automate z wyjątkiem następujących:
     - Rząd USA (GCC)
     - Rząd USA (GCC High)
     - China Cloud obsługiwane przez firmę 21Vianet
     - Departament Obrony USA (DoD)
Kontakt
Name Sistemas Informaticos ICON, S.L.
adres URL https://www.iconsl.com/
Email asanteliz@iconsl.com
Metadane łącznika
Publisher Sistemas Informaticos ICON, S.L.
Witryna internetowa https://mensagia.com/
Zasady ochrony prywatności https://mensagia.com/legal#privacidad
Kategorie Communication

Tworzenie połączenia

Łącznik obsługuje następujące typy uwierzytelniania:

Wartość domyślna Parametry tworzenia połączenia. Wszystkie regiony Nie można udostępniać

Domyślny

Dotyczy: Wszystkie regiony

Parametry tworzenia połączenia.

Nie jest to możliwe do udostępnienia połączenie. Jeśli aplikacja Power App zostanie udostępniona innemu użytkownikowi, inny użytkownik zostanie poproszony o jawne utworzenie nowego połączenia.

Name Typ Description Wymagane
Klucz interfejsu API securestring Klucz interfejsu API dla tego interfejsu API Prawda

Limity ograniczania

Nazwa Wywołania Okres odnowienia
Wywołania interfejsu API na połączenie 100 60 sekund

Akcje

Tworzenie kontaktu

Utwórz kontakt insyfikuj konto Mensagia.

Wysyłanie kampanii SMS

Wysyłanie kampanii SMS do kontaktów za pośrednictwem konta Mensagia.

Wyślij transakcyjną wiadomość e-mail

Wyślij wiadomość e-mail transakcyjną do kontaktów przy użyciu szablonów niestandardowych z witryny Mensagia.

Wyślij wiadomość głosowa

Ta metoda umożliwia przeprowadzanie kampanii głosowych na numerach telefonów w Hiszpanii. Odbiorcami kampanii głosowej mogą być: programy, programy i numery telefonów lub numery telefonów.

Wyślij wiadomość SMS

Wyślij wiadomość SMS do swoich kontaktów za pośrednictwem konta Mensagia.

Tworzenie kontaktu

Utwórz kontakt insyfikuj konto Mensagia.

Parametry

Nazwa Klucz Wymagane Typ Opis
Znajduje się na czarnej liście poczty
in_mail_blacklist boolean

Określ, czy kontakt znajduje się na czarnej liście Adres e-mail.

Znajduje się na czarnej liście sms
in_sms_blacklist boolean

Określ, czy kontakt znajduje się w in_voice_blacklist.

Jest na czarnej liście głosów
in_voice_blacklist boolean

Określ, czy twój kontakt znajduje się na czarnej liście Głos.

Number
number True string

Numer telefonu komórkowego kontaktu bez pustych spacji z prefiksem międzynarodowym i bez znaku +.

Name
name string

Imię i nazwisko kontaktu w Mensagia.

Email
email True string

Kontaktowy adres e-mail w witrynie Mensagia.

Miejscowość
city string

Lokalizacja kontaktu.

Język
language string

Język kontaktu w kodzie ISO.

Porządek dzienny
groups string

Dodawanie kontaktu do książki adresowej

Zwraca

Nazwa Ścieżka Typ Opis
Identyfikator kontaktu
data.id integer

Identyfikator kontaktu w Mensagia

Numer kontaktowy
data.number string

Numer kontaktu

Operator wypychania
data.push_operator_destination_id string

Miejsce docelowe operatora wypychania kontaktu

Nazwa kontaktu
data.name string

Nazwa kontaktu

Kontaktowy adres e-mail
data.email string

Adres e-mail osoby kontaktowej

Lokalizacja kontaktu
data.city string

Lokalizacja kontaktu

Język kontaktu
data.language string

Język kontaktu

Kraj kontaktu
data.country_id integer

Identyfikator kraju kontaktu

Nazwa kraju
data.country_name string

Nazwa kraju kontaktu

Znajduje się na czarnej liście sms
data.in_sms_blacklist boolean

Określa, czy kontakt znajduje się na czarnej liście sms

Jest na czarnej liście głosów
data.in_voice_blacklist boolean

Określa, czy kontakt znajduje się na czarnej liście głosów

Znajduje się na czarnej liście wiadomości e-mail
data.in_mail_blacklist boolean

Określa, czy kontakt znajduje się na czarnej liście wiadomości e-mail

Utworzono pod adresem
data.created_at string

Kontakt utworzony pod adresem

Zaktualizowano o
data.updated_at string

Kontakt zaktualizowany pod adresem

dane
data.groups.data array of object

dane

Identyfikator grupy
data.groups.data.id integer

Identyfikator grupy

Nazwa grupy
data.groups.data.name string

Nazwa grupy

Użytkownicy grupy całkowitej
data.groups.data.total_users integer

Użytkownicy grupy całkowitej

Grupa jest zajęta
data.groups.data.busy integer

Grupa jest zajęta

Grupa utworzona pod adresem
data.groups.data.created_at string

Grupa utworzona pod adresem

Grupa zaktualizowana o
data.groups.data.updated_at string

Grupa zaktualizowana o

Wysyłanie kampanii SMS

Wysyłanie kampanii SMS do kontaktów za pośrednictwem konta Mensagia.

Parametry

Nazwa Klucz Wymagane Typ Opis
Nazwa konfiguracji
configuration_name True string

Wybierz nazwę, która będzie wyświetlana w nagłówku wiadomości SMS.

Message
message True string

Tekst do wysłania (nie więcej niż 160 znaków).

Nazwa kampanii
name string

Nazwa kampanii

Dostępna grupa
available_groups True string

Przypisz grupę, do której będzie kierowana kampania.

Data rozpoczęcia
start_date date-time

Wysyłanie daty w formacie "RRRR-MM-DD hh:mm". Jeśli nie określisz tego parametru, komunikat zostanie wysłany natychmiast.

Wywołania na blok
smsxblock integer

Liczba adresatów na blok. Obowiązkowe w obecności "Minuty na blok". Jeśli dwa parametry są wysyłane, konfiguracja kampanii jest zdefiniowana jako "konfiguracja niestandardowa", a wartość parametrów "Days" i "Time Intervals" będzie brana pod uwagę.

Minuty na blok
minutesxblock integer

Co kilka minut zostanie wysłany blok adresatów wybranych w polu "Połączenia na blok". Obowiązkowe w obecności "Wywołania na blok". Jeśli dwa parametry są wysyłane, konfiguracja kampanii jest zdefiniowana jako "konfiguracja niestandardowa", a wartość parametrów "Days" i "Time Intervals" będzie brana pod uwagę.

Dni
days string

Lista dni tygodnia oddzielona przecinkami i bez spacji, na których można wykonywać wywołania. (1,2,3,4,5,6,7)

Interwały czasu
time_intervals string

Lista interwałów czasu rozdzielonych przecinkami i bez spacji, w których można wysłać wywołanie. Zostanie on uwzględniony tylko wtedy, gdy są wysyłane "Minuty na blok" i "Wywołania na blok". (hh:mm-hh:mm,hh:mm-hh:mm...)

Analizatory adresów URL
url_parameters string

Tagowanie linków, jeśli w wiadomości znajduje się skrócony link, Element docelowy lub Formularz.

Tryb ekstrafields adresu URL
url_extrafields_mode string

Jeśli dołączysz skrócone linki lub lądowania w przesyłkach, możesz wybrać, jaką wartość będą wyświetlane w polach niestandardowych, gdy odbiorca wyświetli zawartość.

Zwraca

Nazwa Ścieżka Typ Opis
Identyfikator konfiguracji
data.configuration_id integer

Wysyłanie identyfikatora nagłówka

Identyfikator komunikatu
data.id integer

Identyfikator komunikatu

Nazwa wiadomości
data.name string

Nazwa wiadomości

Treść wiadomości
data.message string

Treść wiadomości

Cena
data.price float

Cena wiadomości

Cena z pakietami
data.price_with_packs float

Cena z pakietami

Nagłówek nadawcy
data.push_sender_name string

Wypychanie nazwy nadawcy

Nazwa trasy
data.route_name string

Nazwa trasy

Wysłane komunikaty
data.total_messages_sent integer

Łączna liczba wysłanych komunikatów

Pakiety wysłane wiadomości
data.total_messages_sent_with_packs integer

Łączna liczba komunikatów wysyłanych z pakietami

dlrs
data.dlrs array of object

dlrs

Identyfikator komunikatu
data.dlrs.message_id string

Identyfikator komunikatu

Do liczby
data.dlrs.number string

Liczba receptorów

Wysłane komunikaty
data.dlrs.messages_sent integer

Łączna liczba komunikatów

Znajduje się na czarnej liście sms
data.dlrs.in_SMS_blacklist boolean

Określa, czy kontakt znajduje się na czarnej liście sms

Adres URL wywołania zwrotnego
data.callback_url string

Adres URL wywołania zwrotnego

Data rozpoczęcia
data.start_date string

Data rozpoczęcia

Wyślij transakcyjną wiadomość e-mail

Wyślij wiadomość e-mail transakcyjną do kontaktów przy użyciu szablonów niestandardowych z witryny Mensagia.

Parametry

Nazwa Klucz Wymagane Typ Opis
Źródło
from True string

Adres e-mail, który będzie działać jako nadawca. Musi to być adres wysyłający utworzony na platformie lub adres wysyłający z zweryfikowaną domeną i uwierzytelniony na platformie.

Od nazwy
from_name string

Wyślij to pole, jeśli chcesz użyć innej nazwy nadawcy niż ta przechowywana w adresie wysyłającym na platformie, jeśli zostanie użyta nazwa, która została już utworzona.

Do
to True string

Adres e-mail, na który jest wysyłana przesyłka.

Temat
subject True string

Temat do wysłania.

HTML
html string

Kod HTML do wysłania. Wymagane bez parametru szablonu.

Template
template_id integer

Możesz użyć szablonu wiadomości e-mail skonfigurowanego na koncie Mensagia, aby uzyskać kod HTML do wysyłania. Jeśli ten parametr zostanie wysłany, parametr HTML zostanie zignorowany.

Wyślij o
start_date string

Data wysyłki w formacie "RRRR-MM-DD hh:mm". Jeśli ten parametr nie zostanie wysłany, wysłanie zostanie wykonane natychmiast.

Parametry adresu URL
url_parameters string

Tagowanie linków w zawartości wiadomości e-mail.

Załączniki
attachments string

Rozdzielona przecinkami lista adresów URL z plikami do dołączenia. W plikach można dołączyć maksymalnie 5 M.

Zwraca

Nazwa Ścieżka Typ Opis
Identyfikator konfiguracji aplikacji
data.app_configuration_id integer

Identyfikator konfiguracji aplikacji

Data rozpoczęcia
data.start_date string

Data rozpoczęcia

Identyfikator domeny
data.domain_id integer

Identyfikator zarejestrowanej domeny, z której jest wysyłana poczta.

Identyfikator adresu nadawcy
data.sender_address_id integer

Identyfikator adresu nadawcy

Źródło
data.from string

Nadawca wiadomości.

Nazwa nadawcy
data.from_name string

Imię i nazwisko osoby wysyłającej wiadomość.

Adresy e-mail z prawidłowymi adresami e
data.to.valids array of string

Adresy e-mail z prawidłowymi adresami e-mail,

Niezdane wiadomości e-mail
data.to.discardeds array of string

Niezdane wiadomości e-mail,

Wiadomości e-mail na czarnej liście
data.to.blacklisteds array of string

Czarnej liście

Temat
data.subject string

Temat wiadomości e-mail.

attachments
data.attachments array of string

attachments

Wyślij wiadomość głosowa

Ta metoda umożliwia przeprowadzanie kampanii głosowych na numerach telefonów w Hiszpanii. Odbiorcami kampanii głosowej mogą być: programy, programy i numery telefonów lub numery telefonów.

Parametry

Nazwa Klucz Wymagane Typ Opis
Name
name True string

Nazwa nowej kampanii głosowej.

Zweryfikowany telefon
vm_validated_phone_id True integer

Telefon, który będzie używany w tej kampanii głosowej.

Lokalizowanie typów
type True string

Typ głosu, który będzie używany w tej kampanii głosowej.

Message
message string

Tekst, który ma zostać zsyntetyzowany w celu odtworzenia w wywołaniu. Pole obowiązkowe, jeśli tekst2speech jest typem wybranej mowy.

Język wiadomości
message_language string

Kod języka, za pomocą którego chcesz syntetyzować tekst, który zostanie odtworzony w wywołaniu. Pole obowiązkowe, jeśli tekst2speech jest typem wybranej mowy.

Plik głosowy
voice_file_id string

Plik biblioteki audio, który będzie używany jako voiceover. Pole obowiązkowe, jeśli plik jest typem wybranej mowy.

Liczby
numbers string

Lista numerów telefonów rozdzielonych przecinkami bez spacji i z międzynarodowym prefiksem.

Dostępne grupy
available_groups string

Lista kontaktów, do których zostanie wysłana kampania.

Limit czasu wywołania
vm_timeout integer

Maksymalny czas trwania wywołania w minutach.

Maksymalna liczba ponownych prób
max_retries integer

Liczba ponownych prób wykonania, jeśli odbiorca połączenia nie odpowiada.

Minuty ponawiania próby 1
minutes_retry_1 integer

Interwał w minutach, w których pierwsze ponowienie próby zostanie wykonane po pierwszym wywołaniu nie zostanie odebrane. To pole jest obowiązkowe, jeśli wartość "Maksymalna liczba ponownych prób" jest większa niż 1.

Minuty ponawiania próby 2
minutes_retry_2 integer

Interwał w minutach, w których pierwsze ponowienie próby zostanie wykonane po pierwszym wywołaniu nie zostanie odebrane. To pole jest obowiązkowe, jeśli wartość "Maksymalna liczba ponownych prób" jest większa niż 2.

Minuty ponawiania próby 3
minutes_retry_3 integer

Interwał w minutach, w których pierwsze ponowienie próby zostanie wykonane po pierwszym wywołaniu nie zostanie odebrane. To pole jest obowiązkowe, jeśli wartość "Maksymalna liczba ponownych prób" jest większa niż 3.

Minuty ponawiania próby 4
minutes_retry_4 integer

Interwał w minutach, w których pierwsze ponowienie próby zostanie wykonane po pierwszym wywołaniu nie zostanie odebrane. To pole jest obowiązkowe, jeśli wartość "Maksymalna liczba ponownych prób" jest większa niż 4.

Limit czasu pierścienia
ring_timeout integer

Czas w sekundach, w których telefon odbiorcy będzie dzwonić, aby odebrać połączenie.

Kody odpowiedzi
response_codes string

(JSON) Kody odpowiedzi, które mogą być naciskane przez odbiorcę, który wygeneruje akcję wywołania.

Limit czasu kodów odpowiedzi
response_codes_timeout integer

Czas w sekundach, w których odbiorca będzie mógł nacisnąć kod odpowiedzi. To pole jest obowiązkowe w obecności "Kodów odpowiedzi"

Data rozpoczęcia
start_date string

Data rozpoczęcia kampanii w formacie "RRRR-MM-DD hh:mm". Jeśli nie wyślesz tego parametru, kampania rozpocznie się dwie minuty po utworzeniu nowej kampanii.

Wywołania na blok
callsxblock integer

Liczba adresatów na blok. Obowiązkowe w obecności "Minuty na blok". Jeśli dwa parametry są wysyłane, konfiguracja kampanii jest zdefiniowana jako "konfiguracja niestandardowa", a wartość parametrów "Days" i "Time Intervals" będzie brana pod uwagę.

Minuty na blok
minutesxblock integer

Co kilka minut zostanie wysłany blok adresatów wybranych w polu "Połączenia na blok". Obowiązkowe w obecności "Wywołania na blok". Jeśli dwa parametry są wysyłane, konfiguracja kampanii jest zdefiniowana jako "konfiguracja niestandardowa", a wartość parametrów "Days" i "Time Intervals" będzie brana pod uwagę.

Dni
days integer

Lista dni tygodnia oddzielona przecinkami i bez spacji, na których można wykonywać wywołania. (1,2,3,4,5,6,7)

Interwały czasu
time_intervals string

Lista interwałów czasu rozdzielonych przecinkami i bez spacji, w których można wysłać wywołanie. Zostanie on uwzględniony tylko wtedy, gdy są wysyłane "Minuty na blok" i "Wywołania na blok". (hh:mm-hh:mm,hh:mm-hh:mm...)

Zwraca

Nazwa Ścieżka Typ Opis
Nazwa nadawcy
data.configuration_id integer

Nazwa nagłówka nadawcy

Identyfikator kampanii głosowej
data.id integer

Identyfikator kampanii głosowej

Nazwa kampanii głosowej
data.name string

Nazwa kampanii Voice

Jest aktywna kampania
data.active integer

Określa, czy kampania jest obecnie aktywna

Identyfikator stanu
data.state_id integer

Określa identyfikację stanu wysyłania

Status
data.state_name string

Nazwa stanu

Wiadomość głosowa
data.message string

Treść wysłanej wiadomości

Data rozpoczęcia
data.start_date string

Zaplanowana data wysyłania

Zweryfikowany identyfikator telefonu
data.vm_validated_phone_id integer

Zweryfikowany identyfikator telefonu do wysłania kampanii

Zweryfikowany numer telefonu
data.vm_validated_phone_number string

Zweryfikowany numer telefonu

Programów
data.groups array of object

Programy, w których jest kierowana kampania.

Identyfikator porządku obrad
data.groups.id integer

Identyfikator grupy

Nazwa programu
data.groups.name string

Nazwa programu

Liczby
data.numbers string

Liczby, do których jest kierowana kampania.

Przerwa czasowa
data.vm_timeout integer

Przekroczenie limitu czasu połączenia

Maksymalna liczba ponownych prób
data.max_retries integer

Maksymalna liczba ponownych prób wywołania

Minimalna liczba ponownych prób w minutach
data.min_retry_minutes integer

Minimalny interwał minut oczekiwania na następną próbę.

Maksymalna liczba ponownych prób w minutach
data.max_retry_minutes integer

Maksymalny interwał minut oczekiwania na następną próbę.

Kody odpowiedzi
data.response_codes array of object

Kody odpowiedzi przypisane do wywołania.

Code
data.response_codes.code string

Nazwa kodu

Akcja
data.response_codes.action string

Akcja kodu

Przenieś do
data.response_codes.transfer_to string

Określa numer, do którego wywołanie zostanie przekierowane w razie potrzeby.

Zweryfikowany identyfikator telefonu
data.response_codes.vm_validated_phone_id string

Zweryfikowany identyfikator telefonu

Limit czasu kodów odpowiedzi
data.response_codes_timeout string

Limit czasu kodów odpowiedzi

Adres URL wywołania zwrotnego
data.callback_url string

Adres URL wywołania zwrotnego

Typ
data.type string

Typ wywołania

Wywołania na blok
data.callsxblock integer

Wywołania na blok

Minuty na blok
data.minutesxblock integer

Minuty na blok

Dozwolone dni
data.days_allowed array of string

Dni dozwolone do wysłania kampanii głosowej,

Dozwolone interwały czasu
data.time_intervals_allowed array of string

Interwały czasowe dozwolone do wysłania kampanii głosowej,

Przekroczenie limitu czasu pierścienia głosowego
data.ring_timeout integer

Maksymalny czas, w którym pierścień wywołania będzie brzmieć do momentu zakończenia próby.

Wyślij wiadomość SMS

Wyślij wiadomość SMS do swoich kontaktów za pośrednictwem konta Mensagia.

Parametry

Nazwa Klucz Wymagane Typ Opis
Nazwa konfiguracji
configuration_name True string

Wybierz nazwę, która będzie wyświetlana w nagłówku wiadomości SMS.

Message
message True string

Tekst do wysłania (nie więcej niż 160 znaków).

Liczby
numbers True string

Numer telefonu komórkowego adresata tej wiadomości. WAŻNE: Liczba musi mieć odpowiedni prefiks kraju.

Data rozpoczęcia
start_date string

Wysyłanie daty w formacie "RRRR-MM-DD hh:mm". Jeśli nie określisz tego parametru, komunikat zostanie wysłany natychmiast.

Analizatory adresów URL
url_parameters string

Tagowanie linków, jeśli w wiadomości znajduje się skrócony link, Element docelowy lub Formularz.

Tryb ekstrafields adresu URL
url_extrafields_mode string

Jeśli dołączysz skrócone linki lub lądowania w przesyłkach, możesz wybrać, jaką wartość będą wyświetlane w polach niestandardowych, gdy odbiorca wyświetli zawartość.

Zwraca

Nazwa Ścieżka Typ Opis
Identyfikator konfiguracji
data.configuration_id integer

Wysyłanie identyfikatora nagłówka

Identyfikator komunikatu
data.id integer

Identyfikator komunikatu

Nazwa wiadomości
data.name string

Nazwa wiadomości

Treść wiadomości
data.message string

Treść wiadomości

Cena
data.price float

Cena wiadomości

Cena z pakietami
data.price_with_packs float

Cena z pakietami

Nagłówek nadawcy
data.push_sender_name string

Wypychanie nazwy nadawcy

Nazwa trasy
data.route_name string

Nazwa trasy

Wysłane komunikaty
data.total_messages_sent integer

Łączna liczba wysłanych komunikatów

Pakiety wysłane wiadomości
data.total_messages_sent_with_packs integer

Łączna liczba komunikatów wysyłanych z pakietami

dlrs
data.dlrs array of object

dlrs

Identyfikator komunikatu
data.dlrs.message_id string

Identyfikator komunikatu

Do liczby
data.dlrs.number string

Liczba receptorów

Wysłane komunikaty
data.dlrs.messages_sent integer

Łączna liczba komunikatów

Znajduje się na czarnej liście sms
data.dlrs.in_SMS_blacklist boolean

Określa, czy kontakt znajduje się na czarnej liście sms

Adres URL wywołania zwrotnego
data.callback_url string

Adres URL wywołania zwrotnego

Data rozpoczęcia
data.start_date string

Data rozpoczęcia