
Wybór API faksu jest prosty, jeśli potrzebny jest tylko jeden udany test. Trudne pytania pojawiają się po wdrożeniu: skąd aplikacja dowie się, że nadszedł faks, i jak odzyska zdarzenie, które jej umknęło. Ten przewodnik porównuje 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 chmurowej przepływy pracy aplikacji, operacje na kontach i numerach, odzyskiwanie webhooków oraz zadania faksowe dla 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 dla przepływów wysyłania i odbierania faksów | 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 lokalnej, hybrydowej lub prywatnej infrastruktury faksowej w chmurze (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 faksowego lub wdrożenia hybrydowego |
| Documo | Chmurowe przepływy faksowe oparte na API i portalu; konfiguracja webhooków na poziomie konta lub numeru faksu | 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 faksu |
| 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 przoduje wśród zespołów stawiających na chmurę; pozostałe rozwiązania lepiej pasują do węższych potrzeb integracyjnych lub wdrożeniowych. Właściwa krótka lista zależy od tego, jak dużą część przepływu pracy chcesz kontrolować, jak aplikacja ma sobie radzić z przerwami oraz czy potrzebna jest usługa w chmurze (cloud), czy API połączone z infrastrukturą faksową, którą sam obsługujesz.
API może obsługiwać wysyłanie faksów, a mimo to słabo nadawać się do produkcyjnego przepływu pracy. Te pytania pomogą ocenić całą integrację:
Wysłanie faksu to tylko jeden krok. Aplikacja działająca dwukierunkowo może też musieć odbierać faksy przychodzące, wyświetlać ich listę, pobierać dokumenty, sprawdzać status transmisji, zarządzać numerami oraz zatrzymywać lub ponawiać zadania. Zanim zaczniesz porównywać liczbę endpointów, rozrysuj cały przepływ pracy, którego potrzebuje Twoja aplikacja – od początku do końca.
Następnie sprawdź, którędy podróżuje sam dokument faksu. Niektóre wywołania zwrotne zawierają przydatne metadane, ale pobranie pliku PDF lub TIFF pozostawiają aplikacji w osobnym wywołaniu API. Takie rozdzielenie może pomóc w kwestii bezpieczeństwa i rozmiaru danych, ale integracja musi zapisać zdarzenie, pobrać dokument i obsłużyć chwilowy błąd pobierania.
„Sandbox” może oznaczać bardzo różne rzeczy. Może zwracać odpowiedzi testowe (mock), akceptować numery testowe, wysyłać prawdziwy faks albo pozwalać na testowanie wyłącznie konfiguracji konta. Zapytaj, które elementy środowiska produkcyjnego obejmuje, czy konto testowe ma te same funkcje i limity oraz jakie dane zachowuje dostawca.
Dostęp do sandboxa API Fax.Plus można uzyskać na prośbę przez formularz kontaktowy API, a konfiguracją zajmuje się zespół. W przypadku innych dostawców zapytaj, czy sandbox wysyła prawdziwe faksy, czy zwraca odpowiedzi testowe.
Jeśli faks odbiorcy jest zajęty, dostawca faksu 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 sposobami odzyskiwania.
Fax.Plus oferuje też ustawienie Auto Resume on Partial Send dla kwalifikujących się wielostronicowych transmisji. Po jego włączeniu kontynuacja może zacząć się od następnej niewysłanej strony, więc odbiorca może otrzymać faks w więcej niż jednej transmisji. To zachowanie związane z dostarczaniem faksu, odrębne od ponowienia webhooka czy replay.
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 faks już się zakończył?”, Twój system otrzymuje wiadomość, gdy dostawca ma aktualizację.
Sprawdź przynajmniej, czy dostawca wysyła zdarzenia o zakończeniu faksu wychodzącego i o faksach przychodzących. Następnie przyjrzyj się ładunkowi (payload) i znaczeniu każdego statusu. Zdarzenie „faks wysłany” może oznaczać, że zadanie faksowe się zakończyło, a nie że zakończyło się powodzeniem. Aplikacja nadal musi sprawdzić rzeczywisty status dostarczenia.
Niektóre przepływy pracy zyskują na zdarzeniach na poziomie stron. Na przykład zespół może zacząć przeglądać przychodzące skierowanie, zanim nadawca prześle wszystkie strony. Fax.Plus dokumentuje zdarzenie odebrania strony przy włączonym Fax Streaming. Dokumentacja zdarzeń Documo również wymienia zdarzenie strony przychodzącej. Sprawdź, jak pobierany jest cały dokument i co się dzieje, gdy zdarzenia stron dotrą przed rekordem ukończonego faksu.
HTTPS chroni połączenie podczas przesyłania danych między serwerami. Podpis daje odbiornikowi dodatkową kontrolę: pozwala sprawdzić, że żądanie zostało podpisane sekretem współdzielonym z dostawcą oraz że treść żądania nie została zmieniona. Fax.Plus dokumentuje podpisy HMAC-SHA256 w obecnym API webhooków, z sekretem przypisanym do endpointu i kontrolą znacznika czasu. Starszy przewodnik po portalu API eFax opisuje opcjonalne uwierzytelnianie HMAC. Retarus obsługuje opcje uwierzytelniania w 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 dzienniki dostarczania webhooków, automatyczne ponowienia, alerty o awariach endpointu oraz samodzielny replay, w tym odtwarzanie zdarzeń z wybranego przedziału czasu. Documo wysyła e-mail po wyczerpaniu zaplanowanych ponowień. Dokumentacja API InterFAX zawiera sposób na ponowne wysłanie wywołania zwrotnego. W przypadku innych dostawców poproś o pokazanie produkcyjnego dziennika i procesu replay oraz wyjaśnij, czy ponowienie jest automatyczne, ręczne, czy jedno i drugie.
Jeśli aplikacja obsługuje wielu klientów, wiele działów lub wiele numerów faksu, zapytaj, jak można rozdzielić endpointy webhooków. Ustawienie przypisania numeru do zespołu w portalu faksowym niekoniecznie jest tym samym co filtrowanie zdarzeń API według numeru faksu.
Fax.Plus obsługuje filtry według zdarzeń i numerów, a jego portal pozwala zarządzać wieloma endpointami, co ułatwia zespołom kierowanie zdarzeń między numerami faksu i procesami. Documo opisuje konfigurację webhooków na poziomie konta i numeru. WestFax opisuje konfigurację wywołań zwrotnych dla poszczególnych linii. Warto też sprawdzić, jak nowe numery dziedziczą ustawienia.
Fax.Plus to API faksu w chmurze (cloud) dla zespołów, które chcą wysyłać i odbierać faksy, zarządzać kontami firmowymi i obsługiwać dostarczanie zdarzeń z poziomu swoich aplikacji. Podpisywanie jest wbudowane w ten sam pakiet: każdy faks z folderu odebranych lub wysłanych można przekazać do Sign.Plus, własnego produktu Alohi do e-podpisów, aby podpisać go samodzielnie lub poprosić o podpisy inne osoby w ramach tego samego konta. Aplikacje mobilne pozwalają podpisać otrzymany faks i od razu odesłać go nadawcy.
Obsługa webhooków obejmuje subskrypcje zdarzeń, kierowanie według numerów, podpisy HMAC przypisane do endpointów, identyfikatory dostaw, katalog zdarzeń, dzienniki dostarczania, automatyczne ponawianie, odtwarzanie (replay) nieudanych zdarzeń lub zdarzeń z wybranego przedziału czasu oraz alerty, gdy endpoint zaczyna zawodzić. Dzięki filtrom numerów każdy endpoint otrzymuje zdarzenia tylko dla wymienionych w nim numerów faksu, więc platforma obsługująca kilku klientów może przydzielić numerom każdego z nich osobny endpoint i osobny sekret. Fax Streaming dodaje powiadomienia o przychodzących stronach. Zespoły mogą sprawdzać próby dostarczenia w portalu i odtwarzać zdarzenia, gdy miejsce docelowe jest gotowe, co ułatwia analizę pominiętego powiadomienia oraz kierowanie zdarzeń między wieloma numerami faksu. Obecne API działa równolegle ze starszym API webhooków na czas migracji; szczegóły wdrożenia znajdziesz w dokumentacji webhooków.
Poza obsługą faksów REST API umożliwia administrowanie kontem: członkami firmy, rolami i limitami faksów, zaproszeniami, zakupem i przypisywaniem numerów faksu oraz kontaktami i grupami, a wszystko to przez endpointy z zakresem uprawnień w API Enterprise. Zobacz opisy: konta, zarządzanie numerami i zakup numerów.
Fax.Plus publikuje też informacje o dostępności platformy na swojej stronie statusu, gdzie zespoły mogą sprawdzać aktualności dotyczące usługi.
Pod kątem wysyłki i skali API obsługuje jednego lub wielu odbiorców w jednym żądaniu wysyłki oraz konfigurowalną liczbę ponowień transmisji faksu i opóźnienie między nimi, jak pokazano w przykładzie wysyłania faksu. Fax.Plus oferuje też ustawienie Auto Resume on Partial Send dla kwalifikujących się faksów wielostronicowych, o ile ta funkcja jest włączona. Fax.Plus publikuje limity stron, plików i równoczesnych transmisji dla poszczególnych planów w szczegółach cennika, a dla większego wolumenu dostępne są opcje Enterprise. Rekordy statusu faksów 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 faksów, Fax.Plus wysyła zdarzenie w chwili odebrania każdej strony przychodzącego faksu, a ta strona jest od razu dostępna przez API jako jednostronicowy plik. Systemy przyjmowania zgłoszeń mogą sklasyfikować lub przekierować pakiet ze skierowaniem już na podstawie pierwszej strony, gdy reszta dopiero nadchodzi, zamiast czekać na cały dokument. Strumieniowanie jest włączane na żądanie dla całego konta i działa na kontach HIPAA, gdzie zdarzenie zawiera dane faksu, 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 faksów, sprawdzanie dokumentów przychodzących, śledzenie dostarczenia i zarządzanie kontaktami za pomocą żądań w języku naturalnym. Jeden endpoint działa z obsługiwanymi klientami MCP, dzięki czemu zespoły mogą udostępnić akcje faksowe w procesach opartych na SI bez utrzymywania osobnego konektora dla każdego asystenta. OAuth jest dostępny w płatnych planach Fax.Plus; Enterprise obsługuje też Personal Access Tokens z konfigurowalnymi zakresami. MCP warto stosować do zadań faksowych prowadzonych przez asystenta, a REST API do procesów kontrolowanych przez aplikację, takich jak konfiguracja webhooków, przydzielanie numerów i administrowanie członkami firmy. Dowiedz się więcej o serwerze MCP Fax.Plus i jego dokumentacji dla programistów.
REST API i webhooki są dostępne w planie Enterprise, a MCP w planach płatnych, począwszy od Basic. Dowiedz się więcej o Fax.Plus Enterprise i jego procesie faksowania zgodnym z HIPAA.
Najlepsze dla: zespołów stawiających na chmurę (cloud), które potrzebują automatyzacji przez REST API, możliwości odzyskiwania w obsłudze webhooków oraz bezpośredniego sposobu łączenia akcji faksowych z asystentami SI.
eFax Enterprise łączy REST API faksu w chmurze (cloud) z przydzielaniem kont i numerów. Jego publiczna strona API opisuje OAuth 2.0, wysyłanie i odbieranie, pobieranie obrazów faksów i metadanych, webhooki oraz prywatny portal programisty z sandboxem. Fax.Plus również udostępnia administrowanie członkami i numerami przez REST API; eFax może pasować organizacjom, które już korzystają z eFax Corporate i wolą jego model prywatnego portalu programisty.
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ądzanego faksu w chmurze (cloud) z faksowaniem przez API, administrowaniem kontami i przydzielaniem numerów.
iFax publikuje opis REST API obejmujący wysyłanie faksów, odebrane faksy, sprawdzanie statusu, pobieranie dokumentów i operacje na numerach. Korzysta z klucza API konta i odpowiedzi w formacie JSON. Dokumentacja opisuje też działanie webhooków: globalne adresy URL dla faksów wysłanych i odebranych, powiadomienia postflight po zakończeniu faksu oraz do pięciu ponowień z opublikowanym harmonogramem wydłużania odstępów.
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 faksu i wymiany dokumentów, w tym API przyjmujące dokumenty przychodzące i zwracające przetworzone pliki przez HTTP push lub pull. Niektóre zasoby dla programistów wymagają zalogowania do portalu, a materiały publiczne obejmują różne obszary dokumentacji i generacje API. Zanim porównasz szczegóły endpointów, ustal, którego produktu Concord, której wersji API i którego wdrożenia chcesz użyć.
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 faks jest elementem większego programu.
InterFAX publikuje dokumentację REST dla wychodzących i przychodzących operacji faksowych. Dokumentacja obejmuje wysyłanie, pobieranie statusu, obsługę dokumentów przychodzących oraz inne działania związane z zarządzaniem zadaniami. Jej opis API zawiera też 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 do przychodzących i wychodzących procesów faksowych i mogą potwierdzić operacje wywołań zwrotnych u dostawcy.
Portal dla programistów WestFax oferuje bezpłatne dane uwierzytelniające do sandboxa, atrapy REST API odwzorowujące ścieżki żądań i strukturę odpowiedzi środowiska produkcyjnego oraz przykłady, które programiści mogą skopiować. Dzięki sandboxowi zespół może symulować wyniki wywołań zwrotnych bez wysyłania prawdziwego faksu.
Przewodnik szybkiego startu opisuje proces wysyłki 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 dla faksów przychodzących w podobny sposób informują aplikację o nadejściu faksu, po czym pobiera ona metadane i plik PDF. Przewodnik zaleca szybkie zwracanie poprawnej odpowiedzi i przetwarzanie pracy asynchronicznie; zaleca też obsługę idempotentną, ponieważ wolny endpoint może otrzymać to samo wywołanie zwrotne ponownie. Przed wdrożeniem produkcyjnym należy potwierdzić uwierzytelnianie w środowisku produkcyjnym, harmonogram ponowień wywołań zwrotnych, opcje podpisywania oraz możliwość odtwarzania zdarzeń (replay).
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 (on-premises), hybrydowego i w chmurze prywatnej (cloud). Dzięki temu rozwiązanie to jest istotne dla organizacji, które już prowadzą infrastrukturę faksową lub potrzebują kontroli nad tym, gdzie działa serwer faksowy, ale jest to inny rodzaj porównania niż w przypadku hostowanego API w modelu samoobsługowym w chmurze (cloud).
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 faksowego prowadzonym przez klienta lub hybrydowym.
Dokumentacja webhooków Documo opisuje konfigurację na poziomie konta lub numeru faksowego, szeroki zakres zdarzeń faksów przychodzących i wychodzących oraz opcjonalne uwierzytelnianie HTTP Basic. Publikuje harmonogram ponowień obejmujący siedem prób w dłuższym oknie wycofywania (backoff). Jeśli wszystkie próby zawiodą, według dokumentacji wysyłany jest e-mail z danymi o błędzie i webhooku. Opis zdarzeń wskazuje także zdarzenia zakończenia i niepowodzenia żądania webhooka.
Webhook to tylko część procesu obsługi dokumentu. Zdarzenia przychodzące mogą nadchodzić strona po stronie, a aplikacja może pobierać plik faksu przez API. Należy zaplanować osobne przetwarzanie zdarzeń i pobieranie dokumentów oraz potwierdzić, jak w przypadku danego konta działają uprawnienia, przechowywanie i ponowienia. Publiczne źródła Documo zawierają zarówno instrukcje konfiguracji w portalu, jak i opisy API; należy upewnić się, że zespół analizuje dokładnie ten produkt i tę konfigurację API, które są objęte ofertą.
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. Jego operacje oparte na akcjach obejmują kolejkowanie faksu, sprawdzanie statusu jednego lub kilku faksów, pobieranie elementów skrzynki odbiorczej i nadawczej, pobieranie plików faksów oraz zarządzanie zadaniami w kolejce. Dostawca publikuje także klasy klienckie do pobrania oraz przykłady.
W przypadku aktualizacji dla wysyłki SRFax opisuje parametr sNotifyURL, który po zakolejkowaniu zadania wysyła pod wskazany adres URL pola ze statusem faksu. Dokumentacja API podaje, że programiści nadal mogą odpytywać o status (polling), jeśli powiadomienie zostanie pominięte. Takie rozwiązanie łączące wywołanie zwrotne z odpytywaniem jako zapasem działa, ale publiczny przewodnik nie zawiera tak szczegółowych informacji operacyjnych jak nowoczesny portal zdarzeń. Warto zapytać o powiadomienia dla faksów przychodzących, uwierzytelnianie wywołań zwrotnych, ponowienia dostarczania oraz o to, czy dla danego konta dostępny jest dziennik lub ręczne odtwarzanie.
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 działających przede wszystkim w chmurze (cloud), które potrzebują API dla aplikacji, operacyjnych webhooków i drogi do procesów z agentami SI, Fax.Plus jest naszą główną rekomendacją. REST API obsługuje operacje faksowe kontrolowane przez aplikację. Podpisane webhooki z filtrowaniem zapewniają zespołom wgląd w dostarczanie zdarzeń i ich odzyskiwanie. Hostowany serwer MCP łączy zgodnych asystentów z codziennymi zadaniami faksowymi. Razem te możliwości dają zespołom jedną platformę zarówno dla sprawdzonych integracji backendowych, jak i nowszych procesów konwersacyjnych.
Inni dostawcy odpowiadają węższym potrzebom: eFax dla organizacji, które już korzystają z usługi Corporate, oraz RightFax/OpenText dla zespołów potrzebujących infrastruktury faksowej prowadzonej przez klienta lub hybrydowej. Dla zespołów budujących nowoczesny proces faksowy w chmurze (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 oraz MCP, aby wprowadzić faks do procesów wspieranych 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 w jednej platformie faksowej, naszym głównym rekomendowanym wyborem jest Fax.Plus. Jego REST API obsługuje przepływy pracy kontrolowane przez aplikację, jego webhooki zapewniają wgląd w dostarczanie i możliwość odtwarzania zdarzeń (replay), a hostowany serwer MCP udostępnia działania faksowe zgodnym asystentom SI. RightFax/OpenText sprawdzi się lepiej, gdy wymagany jest serwer faksowy obsługiwany przez klienta lub hybrydowy.
Zazwyczaj tak, jeśli tworzona jest niestandardowa integracja. Programista lub partner integracyjny będzie musiał uwierzytelniać żądania, wysyłać i pobierać dokumenty, obsługiwać aktualizacje statusu oraz sprawić, by proces odbioru był odporny na ponowne próby i zduplikowane zdarzenia. Jeśli nie masz zasobów programistycznych, Fax.Plus oferuje opcje no-code: połączenia Zapier dla obsługiwanych przepływów pracy oraz hostowany serwer MCP, który pozwala asystentom SI wysyłać faksy i śledzić ich status bez własnego kodu.
„Zbiorczo” może oznaczać jeden faks wysłany do kilku odbiorców, partię osobnych zleceń faksowych lub pobieranie wielu odebranych dokumentów. Fax.Plus obsługuje wysyłanie do wielu odbiorców w jednym żądaniu, konfigurowalne ponowne próby transmisji faksu oraz przepływy pracy o dużym wolumenie w planie Enterprise. Aplikacje mogą wyświetlać listę rekordów faksów i pobierać dokumenty faksowe przez API. Plany Enterprise obsługują większe wolumeny; 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 można uzyskać na prośbę przez formularz kontaktowy na stronie API Fax.Plus, a nasz zespół go zorganizuje.
RightFax, oferowany przez OpenText jako OpenText Fax, obsługuje wdrożenia lokalne (on-premises), hybrydowe i w chmurze prywatnej (cloud). Jego Web API jest powiązane z tym produktem serwerowym, dlatego w ramach integracji należy uwzględnić wersję serwera, sposób hostingu, licencjonowanie i proces aktualizacji.
Upewnij się, że dany produkt, plan i sposób wdrożenia spełniają wymagania bezpieczeństwa i prywatności Twojej organizacji. Zapytaj, czy dostawca podpisze BAA dla przepływu pracy 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 konkretny przepływ pracy jest odpowiedni. Warunki planów Fax.Plus znajdziesz w poradniku Fax.Plus o faksowaniu zgodnym z HIPAA.
Niektórzy dostawcy dokumentują zdarzenia na poziomie stron. Fax.Plus dokumentuje zdarzenie odebrania strony po włączeniu Fax Streaming, a Documo wymienia zdarzenie strony przychodzącej. Jeśli aplikacja musi zadziałać przed nadejściem ostatniej strony, sprawdź kolejność zdarzeń, sposób pobierania dokumentu oraz zachowanie w przypadku powtórzenia lub opóźnienia zdarzenia strony.
