> ## 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.

# Przegląd integracji

> Połącz agentów AI z kanałami komunikacji, narzędziami produktywności i platformami reklamowymi

<Frame>
  <img className="block dark:hidden" src="https://mintcdn.com/revolai/u4jrzWUP0vGPhn5W/images/integrations-overview-light.png?fit=max&auto=format&n=u4jrzWUP0vGPhn5W&q=85&s=35912161a44233ad59ca5133b741ffab" alt="Przegląd integracji" width="2873" height="1552" data-path="images/integrations-overview-light.png" />

  <img className="hidden dark:block" src="https://mintcdn.com/revolai/u4jrzWUP0vGPhn5W/images/integrations-overview-dark.png?fit=max&auto=format&n=u4jrzWUP0vGPhn5W&q=85&s=db09aa52b3c494d18b03b1d4d9fc7c63" alt="Przegląd integracji" width="2873" height="1549" data-path="images/integrations-overview-dark.png" />
</Frame>

## 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

<CardGroup cols={2}>
  <Card title="Telefonia" icon="phone" href="/integrations/voip">
    Twilio, Ringostat, Binotel — połączenia telefoniczne i SMS obsługiwane przez AI
  </Card>

  <Card title="Komunikatory" icon="comments" href="/integrations/messengers">
    Telegram, WhatsApp, Instagram DM, Facebook Messenger
  </Card>

  <Card title="Google Workspace" icon="google" href="/integrations/google-workspace">
    Gmail, Docs, Sheets, Drive, Calendar, Meet
  </Card>

  <Card title="Kampanie reklamowe" icon="chart-line" href="/integrations/advertising">
    Google Ads, Facebook Ads — analityka i zarządzanie kampaniami
  </Card>

  <Card title="Własny Webhook" icon="webhook" href="/integrations/webhook">
    Wysyłaj dane o leadach do dowolnego CRM lub zewnętrznego systemu
  </Card>
</CardGroup>

## Jak to działa

Każda integracja działa według tego samego schematu:

<Steps>
  <Step title="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).
  </Step>

  <Step title="Zweryfikuj">
    Revol testuje Twoje dane uwierzytelniające w API dostawcy i pobiera dostępne zasoby (numery telefonów, informacje o bocie, połączone konta).
  </Step>

  <Step title="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.
  </Step>

  <Step title="Przypisz do agenta">
    W zakładce **Narzędzia** agenta włącz potrzebne narzędzia. Następnie dodaj je do węzłów workflow — agent może wywoływać te narzędzia podczas rozmów za pomocą wywoływania funkcji LLM.
  </Step>
</Steps>

## 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                         |
| **WhatsApp**      | Integracja WhatsApp  | Wiadomości WhatsApp Business                       |
| **Instagram**     | Integracja Instagram | Wiadomości bezpośrednie Instagram                  |

Aby skonfigurować kanał, przejdź do zakładki **Kanały** agenta, wybierz typ kanału i wskaż, której integracji użyć.

## 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                       |

**Łącznie: 67 narzędzi agenta** w 16 integracjach.

## Następne kroki

<CardGroup cols={2}>
  <Card title="Konfiguracja VoIP" icon="phone" href="/integrations/voip">
    Połącz Twilio, Ringostat lub Binotel dla połączeń telefonicznych AI
  </Card>

  <Card title="Konfiguracja komunikatorów" icon="comments" href="/integrations/messengers">
    Połącz Telegram, WhatsApp, Instagram lub Facebook
  </Card>

  <Card title="Google Workspace" icon="google" href="/integrations/google-workspace">
    Połącz Gmail, Docs, Sheets, Drive, Calendar, Meet
  </Card>

  <Card title="Reklama" icon="chart-line" href="/integrations/advertising">
    Połącz Google Ads lub Facebook Ads
  </Card>
</CardGroup>