
Wybór API fax jest łatwy, jeśli potrzebne jest tylko jedno udane wywołanie testowe. Trudne pytania pojawiają się po wdrożeniu: skąd aplikacja wie, że nadszedł fax, i jak odzyskuje pominięte zdarzenie. W tym przewodniku porównujemy dziesięciu dostawców pod względem zakresu API, webhooków, testowania i modelu wdrożenia.
| Dostawca | Model API i dostępu | Model webhooków i powiadomień | Dopasowanie warte sprawdzenia |
|---|---|---|---|
| Fax.Plus | REST API w cloud (Enterprise) z administrowaniem członkami korporacyjnymi, numerami i kontaktami; hostowany serwer MCP dla asystentów SI (plany płatne) | Samodzielne zarządzanie endpointami, podpisane webhooki, katalog zdarzeń, routing według numerów, zdarzenia stron przychodzących fax, logi dostarczania, replay, automatyczne ponowienia oraz alerty o awarii endpointu | Zespoły, które chcą mieć w jednej platformie cloud przepływy pracy aplikacji, operacje na kontach i numerach, odzyskiwanie webhooków oraz zadania fax agentów SI |
| eFax Enterprise | REST API, OAuth 2.0, udostępnianie kont i numerów; prywatny portal dla programistów | Powiadomienia o faxach przychodzących i wychodzących; portal dla programistów zawiera środowisko sandbox. Starsze materiały z portalu opisują opcjonalne uwierzytelnianie HMAC | Organizacje o dużym wolumenie, które oceniają API i sandbox w ramach swojej usługi eFax Corporate |
| iFax | REST/JSON API z kluczem API konta | Globalne adresy URL webhooków dla wysłanych i odebranych faxów; przewodnik po API opisuje do pięciu ponowień ze wzrastającym opóźnieniem | Zespoły, które potrzebują wywołań do wysyłania, odbierania, sprawdzania statusu i zarządzania numerami z użyciem jednego klucza konta |
| Retarus | Regionalne REST API; dokumentacja produktu oferuje również SOAP | Wysyłanie statusu HTTP lub raportu e-mail dla każdego zadania; wysyłanie HTTP obsługuje uwierzytelnianie Basic, Digest lub OAuth 2.0 | Integracje korporacyjne, które wymagają regionalnych endpointów i konfigurowalnego raportowania statusu dostarczenia |
| Concord | Korporacyjne usługi internetowe i API do integracji aplikacji; dostęp do części materiałów wymaga logowania do portalu dla programistów | Publiczne materiały techniczne opisują dostarczanie typu push i pull. Przewodnik po powiadomieniach zaleca odpytywanie (polling) jako rozwiązanie zapasowe, jeśli push jest opóźniony | Organizacje, które oceniają sprawdzony program wymiany dokumentów lub integracji w sektorze ochrony zdrowia |
| InterFAX | REST API do obsługi wychodzących i przychodzących przepływów fax | Dokumentacja API obejmuje wywołania zwrotne ze statusem oraz operację ponownego wysłania wywołania zwrotnego; sprawdź aktualne zachowanie w zakresie ponowień i podpisywania | Programiści szukający bezpośrednich przepływów REST obejmujących operacje przychodzące i wychodzące |
| WestFax | REST API z samoobsługowym sandboxem z odpowiedziami testowymi i przykładami do skopiowania | Wywołania zwrotne sygnalizują zakończone zadania wychodzące i faxy przychodzące. Odbiorca osobno pobiera szczegółowy status lub dokument | Programiści, którzy chcą tworzyć prototypy na odpowiedziach testowych przed założeniem konta |
| RightFax / OpenText Fax | Web API dla infrastruktury fax lokalnej, hybrydowej lub w prywatnym cloud | Bieżąca tabela wersji opisuje właściwości liczby i odstępu ponowień w Web API; publiczne samoobsługowe operacje webhooków nie są opisane | Organizacje, które potrzebują kontroli nad istniejącym środowiskiem serwera fax lub wdrożenia hybrydowego |
| Documo | Przepływy fax w cloud oparte na API i portalu; konfiguracja webhooków na poziomie konta lub numeru fax | Udokumentowano siedem zaplanowanych ponowień, po których wysyłane jest powiadomienie e-mail. Można włączyć uwierzytelnianie Basic | Zespoły, które kierują zdarzenia na poziomie konta lub numeru fax |
| SRFax | API HTTPS POST z użyciem danych logowania do konta; odpowiedzi w formacie JSON lub XML | Udokumentowano wywołania zwrotne ze statusem dla wysyłki wychodzącej, a odpytywanie (polling) jest dostępne jako rozwiązanie zapasowe | Integracje, które mogą korzystać z API opartego na akcjach i wzorca łączącego wywołania zwrotne z odpytywaniem (polling) |
Fax.Plus prowadzi w zestawieniu dla zespołów stawiających na cloud; pozostałe rozwiązania pasują do węższych potrzeb integracyjnych lub wdrożeniowych. Właściwa lista kandydatów zależy od tego, jak dużą część przepływu chcesz kontrolować, jak aplikacja ma sobie radzić z przerwami oraz czy wolisz usługę w cloud, czy API połączone z infrastrukturą fax, którą samodzielnie prowadzisz.
API może obsługiwać wysyłanie faxów i mimo to słabo nadawać się do produkcyjnego przepływu pracy. Skorzystaj z tych pytań, aby ocenić całą integrację:
Wysłanie faxu to tylko jeden krok. Aplikacja działająca dwukierunkowo może też musieć odbierać faxy przychodzące, wyświetlać je na liście, pobierać dokumenty, sprawdzać status transmisji, zarządzać numerami oraz zatrzymywać lub ponownie wysyłać zadania. Zanim zaczniesz porównywać liczbę endpointów, rozrysuj przepływ pracy potrzebny Twojej aplikacji od początku do końca.
Następnie sprawdź, którędy podróżuje sam dokument faxu. Niektóre wywołania zwrotne zawierają przydatne metadane, ale pozostawiają aplikacji pobranie pliku PDF lub TIFF w osobnym wywołaniu API. Takie rozdzielenie może pomóc w kwestii bezpieczeństwa i rozmiaru danych, jednak Twoja integracja musi zapisać zdarzenie, pobrać dokument i obsłużyć tymczasową awarię pobierania.
Pojęcie „sandbox” może oznaczać bardzo różne rzeczy. Środowisko takie może zwracać przykładowe odpowiedzi, akceptować numery testowe, wysyłać prawdziwy fax albo pozwalać na przetestowanie wyłącznie konfiguracji konta. Warto zapytać, które elementy środowiska produkcyjnego są w nim uwzględnione, czy konto testowe ma te same funkcje i limity oraz jakie dane zatrzymuje dostawca.
Dostęp do sandboxa API Fax.Plus jest dostępny na prośbę przesłaną przez formularz kontaktowy API, a jego przygotowaniem zajmuje się zespół. W przypadku innych dostawców warto zapytać, czy sandbox wysyła prawdziwe faxy, czy zwraca przykładowe odpowiedzi.
Jeśli fax odbiorcy jest zajęty, dostawca usługi fax może ponowić transmisję. Jeśli Twój serwer przekroczy limit czasu podczas odbierania powiadomienia o statusie, dostawca może ponowić webhook. To dwie osobne kolejki, z różnymi przyczynami błędów i różnymi działaniami naprawczymi.
Fax.Plus oferuje również ustawienie Auto Resume on Partial Send dla kwalifikujących się wielostronicowych transmisji. Po jego włączeniu kontynuacja może rozpocząć się od następnej niewysłanej strony, więc odbiorca może otrzymać fax w więcej niż jednej transmisji. Jest to zachowanie związane z dostarczaniem faxu, niezależne od ponawiania lub replay webhooka.
Odbiornik webhooków powinien szybko zwracać pomyślną odpowiedź HTTP, zapisywać zdarzenie lub umieszczać je w kolejce i przetwarzać je asynchronicznie. Powinien też tolerować duplikaty. Ponowienie może dostarczyć to samo zdarzenie więcej niż raz, a replay ponownie wysyła zdarzenie, którego Twój system nie przetworzył. W programowaniu bezpieczne obsługiwanie tego samego zdarzenia bez powielania pracy nazywa się idempotentnością.
Webhook to automatyczne żądanie HTTP, które jedna usługa wysyła do Twojej aplikacji, gdy wystąpi zdarzenie. Zamiast wielokrotnie pytać: „Czy ten fax już się zakończył?”, Twój system otrzymuje wiadomość, gdy dostawca ma aktualizację.
Sprawdź przynajmniej, czy dostawca wysyła zdarzenia dotyczące zakończenia wysyłki oraz faxów przychodzących. Następnie przyjrzyj się ładunkowi (payload) i znaczeniu każdego statusu. Zdarzenie „fax wysłany” może oznaczać, że zadanie faxu zostało zakończone, a nie że zakończyło się powodzeniem. Aplikacja nadal musi sprawdzić faktyczny status dostarczenia.
Niektóre procesy zyskują na zdarzeniach na poziomie stron. Na przykład zespół może zacząć przeglądać przychodzący pakiet skierowania, zanim nadawca zakończy transmisję wszystkich stron. Fax.Plus dokumentuje zdarzenie odebrania strony (page-received) po włączeniu Fax Streaming. Dokumentacja zdarzeń Documo również zawiera zdarzenie strony przychodzącej. Upewnij się, jak pobierany jest pełny dokument i co się dzieje, jeśli zdarzenia stron dotrą przed rekordem zakończonego faxu.
HTTPS chroni połączenie, gdy dane przesyłane są między serwerami. Podpis daje Twojemu odbiornikowi dodatkową kontrolę: może on sprawdzić, czy żądanie zostało podpisane sekretem współdzielonym z dostawcą oraz czy treść żądania nie została zmieniona. Fax.Plus dokumentuje podpisy HMAC-SHA256 w swoim obecnym API webhooków, z sekretem właściwym dla danego endpointu i kontrolą znacznika czasu. Starszy przewodnik po portalu API eFax opisuje opcjonalne uwierzytelnianie HMAC. Retarus obsługuje opcje uwierzytelniania w wypychaniu statusów przez HTTP (HTTP status push), w tym Basic, Digest i OAuth 2.0.
W przypadku każdego dostawcy upewnij się, która opcja uwierzytelniania obowiązuje dla dokładnej wersji API i produktu, który kupujesz. Nie traktuj listy dozwolonych adresów IP ani trudnego do odgadnięcia adresu URL jako zamiennika weryfikacji podpisanych wiadomości, jeśli podpisywanie jest dostępne.
Ponowienia pomagają przy tymczasowych awariach, ale nie odpowiadają na wszystkie pytania do wsparcia. Dziennik dostarczania pomaga inżynierowi sprawdzić, czy usługa wysłała zdarzenie, jaką odpowiedź zwrócił Twój endpoint i czy dostawca spróbuje ponownie. Replay pozwala uprawnionej osobie ponownie wysłać pominięte zdarzenie po naprawie odbiornika.
Fax.Plus udostępnia logi dostarczania webhooków, automatyczne ponowienia, alerty o awariach endpointu oraz samodzielny replay, także zdarzeń z wybranego zakresu czasu. Documo wysyła e-mail po wyczerpaniu zaplanowanych ponowień. Dokumentacja API InterFAX zawiera sposób ponownego wysłania wywołania zwrotnego. W przypadku pozostałych dostawców poproś o pokazanie logu produkcyjnego i procesu replay oraz ustal, czy ponowienie jest automatyczne, ręczne, czy jedno i drugie.
Jeśli Twoja aplikacja obsługuje kilku klientów, działy lub numery fax, zapytaj, jak można rozdzielić endpointy webhooków. Ustawienie przypisania numeru do zespołu w portalu fax niekoniecznie jest tym samym co filtrowanie zdarzeń API według numeru fax.
Fax.Plus obsługuje filtry według zdarzenia i numeru, a jego portal pozwala zarządzać wieloma endpointami, co pomaga zespołom kierować zdarzenia między numerami fax i przepływami pracy. Documo opisuje konfigurację webhooków na poziomie konta i numeru. WestFax opisuje konfigurację wywołań zwrotnych dla poszczególnych linii. Sprawdź również, w jaki sposób nowe numery dziedziczą ustawienia.
Fax.Plus to API fax w cloud dla zespołów, które chcą wysyłać i odbierać faxy, zarządzać kontami firmowymi i obsługiwać dostarczanie zdarzeń ze swoich aplikacji. Podpisywanie jest wbudowane w ten sam pakiet: dowolny fax w skrzynce odbiorczej lub folderze wysłanych można przekazać do Sign.Plus, własnego produktu Alohi do podpisów elektronicznych, aby podpisać go samodzielnie lub poprosić o podpisy inne osoby w ramach tego samego konta, a aplikacje mobilne pozwalają podpisać otrzymany fax i od razu odesłać go z powrotem.
Obsługa webhooków obejmuje subskrypcje zdarzeń, routing według numerów, podpisy HMAC specyficzne dla endpointu, identyfikatory dostarczenia, katalog zdarzeń, logi dostarczania, automatyczne ponowienia, replay dla nieudanych zdarzeń lub wybranego zakresu czasu oraz alerty, gdy endpoint zaczyna zawodzić. Dzięki filtrom numerów każdy endpoint otrzymuje zdarzenia tylko dla wymienionych w nim numerów fax, więc platforma obsługująca wielu klientów może przypisać numerom każdego klienta osobny endpoint i sekret. Fax Streaming dodaje powiadomienia o przychodzących stronach. Zespoły mogą sprawdzać próby dostarczenia w portalu i korzystać z replay, gdy miejsce docelowe jest gotowe, co ułatwia analizę pominiętego powiadomienia lub kierowanie zdarzeń między wieloma numerami fax. Obecne API działa równolegle ze starszym API webhooków w okresie przejściowym; szczegóły wdrożenia znajdziesz w dokumentacji webhooków.
Oprócz obsługi fax REST API umożliwia administrowanie kontem: członkami korporacyjnymi, rolami i limitami fax, zaproszeniami, zakupem i przypisywaniem numerów fax oraz kontaktami i grupami — wszystko za pomocą endpointów z zakresem uprawnień w API Enterprise. Zobacz materiały referencyjne dotyczące kont, zarządzania numerami i zakupu numerów.
Fax.Plus publikuje również informacje o dostępności platformy na swojej stronie statusu, gdzie zespoły mogą sprawdzać aktualizacje usługi.
Jeśli chodzi o wysyłkę i skalę, API obsługuje jednego lub wielu adresatów w żądaniu wysyłki oraz konfigurowalną liczbę ponowień transmisji fax i opóźnienie między nimi, jak pokazano w przykładzie wysyłania fax. Fax.Plus oferuje też Auto Resume on Partial Send dla kwalifikujących się wielostronicowych fax, gdy funkcja jest włączona. Fax.Plus publikuje limity stron, plików i równoczesnych transmisji dla poszczególnych planów w swoich szczegółach cennika, a dla większego wolumenu dostępne są opcje Enterprise. Rekordy statusu fax i raporty potwierdzeń pomagają uzgadniać wyniki poszczególnych transmisji.
Zespoły, które nie potrzebują niestandardowej integracji z backendem, mogą też korzystać z połączeń aplikacji no-code, takich jak Zapier. To praktyczna alternatywa dla obsługiwanych przepływów pracy.
Gdy włączone jest strumieniowanie fax, Fax.Plus wysyła zdarzenie w chwili odebrania każdej strony przychodzącego fax, a ta strona jest od razu dostępna przez API jako jednostronicowy plik. Systemy przyjęć mogą klasyfikować lub kierować pakiet skierowania na podstawie strony 1, gdy reszta dokumentu jeszcze nadchodzi, zamiast czekać na cały dokument. Strumieniowanie włącza się na żądanie dla całego konta i działa na kontach HIPAA, gdzie zdarzenie zawiera szczegóły fax, a nie treść dokumentu.
Model Context Protocol (MCP) pozwala zgodnym asystentom SI łączyć się z zewnętrznymi narzędziami. Fax.Plus oferuje hostowany serwer MCP, który umożliwia asystentowi wysyłanie fax, sprawdzanie dokumentów przychodzących, śledzenie dostarczenia i zarządzanie kontaktami za pomocą próśb w języku naturalnym. Jeden endpoint działa z obsługiwanymi klientami MCP, dzięki czemu zespoły mogą udostępnić akcje fax w przepływach pracy SI bez utrzymywania osobnego konektora dla każdego asystenta. OAuth jest dostępny w płatnych planach Fax.Plus; Enterprise obsługuje także osobiste tokeny dostępu (Personal Access Tokens) z konfigurowalnymi zakresami. Używaj MCP do zadań fax prowadzonych przez asystenta, a REST API do przepływów kontrolowanych przez aplikację, takich jak konfiguracja webhooków, przydzielanie numerów i administrowanie członkami korporacyjnymi. Dowiedz się więcej o serwerze MCP Fax.Plus i jego dokumentacji dla programistów.
REST API i webhooki są dostępne w Enterprise, a MCP w płatnych planach, począwszy od Basic. Dowiedz się więcej o Fax.Plus Enterprise i jego przepływie pracy fax zgodnym z HIPAA.
Najlepsze dla: zespołów stawiających na cloud, które potrzebują automatyzacji przez REST API, odzyskiwalnych operacji webhooków i bezpośredniego sposobu łączenia akcji fax z asystentami SI.
eFax Enterprise łączy REST API fax w cloud z obsługą kont i przydzielaniem numerów. Jego publiczna strona API opisuje OAuth 2.0, wysyłanie i odbieranie, pobieranie obrazów fax i metadanych, webhooki oraz prywatny portal dla programistów z sandboxem. Fax.Plus również udostępnia administrowanie członkami i numerami przez swoje REST API; eFax może pasować organizacjom, które już korzystają z eFax Corporate i preferują model prywatnego portalu dla programistów.
Strona API opisuje bezpieczne powiadomienia przychodzące i wychodzące. Przewodnik szybkiego startu w portalu wyjaśnia też odbieranie fax za pomocą wysyłanego adresu URL i informuje, że można wymagać uwierzytelniania HMAC. Ponieważ ten przewodnik jest starszy niż obecna strona marketingowa, warto zapytać eFax, które funkcje podpisywania, sandboxa, zdarzeń i logów dostarczania są dostępne w środowisku API objętym wyceną. Portal jest prywatny, więc programista może potrzebować konta lub kontaktu z działem sprzedaży, aby zobaczyć pełną dokumentację.
Najlepsze dla: większych organizacji szukających zarządzanej usługi fax w cloud z faxowaniem przez API, administracją kontami i udostępnianiem numerów.
iFax publikuje dokumentację REST API obejmującą wysyłanie faxów, odebrane faxy, sprawdzanie statusu, pobieranie dokumentów i operacje na numerach. Korzysta z klucza API konta i odpowiedzi JSON. Dokumentacja opisuje również działanie webhooków: globalne adresy URL dla wysłanych i odebranych faxów, powiadomienia postflight po zakończeniu faxu oraz maksymalnie pięć ponowień z opublikowanym harmonogramem opóźnień.
Globalne adresy URL zdarzeń sprawdzą się w prostej konfiguracji obejmującej całe konto. Zespoły, które potrzebują podpisanych żądań, replay lub narzędzi do historii dostarczania, powinny zapytać iFax, jak te mechanizmy pasują do ich konta i integracji.
Najlepsze dla: programistów, którzy chcą integracji REST z kluczem API i adresami URL webhooków obejmującymi całe konto.
Retarus oferuje regionalne REST API do faxowania z poziomu aplikacji, obok innych opcji integracji dla przedsiębiorstw. Jego podręcznik opisuje raporty statusu, które można odpytywać (polling) lub wysyłać na endpoint klienta. Adres URL HTTP do przesyłania statusów można ustawić dla pojedynczego zadania albo skonfigurować domyślny adres konta. Udokumentowane metody uwierzytelniania to Basic, Digest i OAuth 2.0. Raporty statusu pozostają dostępne do pobrania przez maksymalnie 30 dni lub do ręcznego usunięcia.
Pasuje to do organizacji, które potrzebują regionalnych endpointów, przechowywania raportów i uwierzytelniania skonfigurowanego w ramach zarządzanej usługi. Retarus prosi programistów o kontakt w sprawie konta testowego. Jego publiczny podręcznik nie opisuje mechanizmu replay webhooków ani panelu zdarzeń z podziałem na pojedyncze zdarzenia, więc warto zapytać, jak w ocenianej usłudze monitorowane są awarie endpointów i jak przywracane jest działanie po ich wystąpieniu.
Najlepsze dla: zespołów korporacyjnych, które chcą regionalnych opcji usługi i konfigurowalnego dostarczania statusów w ramach integracji prowadzonej przez dostawcę.
Materiały dla programistów Concord obejmują integracje fax i wymiany dokumentów, w tym API, które przyjmują dokumenty przychodzące i zwracają przetworzone pliki przez HTTP push lub pull. Niektóre zasoby dla programistów wymagają logowania do portalu, a materiały publiczne obejmują różne obszary dokumentacji i generacje API. Przed porównywaniem szczegółów endpointów upewnij się, którego produktu Concord, której wersji API i jakiego wdrożenia będziesz używać.
Jeden z publicznych przewodników po powiadomieniach wychodzących zaleca wdrożenie sprawdzania statusu metodą pull jako rozwiązania zapasowego dla push. Zaznacza, że push może zostać opóźniony o kilka minut lub przez niedostępność serwera docelowego. Zaplanuj ścieżkę uzgadniania danych, zamiast zakładać, że każde powiadomienie dotrze dokładnie wtedy, gdy oczekuje tego aplikacja. Zapytaj Concord o aktualne informacje dotyczące uwierzytelniania webhooków, ponowień, replay i logów dostarczania dla konkretnej rozważanej usługi.
Najlepsze dla: organizacji oceniających szersze możliwości Concord w zakresie wymiany dokumentów i integracji korporacyjnych, zwłaszcza gdy fax jest częścią większego programu.
InterFAX publikuje dokumentację REST dla wychodzących i przychodzących operacji fax. Dokumentacja obejmuje wysyłanie, pobieranie statusu, pracę z dokumentami przychodzącymi i inne czynności związane z zarządzaniem zadaniami. Jego dokumentacja API zawiera także operację ponownego wysłania wywołania zwrotnego, dzięki czemu programiści mają udokumentowany sposób na ponowne zażądanie wywołania zwrotnego.
Zanim zaczniesz na tym budować, ustal, jakie zdarzenia wywołania zwrotnego obejmuje ta operacja, czy nieudane dostarczenia są ponawiane automatycznie i jak zespół może sprawdzić wcześniejsze próby. Zespoły wymagające podpisanych wywołań zwrotnych, filtrowania i replay w portalu powinny potwierdzić, jak te mechanizmy działają w usłudze InterFAX, z której planują korzystać.
Najlepsze dla: programistów, którzy chcą bezpośredniego REST API dla przychodzących i wychodzących przepływów fax i mogą potwierdzić u dostawcy operacje wywołania zwrotnego.
Portal dla programistów WestFax oferuje bezpłatne dane uwierzytelniające do sandboxa, atrapy REST API zgodne ze ścieżkami żądań i strukturą odpowiedzi produkcyjnych oraz przykłady, które można kopiować. Sandbox pozwala zespołowi symulować wyniki wywołań zwrotnych bez wysyłania prawdziwego faxu.
Przewodnik szybkiego startu wyjaśnia przepływ wychodzący w dwóch częściach: WestFax wywołuje adres URL po zakończeniu zadania, a następnie aplikacja pobiera szczegółowy status dla każdego odbiorcy kolejnym wywołaniem API. Wywołania zwrotne przychodzące podobnie informują aplikację o nadejściu faxu, po czym pobiera ona metadane i plik PDF. Przewodnik zaleca szybkie zwracanie odpowiedzi o powodzeniu i przetwarzanie zadań asynchronicznie; zaleca też obsługę idempotentną, ponieważ wolny endpoint może otrzymać wywołanie zwrotne ponownie. Przed uruchomieniem produkcyjnym potwierdź uwierzytelnianie w środowisku produkcyjnym, harmonogram ponowień wywołań zwrotnych, opcje podpisywania i replay zdarzeń.
Najlepsze dla: programistów, którzy chcą budować i testować logikę API w środowisku z atrapami, zanim otrzymają dostęp produkcyjny.
RightFax jest obecnie oferowany przez OpenText jako OpenText Fax. OpenText opisuje opcje wdrożenia lokalnego, hybrydowego i w prywatnym cloud. Czyni to produkt istotnym dla organizacji, które już obsługują infrastrukturę fax lub potrzebują kontroli nad tym, gdzie działa serwer fax, ale jest to inne porównanie niż w przypadku hostowanego API w cloud z samodzielną obsługą.
Tabela porównania wersji OpenText dokumentuje ulepszenia Web API, w tym konfigurowalne właściwości liczby i odstępu ponowień. Wcześniejsza dokumentacja produktu opisuje operacje API do wysyłania, odbierania, sprawdzania statusu, routingu, przekazywania, ponawiania i anulowania faxów. Szczegółowe dokumentacje API są często powiązane z wersją serwera i dostępem klienta, więc potwierdź z OpenText lub jego partnerem wdrożeniowym obsługiwaną wersję, licencjonowanie, odpowiedzialność za hosting i ścieżkę aktualizacji.
Najlepsze dla: organizacji, które potrzebują API połączonego ze środowiskiem serwera fax zarządzanego przez klienta lub hybrydowego.
Dokumentacja webhooków Documo opisuje konfigurację na poziomie konta lub numeru fax, szeroki zakres zdarzeń faxów przychodzących i wychodzących oraz opcjonalne uwierzytelnianie HTTP Basic. Dostawca publikuje harmonogram ponowień obejmujący siedem prób w dłuższym oknie wycofania (backoff). Jeśli wszystkie próby się nie powiodą, według dokumentacji wysyłana jest wiadomość e-mail z danymi błędu i webhooka. Opis zdarzeń wskazuje także zdarzenia ukończenia i niepowodzenia żądania webhooka.
Webhook to tylko część przepływu dokumentu. Zdarzenia przychodzące mogą docierać strona po stronie, a aplikacja może pobrać plik faxu przez API. Zaplanuj osobną obsługę zdarzeń i pobieranie dokumentów oraz sprawdź, jak dla Twojego konta działają uprawnienia, retencja i ponowienia. Publiczne źródła Documo zawierają zarówno instrukcje konfiguracji w portalu, jak i dokumentację API; upewnij się, że zespół analizuje dokładnie ten produkt i tę konfigurację API, które zawiera oferta.
Najlepsze dla: zespołów, które chcą kierować webhooki na poziomie numeru, z osobnym krokiem API do pobierania dokumentów.
Przewodnik dla programistów SRFax opisuje API oparte na HTTPS POST z odpowiedziami w formacie JSON lub XML. Operacje oparte na akcjach obejmują umieszczanie faxu w kolejce, sprawdzanie statusu jednego lub wielu faxów, pobieranie elementów skrzynki odbiorczej i nadawczej, pobieranie plików faxów oraz zarządzanie zadaniami w kolejce. Dostawca udostępnia też klasy klienckie i przykłady do pobrania.
W przypadku aktualizacji faxów wychodzących SRFax opisuje parametr sNotifyURL, który po umieszczeniu zadania w kolejce wysyła pod wskazany adres URL pola ze statusem faxu. Dokumentacja API informuje, że w razie pominięcia powiadomienia programiści nadal mogą sprawdzać status metodą polling. Takie rozwiązanie (wywołanie zwrotne z polling jako awaryjnym uzupełnieniem) działa, ale publiczny przewodnik nie zawiera tak szczegółowych informacji operacyjnych jak nowoczesny portal zdarzeń. Zapytaj o powiadomienia o faxach przychodzących, uwierzytelnianie wywołań zwrotnych, ponawianie dostarczania oraz o to, czy dla Twojego konta dostępny jest log lub ręczny replay.
Najlepsze dla: zespołów, którym odpowiada API oparte na akcjach, przykłady kodu do pobrania oraz polling jako rozwiązanie awaryjne dla powiadomień o statusie faxów wychodzących.
Protokół API to tylko część decyzji. Model wdrożenia wpływa na implementację, odpowiedzialność, wsparcie i migrację.
Te kategorie częściowo się pokrywają. Dostawca może oferować więcej niż jedną ścieżkę dostarczania, a zarządzana usługa w cloud nadal wymaga technicznego wdrożenia. Poproś dostawcę o powiązanie konkretnego produktu i wdrożenia z oferty z dokumentacją API, którą analizujesz.
Porównaj dostawców pod kątem najważniejszych kwestii:
Dla zespołów stawiających na cloud, które potrzebują API dla aplikacji, operacyjnych webhooków i drogi do przepływów pracy z agentami SI, Fax.Plus to nasza główna rekomendacja. REST API umożliwia kontrolowanie operacji faxowych z poziomu aplikacji. Podpisane webhooki z filtrowaniem dają zespołom wgląd w dostarczanie zdarzeń i ich odzyskiwanie. Hostowany serwer MCP łączy zgodnych asystentów z codziennymi zadaniami związanymi z faxem. Razem te możliwości dają zespołom jedną platformę dla sprawdzonych integracji backendowych i nowszych przepływów konwersacyjnych.
Pozostali dostawcy odpowiadają na węższe potrzeby: eFax – organizacjom, które korzystają już z usługi Corporate, a RightFax/OpenText – zespołom potrzebującym infrastruktury fax zarządzanej przez klienta lub hybrydowej. Dla zespołów budujących nowoczesny przepływ pracy z faxem w cloud, obejmujący API, administrowanie kontem i numerami, webhooki oraz asystentów SI, Fax.Plus jest najlepszym ogólnym wyborem w tym porównaniu. Użyj API Fax.Plus do integracji aplikacji i MCP, aby wprowadzić fax do przepływów pracy wspomaganych przez SI.
Dla organizacji działających w modelu cloud-first, które chcą mieć automatyzację przez API, obsługę webhooków i dostęp dla agentów SI na jednej platformie fax, Fax.Plus jest naszą najwyższą rekomendacją. Jego REST API obsługuje procesy kontrolowane przez aplikację, webhooki zapewniają wgląd w dostarczanie i replay, a hostowany serwer MCP udostępnia akcje fax zgodnym asystentom SI. RightFax/OpenText lepiej sprawdza się, gdy wymagany jest serwer fax obsługiwany przez klienta lub hybrydowy.
Zazwyczaj tak, jeśli budujesz niestandardową integrację. Programista lub partner integracyjny będzie musiał uwierzytelniać żądania, wysyłać i pobierać dokumenty, obsługiwać aktualizacje statusu oraz zadbać o to, by proces odbioru był odporny na ponowienia i zduplikowane zdarzenia. Jeśli nie masz zasobów programistycznych, Fax.Plus oferuje opcje no-code: połączenia Zapier dla obsługiwanych procesów oraz hostowany serwer MCP, który pozwala asystentom SI wysyłać i śledzić faxy bez własnego kodu.
„Masowo” może oznaczać jeden fax wysłany do wielu odbiorców, partię osobnych zadań fax albo pobieranie wielu odebranych dokumentów. Fax.Plus obsługuje wysyłanie do wielu odbiorców w jednym żądaniu, konfigurowalne ponowienia transmisji fax oraz procesy Enterprise o dużej skali. Aplikacje mogą wyświetlać listę rekordów fax i pobierać dokumenty fax przez API. Plany Enterprise obsługują większe obciążenia; limity stron, plików i współbieżności znajdziesz w cenniku.
Tak. Gdy włączona jest funkcja Auto Resume on Partial Send, kwalifikujące się wielostronicowe faxy mogą być kontynuowane od następnej niewysłanej strony. Odbiorca może otrzymać osobne transmisje: oryginalną i kontynuację. Jest to niezależne od ponowień webhooków.
Tak. Dostęp do sandboxa jest dostępny na prośbę za pośrednictwem formularza kontaktowego na stronie API Fax.Plus, a nasz zespół go przygotowuje.
RightFax, oferowany przez OpenText jako OpenText Fax, obsługuje wdrożenia lokalne (on-premises), hybrydowe i w prywatnym cloud. Jego Web API jest powiązane z produktem serwerowym, dlatego w ramach integracji należy uwzględnić wersję serwera, sposób hostingu, licencjonowanie i proces aktualizacji.
Upewnij się, że konkretny produkt, plan i model wdrożenia spełniają wymagania bezpieczeństwa i prywatności Twojej organizacji. Zapytaj, czy dostawca podpisze BAA dla procesu opartego na API, jakie funkcje lub ustawienia są wymagane, gdzie przetwarzane są dokumenty i ładunki webhooków, jak długo przechowywane są rekordy oraz jak audytowany jest dostęp. Sama etykieta zgodności nie przesądza o tym, czy Twój konkretny proces jest odpowiedni. Warunki planów Fax.Plus znajdziesz w przewodniku Fax.Plus o fax zgodnym z HIPAA.
Niektórzy dostawcy dokumentują zdarzenia na poziomie stron. Fax.Plus dokumentuje zdarzenie odebrania strony, gdy włączona jest funkcja Fax Streaming, a Documo wymienia zdarzenie strony przychodzącej. Jeśli Twoja aplikacja musi zadziałać przed nadejściem ostatniej strony, sprawdź sekwencję zdarzeń, ścieżkę pobierania dokumentu oraz zachowanie w przypadku powtórzenia lub opóźnienia zdarzenia strony.
