Documentation Index
Fetch the complete documentation index at: https://revolai.mintlify.app/llms.txt
Use this file to discover all available pages before exploring further.
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
Utwórz bota
Otwórz @BotFather w Telegram, wyślij
/newbot i postępuj zgodnie z instrukcjami. Otrzymasz token bota w formacie 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11.Dodaj integrację
Przejdź do Integracje → Dodaj integrację → wybierz Telegram z kategorii Komunikatory.
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
Konfiguracja Meta Business
Utwórz konto Meta Business i skonfiguruj dostęp do WhatsApp Business API.
OAuth
Kliknij „Połącz z Meta” — zostaniesz przekierowany na ekran zgody Meta. Autoryzuj dostęp do swojego konta WhatsApp Business.
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
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
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:Wiadomość przychodząca
Platforma komunikatora wysyła webhook do Revol z treścią wiadomości i informacjami o nadawcy.
Przekierowanie do agenta
Revol identyfikuje kanał, znajduje przypisanego agenta AI i tworzy lub kontynuuje sesję rozmowy. Ten sam nadawca zawsze trafia do tego samego wątku rozmowy.
Przetwarzanie AI
Wiadomość jest przetwarzana przez workflow agenta — węzły LLM, wyszukiwanie w bazie wiedzy RAG, wywołania narzędzi i warunki.
Używanie narzędzi w węzłach workflow
Narzędzia komunikatorów działają jak każde inne narzędzie agenta:- Połącz integrację i zweryfikuj dane uwierzytelniające
- W zakładce Narzędzia agenta zobaczysz udostępnione narzędzia
- Dodaj narzędzia do węzłów niestandardowych w edytorze workflow
- LLM decyduje, kiedy ich użyć na podstawie kontekstu rozmowy
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) |
Podpis HMAC-SHA256 (nagłówek X-Hub-Signature-256 z app_secret) | |
Podpis HMAC-SHA256 (nagłówek X-Hub-Signature-256 z app_secret) | |
Podpis HMAC-SHA256 (nagłówek X-Hub-Signature-256 z app_secret) |