Chatgram
Aplikacje i rozszerzenia

Skonfiguruj Chatgram w swojej aplikacji natywnej / rozszerzeniu

Zintegruj Chatgram ze swoją aplikacją mobilną, desktopową lub rozszerzeniem Chrome. Zweryfikuj domenę, uzyskaj Public API Key i zacznij otrzymywać wiadomości od klientów przez Telegram w kilka minut.

~5 min
Czas konfiguracji
Bezpłatnie
Aby rozpocząć
Klucz API
Metoda uwierzytelniania
> ChatgramWidget.init({)
publicKey: 'pk_abc123...',
motyw: { primaryColor: '#EE6055' }
});
✓ Widget zainicjowany przy użyciu klucza API
Uwierzytelnianie kluczem publicznym
Zweryfikuj → uzyskaj klucz → zintegruj
Krok 1: Dodaj rekord DNS

Dodaj ten rekord TXT
do swojej domeny

Przejdź do ustawień DNS swojej domeny i dodaj widoczny tutaj rekord. Ten rekord TXT potwierdza własność domeny i nie wpływa na Twoją stronę, pocztę ani istniejącą konfigurację DNS.

🔒Nie wpływa na działanie Twojej strony ani dostarczanie e-maili
⚡Zmiany propagują się u większości dostawców w ciągu 1–10 minut
🌐Działa z dowolnym dostawcą DNS na całym świecie
Wymagany rekord DNS
Rekord TXT
Typ
TXT
Nazwa / host
_chatgram-verify
Wartość / Treść
chatgram-site-verification=true
TTL
300 (lub automatycznie)
💡
Przykład: Jeśli Twoja domena to mysite.com, pełna nazwa hosta rekordu będzie mieć postać _chatgram-verify.mysite.com. Niektórzy dostawcy automatycznie dopisują domenę — w takim przypadku wpisz tylko _chatgram-verify.
Krok 2: Zweryfikuj domenę

Sprawdź swój rekord DNS
i przejmij swoją witrynę

Wpisz domenę i adres e-mail. Zweryfikujemy rekord TXT, a następnie wyślemy Ci jednorazowy link do logowania do panelu administracyjnego Chatgram. Do rozpoczęcia nie potrzebujesz Telegrama.

🔒Zweryfikowane po stronie serwera
✉️Dostarczanie e-maili
⏱~ 60 sekund
Krok 3: Sprawdź pocztę e-mail

Dalej: sprawdź swoją skrzynkę e-mail

Gdy krok 2 zakończy się powodzeniem, wyślemy Ci jednorazowy link, który zaloguje Cię do panelu administracyjnego Chatgram jako właściciela witryny.

Oczekiwanie na krok 2
Krok 3

Ukończ krok 2, aby otrzymać e-mail z linkiem do logowania

Najpierw zweryfikuj domenę, a link do logowania wyślemy na ten adres e-mail.

Krok 4: Dla deweloperów

Zintegruj z kluczem publicznym

W przypadku aplikacji natywnych i rozszerzeń Chrome automatyczne wykrywanie domeny nie ma zastosowania. Zamiast tego uwierzytelniasz się za pomocą Public API Key, który łączy widżet bezpośrednio z Twoim kontem Chatgram.

Jak uzyskać klucz publiczny
  1. W bocie Chatgram otwórz na dole Ustawienia, a następnie wybierz klucze deweloperskie.
  2. Wybierz swoją domenę. Chatgram wyśle Ci wiadomość z kluczami — przekaż ją swojemu programiście, aby wyodrębnił klucz publiczny (często zaczyna się od pk_) i wstawił go do poniższego kodu.
🔑publicKey zastępuje automatyczne wykrywanie domeny
📱Wymagane w przypadku natywnych aplikacji i rozszerzeń
🔒Można bezpiecznie udostępnić — to klucz publiczny, a nie sekret
⚡Ten sam widżet, te same funkcje, to samo API
Zamień pk_YOUR_PUBLIC_KEY za pomocą klucza z panelu Telegram
Dołącz przez CDN
<script src="https://cdn.jsdelivr.net/npm/chatgram-widget"></script>
lub
<script src="https://unpkg.com/chatgram-widget"></script>
Vanilla JS z kluczem publicznym
<script src="https://cdn.jsdelivr.net/npm/chatgram-widget"></script>
<script>
  window.addEventListener('load', function () {
    ChatgramWidget.init({
      publicKey: 'pk_YOUR_PUBLIC_KEY',
      showTriggerButton: true,
      triggerPosition: 'bottom-right',
      theme: {
        primaryColor: '#EE6055',
        secondaryColor: '#D94F44',
      },
    });
  });
</script>
💡
Jeśli podano publicKey, widget całkowicie pomija automatyczne wykrywanie domeny. To właściwe podejście w przypadku aplikacji natywnych, rozszerzeń Chrome, aplikacji Electron i wszystkich środowisk bez standardowej domeny internetowej. Pełna dokumentacja w npm.
Krok 5: Prześlij NOWE rozszerzenie

Opublikuj kompilację w Chrome Web Store

Gdy Twój widget Chatgram jest skonfigurowany z publicKey i przetestować lokalnie, przygotować kompilację produkcyjną i przesłać ją jako nowe rozszerzenie albo jako aktualizację istniejącego wpisu. Podczas weryfikacji sklepu manifest, uprawnienia i informacje o prywatności są sprawdzane pod kątem faktycznego działania rozszerzenia.

  • Otwórz Panel dewelopera Chrome Web Store i wybierz Nowy element (pierwsza publikacja) lub prześlij nowy pakiet dla rozszerzenia, którym już zarządzasz.
  • Dopasuj swój uprawnienia manifestu z użyciem funkcji Chatgram (na przykład tylko uprawnienia hosta lub API, których naprawdę potrzebujesz) i zachowaj polityka prywatności Dokładny URL, jeśli zbierasz dane użytkowników.
  • Uzupełnij ofertę (opis, zrzuty ekranu, kategoria), a następnie wyślij do weryfikacji. Po zatwierdzeniu użytkownicy mogą zainstalować Twoje rozszerzenie i kontaktować się z Tobą przez ten sam kanał Chatgram, który został wcześniej skonfigurowany.

Wskazówka: Poprawki po uruchomieniu wprowadzisz w tym samym panelu — prześlij nowy plik ZIP i zwiększ numer wersji w manifest.json, a w razie potrzeby ponownie prześlij do weryfikacji.

Jak to działa

Skonfiguruj w 4 prostych krokach

Weryfikacja domeny potwierdza, że jesteś właścicielem domeny, którą chcesz połączyć z Chatgram. Zajmuje to tylko kilka minut i nie wymaga wiedzy technicznej.

01
Krok 01

Zaloguj się do dostawcy DNS

Przejdź do rejestratora domeny lub dostawcy DNS, u którego zarządzasz rekordami domeny. Może to być Cloudflare, GoDaddy, Namecheap lub inny dostawca.

02
Krok 02

Przejdź do rekordów DNS

Znajdź sekcję zarządzania DNS. Poszukaj opcji takich jak „DNS Records”, „DNS Settings”, „Zone Editor” lub „Manage DNS”. Każdy dostawca może używać nieco innej nazwy.

03
Krok 03

Dodaj nowy rekord TXT

Utwórz nowy rekord DNS, używając dokładnie ustawień pokazanych w sekcji „Rekord DNS” na tej stronie. Upewnij się, że typ rekordu to TXT, a wartości są identyczne.

04
Krok 04

Zweryfikuj i aktywuj

Odczekaj kilka minut, aż zmiany DNS się rozpropagują, a następnie wpisz domenę w sekcji weryfikacji domeny i kliknij „Sprawdź teraz”, aby zweryfikować domenę i aktywować Chatgram.

FAQ

Często zadawane pytania

Wszystko, co musisz wiedzieć o weryfikacji DNS i rejestracji domeny w Chatgram.

Masz jeszcze pytania? Skontaktuj się z nami przez czat na żywo Chatgram lub napisz na adres [email protected]

Większość dostawców DNS propaguje rekordy TXT w ciągu 1–10 minut. W rzadkich przypadkach może to potrwać do 48 godzin, zależnie od dostawcy DNS i ustawień TTL. W Cloudflare zwykle trwa to mniej niż 2 minuty.

Nie. Rekordy TXT zawierają wyłącznie metadane w strefie DNS. Dodanie rekordu weryfikacyjnego Chatgram nie ma żadnego wpływu na Twoją stronę internetową, dostarczanie poczty e-mail ani żadne inne obecne rekordy DNS.

Zalecamy pozostawienie rekordu TXT. Chatgram okresowo ponownie weryfikuje własność domeny, aby zapewnić bezpieczeństwo. Jeśli rekord zostanie usunięty, domena może utracić status zweryfikowanej podczas kolejnego cyklu sprawdzania.

Chatgram obsługuje subdomeny. Jeśli chcesz zweryfikować support.mysite.com, dodaj rekord TXT o nazwie _chatgram-verify.support.mysite.com. Wpisz „support.mysite.com” w polu weryfikacji.

Najpierw sprawdź, czy nazwa rekordu to dokładnie _chatgram-verify (niektórzy dostawcy automatycznie dopisują domenę, więc wystarczy wpisać _chatgram-verify). Upewnij się, że wartość to dokładnie chatgram-site-verification=true, bez dodatkowych spacji. Jeśli wszystko się zgadza, odczekaj jeszcze kilka minut, aż zmiany się rozpropagują, i spróbuj ponownie.

Tak. Weryfikacja DNS TXT to standardowa w branży metoda potwierdzania własności domeny, stosowana przez Google, Microsoft, Stripe i inne duże platformy. Odpytujemy publiczne rekordy DNS — nie są potrzebne żadne poufne dane logowania.

Oczywiście. Powtórz te kroki dla każdej domeny, którą chcesz połączyć z Chatgram. Każda domena wymaga własnego rekordu TXT _chatgram-verify. W panelu Chatgram możesz zarządzać wszystkimi zweryfikowanymi domenami w jednym miejscu.

Zaczynamy?

Dodaj rekord.
Zweryfikuj. Uruchom.

Twoi klienci czekają. Skonfiguruj rekord DNS, zweryfikuj domenę i zacznij otrzymywać wiadomości do działu obsługi bezpośrednio w Telegramie.

🔒Weryfikacja zgodna ze standardami branżowymi
⚡Konfiguracja w 5 minut
💬Obsługa klienta oparta na Telegramie