SALESmanago — jak używać: integracje

API SALESmanago umożliwia wymianę danych między platformą a innymi systemami. Ten artykuł pokazuje, jak podejść do integracji, która ma wspierać newsletter, automatyzację, stronę WordPress lub sklep.
W dokumentacji eksportu danych SALESmanago podaje limit 500 żądań API na minutę. Nie wskazuje tam osobnego limitu dla newsletterów (dokument producenta, wersja 4.0).¹

Czym jest API SALESmanago i do czego służy?

API SALESmanago pozwala zewnętrznemu systemowi przesyłać dane do platformy i odbierać jej odpowiedzi. Przy planowaniu połączenia rozdziel trzy kwestie: dane dostępowe, sposób wysyłania żądań oraz kontrolę odpowiedzi serwera.
Żądanie API v2 zawiera cztery pola związane z uwierzytelnieniem: clientId, apiKey, sha i requestTime. Poszczególne endpointy mogą też wymagać pola owner (dokumentacja ManagoAI).²

Instrukcje ManagoAI dotyczą tego produktu, więc nie przenoś ich parametrów uwierzytelniania na każde połączenie nazwane SALESmanago. Integracja ManagoAI z Make wymaga płatnego konta ManagoAI.³
Cennik producenta podaje podstawową licencję dla 3000 aktywnych kontaktów za 213 € miesięcznie, bez kosztu wdrożenia (opis integracji w Make).⁴

API, wtyczka WordPressa i scenariusz Make to różne sposoby zestawienia połączenia. Od wyboru zależy, gdzie ustawisz dostęp i gdzie później będziesz szukać przyczyny błędu.
Wtyczka Manago AI & Leadoo AI wymaga WordPressa w wersji co najmniej 5.6 (katalog wtyczek WordPress).⁵

Jak uzyskać dane dostępowe i skonfigurować uwierzytelnianie w API SALESmanago?

Konfigurację dostępu zacznij od ustalenia, czy połączenie dotyczy ManagoAI. Dane dostępowe opisane dla tego produktu odnoszą się właśnie do niego. API ManagoAI v3 wymaga jednej danej uwierzytelniającej: klucza API przesyłanego w nagłówku API-KEY (dokumentacja ManagoAI v3).⁶

• Dane ManagoAI to Endpoint, Client ID i API secret. Znajdziesz je w sekcji Integration Center > API.³
• Uwierzytelnianie ustaw według wymagań połączenia, dla którego pobrano dane. Sekretu API nie umieszczaj w kodzie strony widocznym dla odwiedzających.
• Pole Owner w połączeniu ManagoAI z Make wypełnij adresem e-mail konta ManagoAI.³

Po konfiguracji sprawdź, czy dane dostępowe i konto dotyczą tego samego produktu. To podstawa dalszych prób połączenia.

Jak połączyć API SALESmanago ze stroną, sklepem lub innym systemem?

Połączenie API ze stroną lub sklepem wymaga wskazania, skąd będą wychodzić żądania i gdzie pozostaną dane dostępowe. Te decyzje wpływają także na późniejszą diagnostykę.
Wtyczka Manago AI & Leadoo AI wymaga PHP w wersji co najmniej 7.4 (katalog wtyczek WordPress).⁵

• Wtyczka Manago AI dla WordPressa korzysta z biblioteki ManagoAI/PHP-SDK.⁷
• Klucz API V3 we wtyczce Manago AI łączy automatyczny proces dodany do wtyczki.⁷
• Integracja sklepu powinna przesyłać pola potrzebne w wybranym procesie. Przed uznaniem synchronizacji za zakończoną musi też obsłużyć odpowiedź API.

Poprawny dostęp to tylko część pracy. Gotowe połączenie wymaga również kontroli danych przekazywanych między systemami.²

Gdzie znaleźć dokumentację API SALESmanago i opis endpointów?

Opisu endpointów, czyli adresów obsługujących określone żądania, szukaj w dokumentacji wersji API używanej przez integrację. Producent opisuje API v2 i API v3. Przed wyborem endpointu ustal więc, z której wersji korzysta Twoje połączenie (dokumentacja ManagoAI).²

Endpoint czytaj razem z metodą żądania, wymaganymi polami i formatem odpowiedzi. Sama nazwa pola w formularzu integracji nie mówi jeszcze, jakie dane przyjmie żądanie.
Przykład daje endpoint funnel/addContact: dokumentacja API v2 wymienia osiem obowiązkowych pól, w tym funnel, stage i contacts (dokumentacja ManagoAI).²

Jak sprawdzić działanie integracji i rozpoznać błędy odpowiedzi API?

Działanie integracji sprawdzaj w trzech miejscach: w wysłanym żądaniu, odpowiedzi serwera i zapisie w systemie docelowym. Dokumentacja API v3 podaje poniższe statusy odpowiedzi (dokumentacja ManagoAI v3).⁶

• Żądanie testowe musi zawierać dane dostępowe właściwe dla połączonego produktu oraz pola wymagane przez endpoint.
• Status HTTP i treść odpowiedzi pomagają odróżnić problem z dostępem od błędu danych lub samego żądania.
• Mapowanie pól porównaj z przesłanym rekordem. Sprawdzisz w ten sposób, czy dane trafiły we właściwe miejsca.
• Log integracji zachowaj bez sekretu API. Przy ponownym wysyłaniu żądania kontroluj, czy nie powstaje duplikat rekordu.

Sama odpowiedź bez błędu nie wystarcza. Działanie połączenia potwierdza dopiero oczekiwany zapis danych.²

Czym jest SALESmanago i jak obsługuje kontakty przez API?

SALESmanago jest platformą marketing automation do organizowania działań marketingowych na podstawie danych o kontaktach. W połączeniu przez API kontakt ma postać rekordu, którego pola trzeba przyporządkować danym z drugiego systemu.
Endpoint contact/upsert wymaga jednego identyfikatora kontaktu: adresu e-mail albo istniejącego contactId (dokumentacja ManagoAI).²

Obsługa kontaktów przez API zaczyna się od ustalenia, który system przechowuje dane źródłowe. Określ też moment przesyłania zmian. Przed synchronizacją wybierz identyfikator kontaktu, zakres pól i sposób postępowania z ponownym żądaniem.⁸

Lista mailingowa obejmuje kontakty przeznaczone do komunikacji e-mailowej. Segmentacja dzieli je według przyjętych kryteriów. Przez API przekazuj dane potrzebne do planowanej kampanii lub automatyzacji, zgodnie z ustalonym mapowaniem pól.

Czym jest platforma SALESmanago?

SALESmanago należy do systemów marketing automation. Platforma służy do pracy z danymi kontaktowymi i planowania komunikacji, a API wymienia dane z systemem zewnętrznym.
Producent podaje ponad 70 integracji z bramkami SMS. Nie przedstawia tej wartości jako liczby wszystkich gotowych integracji (katalog integracji ManagoAI).⁹

Kampania określa komunikat i odbiorców. Automatyzacja wyznacza regułę uruchomienia działania po spełnieniu warunku. Pracę w SALESmanago zacznij od źródła kontaktów, celu komunikacji i danych potrzebnych do wyboru odbiorców.
Jeśli odbiorca wyraził zgodę na określony cel, możliwą podstawą przetwarzania jego danych jest art. 6 ust. 1 lit. a RODO (EUR-Lex, identyfikator dokumentu %3A32016R0679).¹⁰

Czy SALESmanago odpowiada potrzebom Twojej firmy?

SALESmanago oceniaj w odniesieniu do przepływu danych i sposobu prowadzenia kampanii w firmie. Zespół przygotowujący newsletter ma inne zadania niż firma synchronizująca kontakty ze sklepem i systemem sprzedaży.
Poniższa tabela porządkuje potrzeby w każdym z tych zastosowań.

SALESmanago pasuje do firmy, która potrafi określić źródło kontaktów, reguły komunikacji i odpowiedzialność za synchronizację. Nie będzie trafnym wyborem dla zespołu, który nie zamierza utrzymywać tych procesów.

Opinie o SALESmanago: na co zwrócić uwagę?

Opinie o SALESmanago czytaj przez pryzmat opisanego zastosowania, nie samej oceny autora. Relacja z przygotowania newslettera może być przydatna przy wyborze narzędzia do kampanii e-mailowych. Nie odpowie jednak na pytania o integrację sklepu, jeśli pomija przepływ danych kontaktowych.

Przydatna opinia wskazuje proces, źródło kontaktów, sposób pracy zespołu i napotkane ograniczenie. Porównaj te informacje ze swoim planem kampanii, automatyzacji lub synchronizacji przez API. Liczy się podobieństwo zastosowania.

Integracja SALESmanago z Facebook Lead Ads i Zoho CRM: etapy konfiguracji

SALESmanago można włączyć w przepływ danych z formularza leadowego lub CRM. Trzeba wtedy określić źródło rekordu, pola docelowe i sposób przekazania danych. Lead to kontakt pozyskany przez formularz lub działanie sprzedażowe; przed synchronizacją wybierz informacje, które mają trafić do SALESmanago.

Połączenie SALESmanago z LeadsBridge wymaga 4 pól: Client ID, URL, API Secret i Owner Email.¹¹
Pola te służą do ustawienia dostępu. Mapowanie określa z kolei zawartość przesyłanego rekordu.

Integracja Facebook Lead Ads i Zoho CRM obejmuje odrębne przepływy danych. Każde źródło wymaga więc własnej decyzji o momencie przekazania lub aktualizacji kontaktu. Poniższa tabela pokazuje rolę obu źródeł.

Jak skonfigurować przekazywanie leadów do SALESmanago?

Przekazywanie leadów do SALESmanago ustaw jako przepływ od źródła zgłoszenia do rekordu kontaktu. Po przesłaniu sprawdź dane po obu stronach połączenia.

• Źródło leadu to formularz, z którego pochodzi zgłoszenie, na przykład formularz Facebook Lead Ads.
• Dane połączenia wprowadź w narzędziu pośredniczącym według pól wymaganych przez wybraną integrację.
• Mapowanie pól przyporządkowuje informacje z formularza polom kontaktu. Nie zamieniaj przy tym identyfikatora zgłoszenia z adresem e-mail.
• Przekazanie testowe oceń na podstawie odpowiedzi integracji oraz zawartości kontaktu w systemie docelowym.

W poprawnym przepływie dane zgłoszenia trafiają do właściwych pól kontaktu. Sprawdź to na przesłanym rekordzie.

Jak połączyć Zoho CRM z SALESmanago?

Zoho CRM połącz z SALESmanago po ustaleniu źródła danych, dostępu do systemu docelowego i przypisania pól. Integracja przez LeadsBridge pozwala mapować dane Zoho CRM na pola SALESmanago.¹²

• Rekord źródłowy w Zoho CRM wybierz według procesu, który ma uruchamiać przekazanie danych.
• Pola SALESmanago przypisz do informacji z rekordu Zoho CRM. Uwzględnij przy tym sposób identyfikowania kontaktu.
• Aktualizację kontaktu sprawdź po przesłaniu rekordu, porównując wartości pól w obu systemach.

Połączenie CRM działa poprawnie, gdy przesłany rekord aktualizuje zamierzony kontakt. Przypisanie pól również musi pozostać zgodne z ustalonym mapowaniem.¹³

Z jakimi platformami e-commerce integruje się Manago AI?

Manago AI ma udokumentowaną wtyczkę dla WordPressa, która obsługuje przekazywanie produktów do katalogu. Opis tej wtyczki nie potwierdza jednak integracji z Shopify. Tych dwóch możliwości nie należy utożsamiać.

Wtyczka Manago AI zabezpiecza tworzenie widoku katalogu produktów, gdy brakuje klucza API v3.⁷
Klucz trzeba więc uwzględnić podczas konfiguracji katalogu.

Product API służy tu do pracy z katalogiem produktów. We wtyczce usprawniono rejestrowanie zdarzeń API v3 i dodano możliwość dostosowania katalogu dla Product API.⁷
Produkty można wysyłać przez hook, czyli wywołanie powiązane ze zdarzeniem, albo przez cron lub wp-cron – mechanizmy zadań uruchamianych według harmonogramu.⁷

Katalog produktów wymaga uwagi przy dużej liczbie wariantów. We wtyczce naprawiono wysyłkę produktów mających powyżej 100 wariantów.⁷
Przy wyborze integracji sklepu oddziel udokumentowaną obsługę katalogu we wtyczce WordPressa od połączenia z inną platformą e-commerce.

Ceny i warunki sprawdzone u źródeł: październik 2026.