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.
Czym są integracje?
Integracje łączą Twoich agentów AI z zewnętrznymi usługami — dzięki czemu mogą odbierać połączenia telefoniczne, odpowiadać w komunikatorach, wysyłać e-maile, tworzyć dokumenty i pobierać dane analityczne. Każda integracja daje agentowi zestaw narzędzi, które może wywoływać podczas rozmów.Dostępne integracje
Telefonia
Twilio, Ringostat, Binotel — połączenia telefoniczne i SMS obsługiwane przez AI
Komunikatory
Telegram, WhatsApp, Instagram DM, Facebook Messenger
Google Workspace
Gmail, Docs, Sheets, Drive, Calendar, Meet
Kampanie reklamowe
Google Ads, Facebook Ads — analityka i zarządzanie kampaniami
Własny Webhook
Wysyłaj dane o leadach do dowolnego CRM lub zewnętrznego systemu
Jak to działa
Każda integracja działa według tego samego schematu:Połącz
Dodaj integrację ze strony Integracje. W zależności od dostawcy, wprowadzasz dane uwierzytelniające API (VoIP, Telegram) lub przechodzisz przez OAuth (Google, Meta).
Zweryfikuj
Revol testuje Twoje dane uwierzytelniające w API dostawcy i pobiera dostępne zasoby (numery telefonów, informacje o bocie, połączone konta).
Udostępnij narzędzia
Po weryfikacji Revol automatycznie tworzy narzędzia agenta na podstawie typu integracji. Na przykład połączenie z Gmail daje agentom narzędzia
send_email, read_inbox, search_emails i inne.Metody uwierzytelniania
| Metoda | Używana przez | Jak działa |
|---|---|---|
| API Key / Token | Twilio, Ringostat, Binotel, Telegram | Wprowadź dane uwierzytelniające w kreatorze. Przechowywane zaszyfrowane w bazie danych. |
| Google OAuth 2.0 | Gmail, Docs, Sheets, Drive, Calendar, Meet, Google Ads | Kliknij „Połącz z Google”, autoryzuj na ekranie zgody. Revol przechowuje refresh token i automatycznie odświeża tokeny dostępu. |
| Meta OAuth | WhatsApp, Instagram, Facebook Messenger, Facebook Ads | Kliknij „Połącz z Meta”, autoryzuj przez Meta. Revol wymienia kod na długoterminowy token (~60 dni). |
| Webhook URL | Własny Webhook | Bez uwierzytelniania — podajesz docelowy URL i opcjonalne nagłówki. |
Kanały
Kanał to połączenie między integracją a konkretnym agentem AI. Jedna integracja (np. Twoje konto Twilio) może obsługiwać wielu agentów przez oddzielne kanały. Dostępne typy kanałów:| Kanał | Wymaga integracji | Opis |
|---|---|---|
| Widget webowy | Nie | Wbudowany widget czatu na Twoją stronę internetową |
| Telefon | Integracja VoIP | Przychodzące/wychodzące połączenia głosowe i SMS |
| Telegram | Integracja Telegram | Wiadomości bota w Telegram |
| Integracja WhatsApp | Wiadomości WhatsApp Business | |
| Integracja Instagram | Wiadomości bezpośrednie Instagram |
Bezpieczeństwo webhooków
Wszystkie przychodzące endpointy webhooków (połączenia VoIP, wiadomości z komunikatorów) są chronione przez:- Walidacja podpisu — kryptograficzna weryfikacja autentyczności żądania dla każdego dostawcy
- Idempotentność — wykrywanie duplikatów webhooków, aby zapobiec podwójnemu przetwarzaniu
- Ograniczanie częstotliwości — 120 żądań na minutę na kanał
- Lista dozwolonych IP — tam, gdzie dostawca to obsługuje (np. Binotel)
Wszystkie integracje
| Integracja | Kategoria | Autoryzacja | Narzędzia |
|---|---|---|---|
| Twilio | Telefonia | API Key | 3 narzędzia — połączenia, SMS, historia połączeń |
| Ringostat | Telefonia | API Key | 2 narzędzia — połączenia, historia połączeń |
| Binotel | Telefonia | API Key | 2 narzędzia — połączenia, historia połączeń |
| Telegram | Komunikator | Bot Token | 6 narzędzi — wiadomości, pliki, historia, edycja, usuwanie |
| WhatsApp Business | Komunikator | Meta OAuth | 6 narzędzi — wiadomości, szablony, multimedia, historia |
| Instagram DM | Komunikator | Meta OAuth | 6 narzędzi — wiadomości, multimedia, historia, komentarze |
| Facebook Messenger | Komunikator | Meta OAuth | 6 narzędzi — wiadomości, szablony, multimedia, przyciski |
| Gmail | Produktywność | Google OAuth | 6 narzędzi — wysyłanie, czytanie, wyszukiwanie, odpowiadanie, szkice |
| Google Docs | Produktywność | Google OAuth | 5 narzędzi — tworzenie, czytanie, dopisywanie, wyszukiwanie, eksport |
| Google Sheets | Produktywność | Google OAuth | 7 narzędzi — czytanie, pisanie, dopisywanie, wyszukiwanie, tworzenie |
| Google Drive | Produktywność | Google OAuth | 8 narzędzi — lista, wyszukiwanie, przesyłanie, udostępnianie, foldery |
| Google Calendar | Produktywność | Google OAuth | 6 narzędzi — wydarzenia, dostępność, wolne terminy |
| Google Meet | Produktywność | Google OAuth | 1 narzędzie — tworzenie linku do spotkania |
| Google Ads | Reklama | Google OAuth | 3 narzędzia — kampanie, słowa kluczowe, wstrzymanie |
| Facebook Ads | Reklama | Meta OAuth | 4 narzędzia — kampanie, zestawy reklam, statystyki, wstrzymanie |
| Własny Webhook | CRM | URL | 2 narzędzia — wysyłanie danych, test połączenia |
Następne kroki
Konfiguracja VoIP
Połącz Twilio, Ringostat lub Binotel dla połączeń telefonicznych AI
Konfiguracja komunikatorów
Połącz Telegram, WhatsApp, Instagram lub Facebook
Google Workspace
Połącz Gmail, Docs, Sheets, Drive, Calendar, Meet
Reklama
Połącz Google Ads lub Facebook Ads