Krok „Zapytanie HTTP” w Chat Flows

Chat Flow może zadać zewnętrznemu systemowi pytanie przez HTTPS i wykorzystać odpowiedź w rozmowie: sprawdzić zamówienie, zweryfikować saldo, pobrać termin dostawy. Krok nazywa się HTTP request (grupa w palecie Integrate) w edytorze Chat Flows w aplikacji WASync w Bitrix24.

Co robi ten krok

1. Buduje zapytanie na podstawie ustawień kroku: metody (GET lub POST), adresu URL, nagłówków oraz, dla POST, treści zapytania. Wartości {{VARIABLES}} z wcześniejszych kroków oraz z leada lub deala są podstawiane: w adresie URL są kodowane jako URL, w treści JSON są poprzedzane znakami ucieczki JSON.
2. Wysyła zapytanie i czeka na odpowiedź do 10 sekund.
3. Mapuje odpowiedź JSON na zmienne flow za pomocą response mapping: ścieżka JSON (data.order.status, items[0].id) po lewej stronie, nazwa zmiennej (ESTADO) po prawej. Kolejne kroki używają ich jak każdej odpowiedzi: {{ESTADO}} w wiadomości, warunek w kroku Branch, wartość w kroku Fill in a field.

Każde wywołanie ustawia również trzy zmienne:

Dwie krawędzie wyjściowe

Węzeł ma zwykłą krawędź (powodzenie) oraz czerwoną krawędź error. Krawędź błędu jest wybierana, gdy upłynie limit czasu wywołania, adres URL zostanie odrzucony, system odpowie kodem 4xx lub 5xx albo wystąpi awaria sieci. Jeśli krawędź błędu nie jest połączona, flow kontynuuje po zwykłej krawędzi z HTTP_OK = false, więc krok Branch na HTTP_OK nadal może zareagować.

Skąd wysyłane jest zapytanie

Zapytanie nie jest wysyłane z serwerów WASync. Wykonuje je dedykowany Cloudflare Worker (egress.wasync.app), który nie ma dostępu do wewnętrznych systemów WASync. Z tego wynikają dwie konsekwencje:

• Wywołanie dociera do Państwa systemu z zakresów adresów IP Cloudflare, a nie ze stałego adresu WASync. Jeśli Państwa API dopuszcza tylko adresy z listy, należy zastosować API key lub podpis; nie istnieje adres IP WASync, który można by dodać do listy dozwolonych.
• Wolne lub niedziałające API nigdy nie opóźni ani nie zduplikuje wiadomości WhatsApp: wywołanie odbywa się poza potokiem wiadomości, a flow czeka w tym kroku do otrzymania odpowiedzi lub upływu limitu czasu.

Co krok może wywoływać

Agent użytkownika (user agent) to zawsze WASync-Flows/1.0 (+https://wasync.app).

Sekrety

Oznacz nagłówek jako secret (klucz API, token bearer), a WASync zapisze go w postaci zaszyfrowanej. Nigdy nie jest on ponownie wyświetlany w edytorze, nigdy nie jest eksportowany razem z flow i nigdy nie trafia do logów ani do dziennika audytu. Aby go zmienić, wpisz nową wartość; aby go zachować, zostaw pole puste podczas zapisu.

Przetestuj przed zapisaniem

Test request w panelu kroku wykonuje prawdziwe wywołanie z przykładowymi wartościami zmiennych i pokazuje status, czas odpowiedzi, zmapowane zmienne oraz treść odpowiedzi. Use as sample response zapisuje tę treść w kroku: symulator używa jej zamiast wywoływać system, dzięki czemu cały flow można obejrzeć w podglądzie offline.

Przykład: status zamówienia

• Question: "¿Cuál es tu número de pedido?" (zapisane jako PEDIDO)
• HTTP request: GET https://erp.example.com/api/orders/{{PEDIDO}}, nagłówek X-Api-Key (secret), mapowanie data.status → ESTADO, data.eta → ENTREGA
• Branch na HTTP_OK: true → Message Tu pedido está {{ESTADO}}, llega el {{ENTREGA}}. · false → Message No pude consultar tu pedido ahora, un asesor te escribe en breve. → Hand to a person

Czego nie ma w tej wersji

PUT, PATCH i DELETE; OAuth w kierunku systemu zewnętrznego; automatyczne ponowienia; pobieranie plików; oczekiwanie na callback z systemu. W takich przypadkach należy użyć rozwiązania siostrzanego: flow zapisuje pole CRM, reguła automatyzacji Bitrix24 powiadamia Państwa system, system zapisuje wynik z powrotem przez Bitrix24 REST API, a reguła WASync: Send WhatsApp Message go wysyła.

Każde wywołanie jest zapisywane w dzienniku audytu workspace (host i ścieżka, status, czas trwania, które zmienne zostały ustawione; nigdy treść ani nagłówki).