Przejdź do głównej zawartości

Integracja z OpenAPI w SmartFlow

Wprowadzenie

SmartFlow umożliwia integrację zewnętrznych API za pomocą standardu OpenAPI. Ta funkcja oferuje ogromną elastyczność w łączeniu Twoich przepływów pracy z usługami zewnętrznymi, automatyzacji złożonych zadań oraz wzbogacaniu procesów biznesowych.


Dlaczego warto używać OpenAPI w SmartFlow?

  • Interoperacyjność: Połącz SmartFlow z każdym systemem zgodnym z OpenAPI.
  • Zaawansowana automatyzacja: Wykonuj wywołania API, aby wysyłać lub pobierać dane w czasie rzeczywistym.
  • Oszczędność czasu: Importuj kolekcje OpenAPI, aby korzystać z predefiniowanych punktów końcowych bez skomplikowanej konfiguracji.

Zrzut ekranu: [Dołącz zrzut ekranu pokazujący interfejs importowania kolekcji OpenAPI z strony Ustawienia chatbota.]


Dodawanie integracji OpenAPI

1. Importowanie kolekcji OpenAPI

  1. Uzyskaj dostęp do strony ustawień Chatbota: Przejdź do zakładki "Ustawienia" odpowiedniego chatbota.
  2. Importuj plik lub skonfiguruj z interfejsu: Kliknij "Dodaj kolekcję OpenAPI" i wybierz plik JSON lub YAML, lub skonfiguruj punkty końcowe bezpośrednio z interfejsu.
  3. Walidacja: Punkty końcowe są automatycznie sortowane według kolekcji i walidowane.
  4. Zapisz: Po walidacji punkty końcowe stają się dostępne jako akcje typu "API" w SmartFlow.

Zrzut ekranu: [Pokaż interfejs konfiguracji na stronie ustawień Chatbota.]

2. Użyj akcji API w SmartFlow

  1. Dodaj akcję: W swoim workflow SmartFlow przejdź do zakładki Akcje i wybierz "API".
  2. Wybierz punkt końcowy: Punkty końcowe są posortowane według kolekcji i dostępne dla wszystkich typów SmartFlow.
  3. Zdefiniuj parametry: Skonfiguruj wymagane pola dla wywołania (nagłówki, ciało, itp.).
  4. Domyślna obserwacja: Domyślnie każda akcja API zwraca wynik wywołania jako obserwację w trybie "Narzędzie rozmowy", co pozwala AI na automatyczne podjęcie następnej decyzji.

Zrzut ekranu: [Wstaw zrzut ekranu pokazujący punkt końcowy używany jako akcję API w SmartFlow.]

Przykład użycia

Scenariusz: Synchronizacja z zewnętrznym CRM

  1. Cel: Zaktualizować informacje o kliencie w swoim CRM po przesłaniu formularza.
  2. Przepływ pracy:
    • Wyzwalacz: Użytkownik wypełnia formularz za pomocą SmartForm.
    • Akcja API: Wyślij dane formularza do API swojego CRM.
    • Obserwacja: Wynik wywołania jest automatycznie zwracany jako obserwacja w trybie "Conversation Tool".
  3. Korzyści: Oszczędność czasu i redukcja błędów manualnych.

Zrzut ekranu: [Pokaż kompletny przepływ pracy z wywołaniem API powiązanym z CRM.]

Scenariusz: Pobieranie danych użytkownika

  1. Cel: Spersonalizować odpowiedź chatbota na podstawie danych użytkownika.
  2. Przepływ pracy:
    • Wyzwalacz: Żądanie użytkownika w chatbocie.
    • Akcja API: Zapytaj zewnętrzne API, aby uzyskać informacje o użytkowniku.
    • Obserwacja: Użyj zwróconych danych jako obserwacji, aby zdecydować o następnej odpowiedzi chatbota.

Zrzut ekranu: [Ilustruj interakcję między chatbotem a zewnętrznym API.]

Najlepsze praktyki

  • Importuj zweryfikowane kolekcje: Upewnij się, że Twoje pliki OpenAPI są zgodne z normami, aby uniknąć błędów podczas importu.
  • Testuj regularnie: Waliduj swoje wywołania API, aby upewnić się, że działają zgodnie z zamierzeniami.
  • Dokumentuj swoje integracje: Dodaj jasne opisy dla każdego punktu końcowego, aby ułatwić ich zarządzanie.

Dzięki tej integracji, SmartFlow staje się jeszcze potężniejszą platformą do łączenia Twoich narzędzi i automatyzacji procesów. Przejdź do następnej sekcji, aby odkryć Sklep z Szablonami i dzielić się swoimi przepływami pracy!