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

Настройте 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.

Как получить публичный ключ
  1. В боте Chatgram откройте Настройки внизу, затем нажмите ключи разработки.
  2. Выберите свой домен. Chatgram пришлёт вам сообщение с ключами — перешлите его разработчику, чтобы он извлёк публичный ключ (часто начинается с pk_) и вставил его в код ниже.
🔑publicKey заменяет автоматическое определение домена
📱Требуется для нативных приложений и расширений
🔒Можно показывать — это публичный ключ, а не секрет
⚡Один и тот же виджет, те же функции, тот же API
Заменить 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.
Шаг 5: отправьте НОВОЕ расширение

Опубликуйте свою сборку на Интернет-магазин Chrome

Когда виджет Chatgram подключён к publicKey и протестируйте локально, соберите production-версию и отправьте её как новое расширение или как обновление уже опубликованной карточки. При проверке магазин сверяет манифест, разрешения и сведения о конфиденциальности с фактическими функциями расширения.

  • Откройте Панель разработчика Интернет-магазина Chrome и выберите Новый элемент (первая публикация) или загрузите новый пакет для расширения, которым вы уже управляете.
  • Согласуйте свой разрешения manifest с учётом особенностей Chatgram (например, только необходимые разрешения на хосты или API) и оставьте политика конфиденциальности URL точный, если вы собираете данные пользователей.
  • Заполните карточку компании (описание, скриншоты, категория), затем отправить на проверку. После одобрения пользователи смогут установить расширение и общаться с вами через тот же канал Chatgram, который вы настроили ранее.

Совет: После запуска исправления можно внести в той же панели: загрузите новый ZIP, измените номер версии в manifest.json, а при необходимости снова отправьте заявку на проверку.

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

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

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

01
Шаг 01

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

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

02
Шаг 02

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

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

03
Шаг 03

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

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

04
Шаг 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.

🔒Проверка по отраслевому стандарту
⚡Настройка за 5 минут
💬Поддержка на базе Telegram