> ## Documentation Index
> Fetch the complete documentation index at: https://revolai.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# Integracje z komunikatorami
> Połącz Telegram, WhatsApp, Instagram i Facebook Messenger
## Obsługiwane komunikatory
| Komunikator | Metoda autoryzacji | Przychodzące | Wychodzące | Narzędzia |
| ---------------------- | ------------------ | ------------ | ---------- | --------- |
| **Telegram** | Bot Token | Tak | Tak | 6 |
| **WhatsApp Business** | Meta OAuth | Tak | Tak | 6 |
| **Instagram DM** | Meta OAuth | Tak | Tak | 6 |
| **Facebook Messenger** | Meta OAuth | Tak | Tak | 6 |
## Telegram
Telegram to najprostsza integracja — bez OAuth, bez zależności SDK. Wystarczy token bota od BotFather.
### Konfiguracja
Otwórz [@BotFather](https://t.me/BotFather) w Telegram, wyślij `/newbot` i postępuj zgodnie z instrukcjami. Otrzymasz **token bota** w formacie `123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11`.
Przejdź do **Integracje** → **Dodaj integrację** → wybierz **Telegram** z kategorii Komunikatory.
Wybierz firmę, nazwij integrację i wklej token bota.
Revol wywołuje Telegram Bot API, aby zweryfikować token, i automatycznie konfiguruje webhook. Twój bot natychmiast zaczyna odbierać wiadomości.
### Narzędzia agenta
| Narzędzie | Opis |
| ------------------ | --------------------------------------------------------------------------------------------------- |
| `send_message` | Wyślij wiadomość tekstową (formatowanie HTML lub Markdown) z opcjonalnym odpowiadaniem na wiadomość |
| `send_file` | Wyślij zdjęcie, dokument, audio lub wideo przez publiczny URL |
| `get_chat_history` | Pobierz ostatnie wiadomości z czatu |
| `get_chat_info` | Pobierz metadane czatu/użytkownika (nazwa, bio, liczba członków) |
| `edit_message` | Edytuj wcześniej wysłaną wiadomość bota |
| `delete_message` | Usuń wiadomość z czatu |
***
## WhatsApp Business
WhatsApp Business API jest dostępne przez Meta Graph API. Wymaga konta Meta Business z dostępem do WhatsApp Business API.
### Konfiguracja
Utwórz [konto Meta Business](https://business.facebook.com/) i skonfiguruj dostęp do WhatsApp Business API.
Przejdź do **Integracje** → **Dodaj integrację** → wybierz **WhatsApp Business**.
Kliknij „Połącz z Meta" — zostaniesz przekierowany na ekran zgody Meta. Autoryzuj dostęp do swojego konta WhatsApp Business.
Wprowadź swój Phone Number ID i App Secret. Revol wymienia kod OAuth na długoterminowy token (\~60 dni).
WhatsApp ma **24-godzinne okno wiadomości**. Możesz wysyłać dowolne wiadomości tylko w ciągu 24 godzin od ostatniej wiadomości klienta. Poza tym oknem użyj `send_template_message` z wcześniej zatwierdzonymi szablonami.
### Narzędzia agenta
| Narzędzie | Opis |
| ----------------------- | ------------------------------------------------------------- |
| `send_message` | Wyślij wiadomość tekstową w ramach 24-godzinnego okna |
| `send_template_message` | Wyślij wcześniej zatwierdzony szablon (działa poza oknem 24h) |
| `send_media` | Wyślij obraz, dokument, wideo lub audio przez URL |
| `get_message_history` | Pobierz wiadomości z rozmowy |
| `get_contact_info` | Pobierz informacje o profilu kontaktu |
| `mark_as_read` | Wyślij potwierdzenie przeczytania wiadomości |
***
## Instagram DM
Wiadomości bezpośrednie Instagram są dostępne przez Meta Graph API z tym samym przepływem OAuth co WhatsApp.
### Konfiguracja
Twoje konto Instagram Business musi być powiązane ze stroną Facebook.
Przejdź do **Integracje** → **Dodaj integrację** → wybierz **Instagram**.
Kliknij „Połącz z Meta" i autoryzuj dostęp do swojego konta Instagram.
Wprowadź swój App Secret i Verify Token.
### Narzędzia agenta
| Narzędzie | Opis |
| --------------------- | ------------------------------------------------------ |
| `send_message` | Wyślij wiadomość bezpośrednią do użytkownika Instagram |
| `send_media` | Wyślij załącznik multimedialny w DM |
| `get_message_history` | Pobierz wiadomości z wątku DM |
| `get_profile` | Pobierz publiczne informacje o profilu Instagram |
| `get_comments` | Pobierz komentarze do konkretnego postu |
| `reply_to_comment` | Opublikuj odpowiedź w wątku komentarza |
***
## Facebook Messenger
Facebook Messenger łączy się przez Twoją stronę Facebook. Ten sam przepływ Meta OAuth co WhatsApp i Instagram.
### Konfiguracja
Potrzebujesz strony Facebook powiązanej z kontem Meta Business.
Przejdź do **Integracje** → **Dodaj integrację** → wybierz **Facebook Messenger**.
Kliknij „Połącz z Meta" i autoryzuj dostęp do swojej strony.
Wprowadź swój App Secret i Verify Token.
### Narzędzia agenta
| Narzędzie | Opis |
| ----------------------- | ------------------------------------------------------------------ |
| `send_message` | Wyślij wiadomość tekstową do użytkownika Facebook |
| `send_template_message` | Wyślij strukturalny szablon (przyciski, generyczny, potwierdzenie) |
| `send_media` | Wyślij obraz, wideo, audio lub plik |
| `get_message_history` | Pobierz wątek rozmowy |
| `get_profile` | Pobierz profil użytkownika na podstawie ID o zasięgu strony |
| `send_buttons` | Wyślij opcje szybkich odpowiedzi użytkownikowi |
***
## Przepływ wiadomości
Niezależnie od komunikatora, przepływ przetwarzania jest identyczny:
Platforma komunikatora wysyła webhook do Revol z treścią wiadomości i informacjami o nadawcy.
Revol identyfikuje kanał, znajduje przypisanego agenta AI i tworzy lub kontynuuje sesję rozmowy. Ten sam nadawca zawsze trafia do tego samego wątku rozmowy.
Wiadomość jest przetwarzana przez workflow agenta — węzły LLM, wyszukiwanie w bazie wiedzy RAG, wywołania narzędzi i warunki.
Odpowiedź agenta jest wysyłana z powrotem przez API tego samego komunikatora. Użytkownik widzi odpowiedź w swoim czacie.
Wiadomości z komunikatorów są przetwarzane asynchronicznie przez zadanie w tle. Zapewnia to szybką odpowiedź 200 na webhook, zapobiegając przekroczeniom czasu i ponownym próbom ze strony platformy komunikatora.
## Używanie narzędzi w węzłach workflow
Narzędzia komunikatorów działają jak każde inne narzędzie agenta:
1. Połącz integrację i zweryfikuj dane uwierzytelniające
2. W zakładce **Narzędzia** agenta zobaczysz udostępnione narzędzia
3. Dodaj narzędzia do **węzłów niestandardowych** w edytorze workflow
4. LLM decyduje, kiedy ich użyć na podstawie kontekstu rozmowy
**Przykład:** Klient pyta „Wyślij mi broszurę na WhatsApp". Agent używa `send_media`, aby wysłać dokument PDF, a następnie potwierdza dostarczenie na czacie.
## Bezpieczeństwo webhooków
| Komunikator | Walidacja |
| ----------- | ------------------------------------------------------------------ |
| Telegram | Tajny token w URL webhooka (hash SHA-256 tokena bota) |
| WhatsApp | Podpis HMAC-SHA256 (nagłówek `X-Hub-Signature-256` z `app_secret`) |
| Instagram | Podpis HMAC-SHA256 (nagłówek `X-Hub-Signature-256` z `app_secret`) |
| Facebook | Podpis HMAC-SHA256 (nagłówek `X-Hub-Signature-256` z `app_secret`) |
Wszystkie webhooki komunikatorów mają ograniczenie częstotliwości do **120 żądań na minutę** na kanał.