Written by Marek Mrówka

Integracja API Sellizera w Make.com

Zautomatyzuj proces wysyłki ofert w Sellizerze z wykorzystaniem platformy Make.com!

Aby zrealizować integrację, konieczne będzie skorzystanie z API Sellizera. Przed przystąpieniem do połączenia, zalecamy zapoznanie się z artykułem Jak korzystać ze swaggera API Sellizera? oraz dokumentacją API Sellizera.

W artykule przedstawimy dwa przykładowe scenariusze automatyzacji z wykorzystaniem Make.com.

Automatyczne generowanie e-maili z ofertą na podstawie pliku PDF dodanego do dokumentów.
Automatyczne tworzenie ofert w formie linku na podstawie dokumentu PDF umieszczonego na stronie internetowej.

Automatyczne generowanie e-maili z ofertą na podstawie pliku PDF dodanego do dokumentów.

W Make.com wybierz panel "Scenarios", a następnie "Create a new scenario".
Dodaj nowy bloczek "HTTP - Make a request".

Uzupełnij wymagane pola w bloczku HTTP:

1 W polu "URL" wpisz: "https://app.sellizer.io/api/v1.0/offers".

2 Jako "Method" ustaw "POST".

3 W "Headers" dodaj pole "Authorization".
Jeżeli posiadasz wygenerowany w aplikacji stały klucz API, umieść go w polu "Value".
Jeżeli nie posiadasz stałego klucza, wymagane będzie dodanie bloczku do generowania tokenu poprzedzającego aktualnie tworzony bloczek.
Instrukcja znajduje się w drugim scenariuszu "Automatyczne tworzenie ofert w formie linku na podstawie dokumentu PDF umieszczonego na stronie internetowej".

4 Określ "Body type", jako "Multipart/form-data".

5 W sekcji "Fields" dodaj pola typu "Text" i uzupełnij je o wartości:

"formDataFields": [

{ "key": "is_temporary", "value": "false", "fieldType": "text" },

{ "key": "delivery_method", "value": "email", "fieldType": "text" },

{ "key": "delivery_option", "value": "now", "fieldType": "text" }, { "key": "user_reply_to", "value": "twój_adres@email.com", // - w tym miejscu wpisz własny adres e-mail, z którego wysyłasz oferty w Sellizerze "fieldType": "text" },

{ "key": "user_name", "value": "twoje_imię", // - w tym miejscu wpisz swoje imię "fieldType": "text" },

{ "key": "user_phone", "value": "48712137096", // - w tym miejscu wpisz swój numer do powiadomień SMS "fieldType": "text" }, { "key": "name", "value": "api test make", // - nazwa Twojej oferty "fieldType": "text" }, { "key": "mail_content", "value": "test api", // - w tym miejscu wpisz treść maila w formacie .html "fieldType": "text" }, { "key": "language", "value": "pl_PL", // - alternatywnie en_US "fieldType": "text" }, { "key": "is_gdpr_visible", "value": "gdpr_on", "fieldType": "text" }, { "key": "gdpr_variant", "value": "defaultGdpr", // - alternatywnie minimalGdpr "fieldType": "text" },

{ "key": "offer_recipients[0][recipient_email]", "value": "odbiorca_wiadomości@email.com", // - w tym miejscu wpisz adres e-mail pierwszego adresata "fieldType": "text" },

{ "key": "offer_recipients[0][recipient_name]", "value": "imie_odbiorcy", // - w tym miejscu wpisz imię pierwszego adresata "fieldType": "text" },

Jeżeli chcesz dodać więcej odbiorców do oferty, dodaj kolejne numerowane pola. Przykładowo dla drugiego odbiorcy będzie to:

{ "key": "offer_recipients[1][recipient_email]", "value": "odbiorca_wiadomości@email.com", // - w tym miejscu wpisz adres e-mail drugiego adresata "fieldType": "text" },

{ "key": "offer_recipients[1][recipient_name]", "value": "imie_odbiorcy", // - w tym miejscu wpisz imię drugiego adresata "fieldType": "text" },

W opisanym scenariuszu opisane zostało dodawanie pliku PDF spośród plików dostępnych w panelu "Dokumenty" Sellizera.

Pamiętaj, każda oferta tworzona w Sellizerze musi zawierać przynajmniej jeden plik PDF.

Najprostszym sposobem na uzyskanie ID dokumentu będzie skorzystanie ze Swaggera API Sellizera.

W pierwszym kroku wykonaj autoryzację zgodnie z artykułem: Jak korzystać ze swaggera API Sellizera?
Następnie wybierz zapytanie GET/documents Get documents list.
Kliknij "Try it out", a następnie "Execute".

Możesz pominąć uzupełnienie dodatkowych pól zapytania, zostanie wtedy zwrócona lista pierwszych 10 dodanych plików.

Skopiuj wybrane ID dokumentu i umieść w wartości pola "documents[0][id]".{ "key": "documents[0][id]", "value": "ed53a39c-46ea-439e-8d5a-9aa11b36c1be", // - w tym miejscu podaj id dokumentu. "fieldType": "text" }

Jeżeli chcesz dodać więcej dokumentów do oferty, dodaj kolejne numerowane pola. Przykładowo dla drugiego pliku będzie to:

,{ "key": "documents[1][id]", "value": "xxx-xxx-xxx-xxx-xxx", "fieldType": "text" }

],

Wypełnione pola powinny wyglądać następująco:

Wybierz przycisk "Run once" i przetestuj wybraną automatyzację.

Powinien zostać zwrócony kod 201 widoczny poniżej.

Jeśli został zwrócony kod 201:

Sprawdź, czy oferta jest widoczna w panelu "Oferty" po zalogowaniu do Sellizera. Jeżeli oferta nie jest widoczna, zweryfikuj poprawność pól "is_temporary", "delivery_method" oraz "delivery_option"
Oferta mogła zostać utworzona tymczasowo ze statusem "is_temporary" = "true", jeśli jedno z obowiązkowych pól zostało wypełnione niepoprawnie. Oferty utworzone tymczasowo nie są widoczne w panelu, natomiast oferta z tym statusem może zostać załączona w mailu. Utworzenie oferty tymczasowej umożliwia edytowanie oferty przed docelowym utworzeniem i wysyłką do odbiorcy.
Status oferty możesz sprawdzić za pomocą:
- GET/offers/{offerId} Get an single offer
- GET/offers Get offers list
Sprawdź, czy dla odbiorcy wyświetlany jest baner informacyjny RODO oraz są zbierane statystyki, jeżeli nie, sprawdź poprawność pól "is_gdpr_visible" i "gdpr_variant"
Jeżeli jedno z pól dotyczących RODO zostało wypełnione niepoprawnie, statystyki mogą nie być gromadzone.

Jeżeli został zwrócony inny kod, zapoznaj się ze znaczeniami kodów w sekcji POST/offers Add new offer.

Automatyczne tworzenie ofert w formie linku na podstawie dokumentu PDF umieszczonego na stronie internetowej.

W Make.com wybierz panel "Scenarios", a następnie "Create a new scenario".
W wybranym scenariuszu konieczne będzie utworzenie 3 osobnych bloczków HTTP w przedstawionej poniżej konfiguracji.
Stwórz pierwszy bloczek "HTTP - Make a request".
Bloczek zostanie wykorzystany do pobrania tokenu autoryzacji, jeżeli posiadasz stały klucz API możesz ten krok pominąć.
1. 1 W polu "URL" wpisz: "https://app.sellizer.io/api/v1.0/tokens".
1. 2 Jako "Method" ustaw "POST".
1. 3 Określ "Body type", jako "Multipart/form-data".
1. 4 W sekcji "Fields" dodaj pola typu "Text" i uzupełnij je o wartości:
"formDataFields":[
{ "key": "email", "value": "twój_adres@email.com", // - Twój adres e-mail logowania do Sellizera "fieldType": "text" },
{ "key": "password", "value": "twoje_hasło_do_sellizera", // - Twoje hasło logowania do Sellizera "fieldType": "text" }
],
1. 5 Ustaw opcję "Parse response" na "Yes".
Skonfigurowany bloczek powinien wyglądać następująco.
1. 6 Wybierz przycisk "Run once" i przetestuj bloczek. Powinien zostać zwrócony kod 201.
Utwórz drugi bloczek "HTTP - Get a file" do pobierania pliku z wybranej strony internetowej.
W polu "URL" umieść link do strony internetowej z Twoim plikiem PDF.
Pamiętaj, każda oferta tworzona w Sellizerze musi zawierać przynajmniej jeden plik PDF.

Alternatywnie możesz pobrać plik z innego źródła np. Google Drive. Aby, to zrobić:

Dodaj nowy bloczek "Google Drive" typu "Download a File".
Zintegruj Make.com z Dyskiem Google.
Wybierz plik.

Stwórz ostatni bloczek "HTTP - Make a request".
W tym bloczku zostanie stworzona oferta w formie linku poprzez zapytanie do API Sellizera.
1. 1 W polu "URL" wpisz "https://app.sellizer.io/api/v1.0/offers".
1. 2 Jako "Method" ustaw "POST".
1. 3 W "Headers" dodaj pole "Authorization".
1. 4 Kliknij w pole "Value", następnie rozwiń zapytanie "HTTP - Make a request" i kliknij niebieskie pole "token". W polu "Value" powinna pojawić się wartość "4.data.data.token".
Jeżeli posiadasz stały klucz API, możesz wkleić go zamiast wartości "4.data.data.token" i usunąć pierwszy bloczek "HTTP - Make a request"
1. 5 Określ "Body type", jako "Multipart/form-data".
1. 6 W sekcji "Fields" dodaj pola typu "Text" i uzupełnij je następującymi wartościami:

"formDataFields": [

{ "key": "is_temporary", "value": "false", "fieldType": "text" },

{ "key": "delivery_method", "value": "link", "fieldType": "text" },

{ "key": "delivery_option", "value": "now", "fieldType": "text" },

{ "key": "user_name", "value": "twoje_imię", // - w tym miejscu wpisz swoje imię "fieldType": "text" },

{ "key": "user_phone", "value": "48712137096", // - w tym miejscu wpisz swój numer do powiadomień SMS "fieldType": "text" }, { "key": "name", "value": "api test make", // - nazwa Twojej oferty "fieldType": "text" }, { "key": "language", "value": "pl_PL", // - alternatywnie en_US "fieldType": "text" }, { "key": "is_gdpr_visible", "value": "gdpr_on", "fieldType": "text" }, { "key": "gdpr_variant", "value": "defaultGdpr", // - alternatywnie minimalGdpr "fieldType": "text" },