Evolution API na VPS: WhatsApp połączony z automatyzacją

Co robi Evolution API?

Evolution API udostępnia interfejs do integracji komunikacji z innymi systemami. Może przekazywać zdarzenia i obsługiwać wiadomości w połączeniu z automatyzacjami, chatbotami czy narzędziami obsługi klientów. API to interfejs, przez który aplikacje wymieniają polecenia i dane.

W takim zestawie Evolution API odpowiada za warstwę komunikacji. Osobno przygotowujesz logikę procesu, zapis informacji w CRM i pracę człowieka nad sprawą. Nie trzeba od razu wdrażać autonomicznego asystenta AI: prosty, dobrze obsłużony przepływ powiadomień bywa użyteczniejszym początkiem.

Jaki płatny program może zastąpić?

Evolution API może zastąpić część funkcji płatnego konektora WhatsApp lub własny moduł integracyjny. Nie jest pełnym zamiennikiem każdej platformy typu WATI czy respond.io: wspólna skrzynka, obsługa konsultantów i raporty wymagają osobnego porównania lub dodatkowej aplikacji.

W rachunku uwzględnij serwer, bazę, utrzymanie oraz warunki wybranego kanału WhatsApp. Nie traktuj narzędzia jako obietnicy bezpłatnych wiadomości. W pliku licencji projektu znajdują się dodatkowe postanowienia dotyczące oznaczeń i informowania o wykorzystaniu Evolution API. Sprawdź je przy integracji, szczególnie jeśli zamierzasz zmieniać interfejs lub oferować usługę innym firmom.

Cloud API i Baileys to różne drogi

Projekt deklaruje obsługę oficjalnego WhatsApp Cloud API oraz wariantu opartego na Baileys i WhatsApp Web. Samo użycie Evolution API nie sprawia, że oba połączenia stają się tym samym produktem Meta.

Przed rozpoczęciem wybierz sposób integracji, a następnie sprawdź jego wymagania, uprawnienia i koszty. Nie przenoś wniosków z demonstracji z kodem QR na wdrożenie Cloud API. Nie zakładaj również, że samodzielny serwer zapewnia niezależność od zmian po stronie WhatsAppa. Stabilność tego kanału jest częścią oceny rozwiązania.

Przykład: przypomnienie i obsługa odpowiedzi

Przykładowy proces dla firmy usługowej może wyglądać tak:

1. System rezerwacji przekazuje zdarzenie dotyczące wizyty do automatyzacji.
2. Automatyzacja sprawdza dane i reguły kontaktu.
3. Skonfigurowana integracja wysyła wiadomość.
4. Odpowiedź klienta uruchamia webhook, czyli powiadomienie HTTP do innego systemu.
5. Proces zapisuje informację i kieruje sprawę do pracownika, jeśli wymaga rozmowy.

To projekt przepływu do zbudowania. Trzeba przewidzieć także ponowne dostarczenie zdarzenia, brak połączenia i błędny numer. W teście sprawdź, czy powtórzone zdarzenie nie powoduje podwójnej wysyłki. Tych warunków nie rozwiązuje samo uruchomienie kontenera.

Jak wdrożyć aplikację na własnym VPS?

Przygotuj Docker z Compose, domenę i bezpieczne przechowywanie sekretów. Oficjalny zestaw Compose obejmuje między innymi API, PostgreSQL i Redis.

1. Wybierz wydanie i pobierz pasujące pliki Compose oraz wzór .env. Przejrzyj je przed uruchomieniem.
2. Uzupełnij SERVER_URL, DATABASE_CONNECTION_URI, konfigurację Redis i AUTHENTICATION_API_KEY zgodnie z referencją środowiska.
3. Przygotuj trwałe dane bazy i instancji. W sprawdzonym pliku Compose występuje zewnętrzna dokploy-network: utwórz ją, jeśli używasz tego wariantu, albo świadomie dostosuj sieć do własnego wdrożenia.
4. Skonfiguruj reverse proxy z HTTPS. Nie wystawiaj bazy i Redis do internetu; ogranicz również dostęp do panelu zarządzania.
5. Uruchom zestaw przez docker compose up -d, sprawdź logi i konfigurację wybranego kanału.
6. Wykonaj test wysłania, odbioru, webhooka i ponownego startu usług.

Klucze przechowuj poza publicznym repozytorium. Adresy usług wewnątrz sieci kontenerów muszą odpowiadać nazwom usług; localhost wewnątrz kontenera nie oznacza automatycznie serwera bazy.

Wariant Hostinger i eksploatacja

Na VPS Hostingera możesz pracować przez SSH lub skorzystać z Docker Managera. Panel udostępnia opcje Compose, w tym konfigurację ręczną i pobranie z URL. Nadal musisz dostosować sieci, zmienne i trwałe dane.

Po wdrożeniu monitoruj błędy oraz stan połączenia. Ogranicz przechowywanie treści w logach do potrzeb diagnostycznych. Kopia bazy i danych instancji powinna mieć sprawdzoną procedurę odtworzenia. Własny VPS daje kontrolę nad integracją, a zarazem wymaga osoby reagującej wtedy, gdy komunikacja przestaje działać.

Czytaj dalej w tym cyklu

• Twenty: CRM na własnym VPS — do uporządkowania informacji o klientach.
• Mautic: kampanie e-mail — do planowania osobnego kanału marketingowego.
• Wekan: tablice zadań — do organizacji spraw wymagających działania zespołu.