Formularz poczty (wersja zapoznawcza)
Najprostszym sposobem drukowania i pocztówek i pocztówek: USPS First Class, Certified, Priority i Priority Express Mail.
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 | Obsługa form poczty |
| adres URL | https://help.mailform.io |
| support@mailform.io |
| Metadane łącznika | |
|---|---|
| Publisher | Mailform, Inc. |
| Witryna internetowa | https://www.mailform.io |
| Zasady ochrony prywatności | https://www.mailform.io/privacy |
| Warunki użytkowania usługi | https://www.mailform.io/terms |
| Kategorie | Zarządzanie biznesem; Marketing |
Łącznik Mailform umożliwia przepływom w środowisku usługi Power Automate wysyłanie poczty fizycznej: podaj dowód PDF i niektóre specyfikacje drukowania, takie jak kolor/i biały drukowanie lub drukowanie simplex/duplex, a mailform wyświetli dokument do specyfikacji, wypchnie go w odpowiedniej kopercie, dodaj pocztę i przekaże do USPS (i wkrótce, FedEx) w Twoim imieniu. Łącznik udostępnia jedną, prostą metodę, aby to zrobić: możesz na przykład mieć przepływ, który reaguje na rejestrację nowego użytkownika, wysyłając im dokumenty marketingowe lub wysyłając klientowi pocztówkę z kuponem 30 dni po wysłaniu zamówienia.
Wymagania wstępne
Aby kontynuować, musisz wykonać następujące czynności:
- Konto mailform z prawidłowym, niezerowym kontem kredytowym (do płacenia za zadania drukowania i poczty). Zarejestruj się bezpłatnie na stronie Mailform
Jak uzyskać poświadczenia
Aby uzyskać poświadczenia:
- Zaloguj się do konta aplikacji Mailform w aplikacji Mailform
- Przejdź do ustawień rozliczeń, odwiedzając stronę Rozliczenia w aplikacji Mailform
- Kliknij przycisk Zakup środków na konto , a następnie kliknij opcję $25.00 , aby dodać minimalną kwotę środków do twojego konta.
- Ukończ proces płatności: spowoduje to utworzenie konta kredytowego i dodanie środków do konta.
- Przejdź do ustawień dostępu do interfejsu API, klikając kartę DOSTĘP do interfejsu API lub odwiedzając stronę Dostęp do interfejsu API programu Mailform
- Kliknij przycisk NOWY TOKEN interfejsu API , a następnie nadaj tokenowi etykietę (na przykład testowanie usługi Power Automate). Podczas testowania możesz włączyć tryb testowy dla tego klucza: wszystkie żądania interfejsu API zostaną zaakceptowane i zweryfikowane, ale nie zostanie wysłana żadna rzeczywista poczta. Zamówienia w trybie testowym zostaną zaakceptowane, a następnie natychmiast anulowane i nie będą mieć wpływu na saldo środków.
- Zostanie wyświetlony nowy token interfejsu API: skopiuj go w dół, ponieważ nie będzie ponownie wyświetlany. Należy pamiętać, że tokeny interfejsu API trybu testowego nigdy nie mogą być wyłączane z trybu testowego: gdy wszystko będzie gotowe do uruchomienia, musisz utworzyć nowy token interfejsu API.
Wprowadzenie do łącznika
Wyświetl ten samouczek w trybie online
Aby zademonstrować użycie aplikacji Mailform, utworzymy przepływ, który wyśle ulotkę z kodem kuponu w dniu moich urodzin. W edytorze usługi Power Automate:
- Utwórz nowy przepływ, klikając przycisk Utwórz.
- Wybierz opcję Zaplanowane przepływ w chmurze.
- Nazwij przepływ i ustaw datę i częstotliwość (w tym przypadku co 12 miesięcy w dniu 27 grudnia 2023 r.).
- Kliknij przycisk Utwórz.
- Kliknij ikonę znaku plus i kliknij pozycję Dodaj akcję.
- W oknie dialogowym wyszukaj pozycję Mailform, a następnie wybierz pozycję Drukuj i wyślij pocztę listową lub pocztówkę przy użyciu akcji Mailform.
- Wypełnij adresy adresata i nadawcy.
- Wypełnij specyfikacje dokumentu i wydruku: najpierw kliknij opcję Parametry zaawansowane, a następnie wybierz adres URL, a następnie wprowadź wartość https://www.mailform.io/samples/sampleflyer.pdf. Następnie kliknij opcję Zaawansowane parametry, a następnie wybierz kolor, a następnie wybierz pozycję Tak.
- Kliknij przycisk Zapisz w górnej części edytora i wszystko jest gotowe. Po uruchomieniu przepływu zamówienie zostanie umieszczone na koncie Mailform skojarzonym z kluczem interfejsu API.
Znane problemy i ograniczenia
- Dowód wydruku musi być mniejszy niż 40 MB: jeśli dokument PDF, który jest wysyłką, wynosi ponad 40 MB, należy go wstępnie przetworzyć, aby zmniejszyć rozmiar pliku.
Typowe błędy i środki zaradcze
N/A
Często zadawane pytania
N/A
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.
To nie jest połączenie, którego można udostępniać. 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 programu Mailform do użycia na potrzeby tego połączenia | Prawda |
Limity ograniczania
| Nazwa | Wywołania | Okres odnowienia |
|---|---|---|
| Wywołania interfejsu API na połączenie | 100 | 60 sekund |
Akcje
| Drukuje i e-maile list lub pocztówkę przy użyciu programu Mailform |
Tworzy nową kolejność formularzy Mailform, podając dowód wydruku, a także szczegóły zamówienia (klasa usługi, kolor/i biały, drukowanie jednostronne/dwustronne i inne) |
| Pobiera istniejące zamówienie |
Pobieranie istniejącego zamówienia utworzonego za pośrednictwem interfejsu API |
| Pobiera uwierzytelniony użytkownik |
Pobieranie informacji o uwierzytelnianym użytkowniku aplikacji Mailform |
Drukuje i e-maile list lub pocztówkę przy użyciu programu Mailform
Tworzy nową kolejność formularzy Mailform, podając dowód wydruku, a także szczegóły zamówienia (klasa usługi, kolor/i biały, drukowanie jednostronne/dwustronne i inne)
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
File
|
file | file |
Dokument PDF do wysłania |
|
|
adres URL
|
url | string |
Adres URL z pliku PDF zostanie pobrany |
|
|
Dokumentacja klienta
|
customer_reference | string |
Opcjonalne odwołanie klienta, które ma zostać dołączone do zamówienia |
|
|
Usługa dostarczania
|
service | True | string |
Usługa dostarczania, która ma być używana. Musi być jedną z określonych wartości |
|
Element webhook powiadomień
|
webhook | string |
Element webhook, który powinien otrzymywać powiadomienia dotyczące aktualizacji zamówienia do tego zamówienia |
|
|
Jednostronne/dwustronne
|
simplex | boolean |
Prawda, jeśli dokument powinien zostać wydrukowany po jednej stronie do arkusza, wartość false, jeśli dokument można wydrukować po obu stronach arkusza |
|
|
Kolor/i biały
|
color | boolean |
Prawda, jeśli dokument powinien być wydrukowany w kolorze, fałsz, jeśli dokument powinien zostać wydrukowany w kolorze czarnym i białym |
|
|
Dołącz płaską kopertę
|
flat | boolean |
Prawda, jeśli dokument musi być pocztą e-mail w płaskiej kopercie, fałsz, jeśli można wysłać dokument złożony |
|
|
Dołącz kopertę powrotną
|
return_envelope | boolean |
Prawda, jeśli dokument musi zostać wypełniony kopertą zwrotną. Nie określaj, czy nie jest wymagana koperta zwrotna |
|
|
Używanie sygnatury rzeczywistej
|
stamp | boolean |
Prawda, jeśli dokument MUSI używać rzeczywistej sygnatury pocztowej, fałsz, jeśli można wysłać dokument przy użyciu taryfowej wysyłki lub odcisku |
|
|
Wiadomość pocztówka
|
message | string |
Wiadomość, która ma zostać wydrukowana po stronie niezwiązanej z obrazem pocztówki. Wymagane, jeśli usługa jest ustawiona na USPS_POSTCARD |
|
|
Nazwa adresata
|
to.name | True | string |
Imię i nazwisko adresata tej koperty lub pocztówki |
|
Firma/organizacja adresata
|
to.organization | string |
Organizacja lub firma adresata |
|
|
Adres odbiorcy
|
to.address1 | True | string |
Numer ulicy i nazwa odbiorcy |
|
Pakiet adresatów/pokój/piętro/numer jednostki
|
to.address2 | string |
Apartament lub numer pokoju odbiorcy |
|
|
Miasto adresata
|
to.city | True | string |
Miasto adresu odbiorcy |
|
Stan/lokalność adresata
|
to.state | True | string |
Stan adresu odbiorcy |
|
Kod pocztowy odbiorcy
|
to.postcode | True | string |
Kod pocztowy lub kod pocztowy odbiorcy |
|
Kraj odbiorcy
|
to.country | string |
Kraj adresu odbiorcy |
|
|
Nazwa nadawcy
|
from.name | True | string |
Nazwa nadawcy |
|
Firma/organizacja nadawcy
|
from.organization | string |
Organizacja lub firma nadawcy |
|
|
Adres ulicy nadawcy
|
from.address1 | True | string |
Numer ulicy i nazwa nadawcy |
|
Apartament nadawcy/pokój/piętro/numer jednostki
|
from.address2 | string |
Apartament lub numer pokoju nadawcy |
|
|
Miasto nadawcy
|
from.city | True | string |
Miasto adresu nadawcy |
|
Stan/lokalizacja nadawcy
|
from.state | True | string |
Stan adresu nadawcy |
|
Kod pocztowy/kod pocztowy nadawcy
|
from.postcode | True | string |
Kod pocztowy nadawcy |
|
Kraj nadawcy
|
from.country | string |
Kraj adresu nadawcy |
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
kod
|
error.code | string |
kod błędu |
|
komunikat
|
error.message | string |
Komunikat o błędzie |
|
details
|
details | string |
inne szczegóły |
|
sukces
|
success | boolean |
wartość true w przypadku powodzenia |
|
id
|
data.id | string | |
|
lineitems
|
data.lineitems | array of object | |
|
id
|
data.lineitems.id | string | |
|
usługa
|
data.lineitems.service | string |
Pobiera istniejące zamówienie
Pobieranie istniejącego zamówienia utworzonego za pośrednictwem interfejsu API
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator zamówienia w formacie poczty
|
id | True | string |
Identyfikator zamówienia aplikacji Mailform |
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
kod
|
error.code | string |
kod błędu |
|
komunikat
|
error.message | string |
Komunikat o błędzie |
|
details
|
details | string |
inne szczegóły |
|
sukces
|
success | boolean |
wartość true w przypadku powodzenia |
|
id
|
data.id | string | |
|
lineitems
|
data.lineitems | array of object | |
|
id
|
data.lineitems.id | string | |
|
usługa
|
data.lineitems.service | string | |
|
tracking_number
|
data.lineitems.tracking_number | string |
Pobiera uwierzytelniony użytkownik
Pobieranie informacji o uwierzytelnianym użytkowniku aplikacji Mailform
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
id
|
id | string | |
|
e-mail
|
string | ||
|
nazwa
|
name | string | |
|
id
|
balance.id | string | |
|
kwota
|
balance.amount | integer | |
|
waluta
|
balance.currency | string |