Dokumentacja: Prosta wtyczka AroksDS Submission Alerts for Contact Form 7 to Telegram

Po co ta wtyczka?

W praktyce e-mail nie jest w 100% przewidywalny: nawet gdy Contact Form 7 pokazuje „wysłano”, wiadomość potrafi trafić do spamu, zostać zablokowana przez konfigurację SMTP/DMARC albo przyjść z opóźnieniem. Efekt: utracony lead.

Ta wtyczka tworzy dodatkowy, niezależny kanał powiadomień w Telegramie, aby zespół sprzedaży lub obsługi widział zgłoszenia natychmiast — bez odświeżania panelu i bez ryzyka przeoczenia.

Najważniejsze korzyści

• Backup do e-maila – mniejsze ryzyko utraty leadów przez spam i problemy z dostarczaniem.
• Wspólna grupa dla managerów – jedno miejsce, gdzie każdy widzi nowe zgłoszenia.
• Szybsza reakcja (SLA) – powiadomienie przychodzi od razu po poprawnym wysłaniu formularza.
• Routing bez chaosu – różne formularze → różne czaty lub tematy (sprzedaż / support / rekrutacja).
• Kontrola danych – wysyłasz tylko wybrane pola (Allowed/Excluded) i własny szablon wiadomości.
• Lekkie i przewidywalne – bez ciężkich CRM-ów i zbędnych integracji.

Funkcje

• Tylko po sukcesie: wyzwalanie przez wpcf7_mail_sent (bez „before_send_mail” w edycji WordPress.org).
• Ustawienia globalne + reguły per formularz: ID formularza → ID czatu → (opcjonalnie) ID wątku → szablon → pola.
• Szablony i placeholdery:
  {field-name}, {form_id}, {form_title}, {page_url}, {date}, {time}, {all_fields}.
• Formatowanie: Plain / HTML / MarkdownV2 (wartości placeholderów są bezpiecznie escapowane).
• Logi (ostatnie 100): błędy zawsze; sukcesy tylko po włączeniu Debug Logs.
• Test w panelu: wysyłka wiadomości testowej z wp-admin.
• Brak telemetryki: brak trackingu i zewnętrznych połączeń poza Telegram Bot API.

Co ta wtyczka NIE robi (żeby nie było nieporozumień)

• Wysyła wiadomości tekstowe (Telegram sendMessage) – bez plików/załączników.
• Nie zastępuje e-maila – dodaje kanał zapasowy.
• Nie jest CRM-em i nie buduje bazy leadów w WordPressie (cel: szybka notyfikacja i niezawodność).

Konfiguracja (krok po kroku)

1. Zainstaluj i aktywuj Contact Form 7.
2. Zainstaluj i aktywuj tę wtyczkę.
3. Wejdź w: WordPress → Ustawienia → AroksDS Submission Alerts for Contact Form 7 to Telegram
4. Ustaw Bot Token i Domyślne ID czatu.
5. (Opcjonalnie) ustaw Message Thread ID dla tematów Telegram (forum topics).
6. Ustaw szablon oraz pola Allowed/Excluded.
7. Zakładka Tools → wyślij test.

Prywatność i usługa zewnętrzna

Wtyczka łączy się wyłącznie z Telegram Bot API. Wysyłane dane: chat_id, treść wiadomości (z szablonu i wybranych pól), opcjonalnie parse_mode i message_thread_id. Token bota nie jest zapisywany w logach.
Dane możesz ograniczyć przez Allowed/Excluded oraz edycję szablonu.