Приложения и расширения

Настройте Chatgram в своём нативном приложении / расширении

Интегрируйте Chatgram в мобильное или десктопное приложение либо расширение Chrome. Подтвердите домен, получите публичный API-ключ и уже через несколько минут принимайте обращения в Telegram.

~5 мин

Время настройки

Бесплатно

Для начала

Ключ API

Метод аутентификации

> ChatgramWidget.init({)
publicKey: 'pk_abc123...',
тема: { primaryColor: '#EE6055' }
});
✓ Виджет инициализирован с ключом API

Аутентификация по публичному ключу

Подтвердите → получите ключ → подключите

Шаг 1: добавьте запись DNS

Добавьте эту TXT-запись
для своего домена

Откройте настройки DNS своего домена и добавьте указанную здесь запись. Эта TXT-запись подтверждает право владения доменом и не влияет на ваш сайт, электронную почту и существующую конфигурацию DNS.

🔒Не влияет на работу сайта и доставку писем

⚡Распространяется за 1–10 минут у большинства провайдеров

🌐Работает с любым DNS-провайдером по всему миру

Обязательная DNS-запись

Запись TXT

Тип

TXT

Имя / Хост

_chatgram-verify

Значение / Содержимое

chatgram-site-verification=true

TTL

300 (или автоматически)

💡

Например: Если ваш домен — mysite.com, полное имя хоста записи будет _chatgram-verify.mysite.com. Некоторые провайдеры автоматически добавляют домен — в таком случае просто введите _chatgram-verify.

Шаг 2: подтвердите домен

Проверьте запись DNS
и подтвердите права на сайт

Укажите домен и адрес электронной почты. Мы проверим TXT-запись, а затем отправим вам одноразовую ссылку для входа в панель администратора Chatgram. Чтобы начать, Telegram не нужен.

🔒Проверено сервером

✉️Доставка писем

⏱~ 60 секунд

Ваш домен *

Ваш адрес электронной почты *

Шаг 3: проверьте почту

Далее: проверьте почту

После успешного выполнения шага 2 мы отправим вам одноразовую ссылку для входа в панель администратора Chatgram в качестве владельца сайта.

Ожидание шага 2

Шаг 3

Выполните шаг 2, чтобы получить письмо для входа

Сначала подтвердите домен, затем ссылка для входа будет отправлена на этот адрес.

Шаг 4: для разработчиков

Интеграция с публичным ключом

Для нативных приложений и расширений Chrome автоматическое определение домена не работает. Вместо этого выполните аутентификацию с помощью публичного API-ключа, который связывает виджет напрямую с вашей учётной записью Chatgram.

Как получить публичный ключ

В боте Chatgram откройте Настройки внизу, затем нажмите ключи разработки.
Выберите свой домен. Chatgram пришлёт вам сообщение с ключами — перешлите его разработчику, чтобы он извлёк публичный ключ (часто начинается с pk_) и вставил его в код ниже.

🔑publicKey заменяет автоматическое определение домена

📱Требуется для нативных приложений и расширений

🔒Можно показывать — это публичный ключ, а не секрет

⚡Один и тот же виджет, те же функции, тот же API

Полная документация на npm

Заменить pk_YOUR_PUBLIC_KEY с ключом из панели управления Telegram

Подключение через CDN

<script src="https://cdn.jsdelivr.net/npm/chatgram-widget"></script>

или

<script src="https://unpkg.com/chatgram-widget"></script>

Vanilla JS с публичным ключом

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

💡

Если передан publicKey, виджет полностью отключает автоматическое определение домена. Это правильный подход для нативных приложений, расширений Chrome, приложений Electron и любых сред без стандартного веб-домена. Полная документация — на npm.

Как это работает

Настройка за 4 простых шага

Подтверждение домена позволяет удостовериться, что вы владеете доменом, который хотите подключить к Chatgram. Это займёт всего несколько минут и не требует специальных технических знаний.

Шаг 01

Войдите в аккаунт у своего DNS-провайдера

Перейдите к регистратору домена или DNS-провайдеру, где вы управляете DNS-записями домена. Это может быть Cloudflare, GoDaddy, Namecheap или любой другой провайдер.

Шаг 02

Перейти к DNS-записям

Найдите раздел управления DNS. Ищите пункты вроде «DNS-записи», «Настройки DNS», «Редактор зоны» или «Управление DNS». У разных провайдеров названия немного различаются.

Шаг 03

Добавить TXT-запись

Создайте DNS-запись с точными настройками, указанными в разделе «DNS-запись» на этой странице. Убедитесь, что тип записи — TXT, а значения указаны без ошибок.

Шаг 04

Подтвердите и активируйте

Подождите несколько минут, пока обновятся записи DNS, затем введите свой домен в разделе «Проверка домена» и нажмите «Проверить сейчас», чтобы подтвердить домен и активировать Chatgram.

Провайдеры DNS

Быстрые ссылки на популярных провайдеров

Перейдите в панель управления DNS-провайдера и добавьте запись подтверждения Chatgram. Не нашли своего провайдера в списке? Процесс одинаковый у всех провайдеров.

Cloudflare

DNS → Выберите домен → Добавьте запись

GoDaddy

Мои товары → DNS → Добавить запись

Namecheap

Список доменов → Управление → Расширенные настройки DNS

Google Domains

Мои домены → DNS → Пользовательские записи

AWS Route 53

Hosted Zones → Select → Create Record

DigitalOcean

Сеть → Домены → Добавить запись

Часто задаваемые вопросы

Всё, что нужно знать о проверке DNS и регистрации домена для Chatgram.

Остались вопросы? Свяжитесь с нами через чат Chatgram или напишите на [email protected]

У большинства DNS-провайдеров распространение TXT-записей занимает от 1 до 10 минут. В редких случаях это может занять до 48 часов — в зависимости от DNS-провайдера и настроек TTL. В Cloudflare обычно меньше 2 минут.

Нет. TXT-записи — это только метаданные в вашей DNS-зоне. Добавление записи подтверждения Chatgram никак не повлияет на ваш сайт, доставку электронной почты и любые другие существующие DNS-записи.

Рекомендуем оставить TXT-запись. Chatgram периодически проверяет владение доменом в целях безопасности. Если удалить запись, при следующей проверке домен может утратить подтверждённый статус.

Chatgram поддерживает поддомены. Чтобы подтвердить домен support.mysite.com, добавьте TXT-запись _chatgram-verify.support.mysite.com. Введите «support.mysite.com» в поле подтверждения.

Сначала проверьте, что имя записи указано точно как _chatgram-verify (некоторые провайдеры автоматически добавляют ваш домен, поэтому, возможно, достаточно ввести только _chatgram-verify). Убедитесь, что значение в точности равно chatgram-site-verification=true и не содержит лишних пробелов. Если всё верно, подождите ещё несколько минут, пока изменения распространятся, и попробуйте снова.

Да. Проверка DNS TXT — стандартный в отрасли способ подтвердить владение доменом, который используют Google, Microsoft, Stripe и другие крупные платформы. Мы проверяем публичные записи DNS — конфиденциальные учётные данные не используются.

Конечно. Повторите процесс для каждого домена, который хотите подключить к Chatgram. Для каждого домена нужна собственная TXT-запись _chatgram-verify. Все подтверждённые домены будут собраны в панели управления Chatgram.

Готовы начать?

Добавьте запись.
Подтвердите. Запустите.

Ваши клиенты ждут. Настройте запись DNS, подтвердите домен и начните получать сообщения в службу поддержки прямо в Telegram.

Подтвердить мой домен Узнайте о Chatgram

🔒Проверка по отраслевому стандарту

⚡Настройка за 5 минут

💬Поддержка на базе Telegram