Справочный центр

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

Расширение возможностей конструктора через стороннее API

Настройка приема платежей в ботах

Настройка приема платежей в Телеграм

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

Как рекламировать чат-бот в рекламных каналах, где запрещён редирект, таких как Google.Adwords, MyTarget, VK?

Блокируются ли ссылки на телеграмм в РФ?

Можно ли установить WhatsApp на городской телефон?

Нужно ли иметь отдельный WhatsApp для хранения чат-бота?

Сколько сообщений выдерживает чат-бот?

Как подставить Имя клиента в сообщение?

Как подставить номер телефона клиента в сообщение?

Как подставить id клиента в сообщение?

Как подставить Пользовательскую переменную в сообщение?

Какой максимальный размер файла можно загрузить в сообщение?

Как перезагрузить бота к началу диалога?

Какие форматы картинок можно прикреплять к сообщению?

Какие форматы видео можно прикреплять к сообщению?

Какие форматы файлов можно прикреплять к сообщению?

Сколько файлов можно прикрепить к сообщению?

Куда передаются данные из пользовательских переменных?

Куда могут отправляться уведомления о заявках?

Как рекламировать чат-бот в рекламных каналах, где запрещён редирект, таких как Google.Adwords, MyTarget, VK?

Перейдите по своей ссылке, и скопируйте конечную ссылку из адресной строки браузера после редиректа.

Либо в разделе Опубликовать -> Подготовленные сообщения для WhatsApp кликните на редактирование подготовленного сообщения и поставьте галочку Использовать промежуточную страницу HAiP-BOT

Блокируются ли ссылки на телеграмм в РФ?

Нет, не блокируются

Можно ли установить WhatsApp на городской телефон?

Да, можно

Нужно ли иметь отдельный WhatsApp для хранения чат-бота?

Обслуживание устройства с чат-ботом и номера мы берём на себя

Сколько сообщений выдерживает чат-бот WhatsApp?

Чат-бот способен выдержать 5000 сообщений в сутки

Как подставить Имя клиента в сообщение?

Для вывода полного имени добавьте в текст: {{name}}

Для вывода только имени: {{first_name}}

Для вывода только фамилии: {{last_name}}

Как подставить номер телефона клиента в сообщение?

Добавьте в текст: {{phone}}

Как подставить id клиента в сообщение?

Добавьте в текст: {{id}}

Как подставить пользовательскую переменную в сообщение?

Добавьте в текст: {{$ИмяПеременной}}

Какой максимальный размер файла можно загрузить в сообщение?

100 МБ для загрузки в конструктор

Для каждого мессенджера свои ограничения, если файл превышает норму он отправится в виде ссылки.

  • 64 МБ для отправки в WhatsApp
  • 50 МБ для отправки в Telegram
  • 50 МБ для отправки в Viber

Как перезагрузить бота к началу диалога?

Для Telegram, ICQ - /start

Для остальных мессенджеров команда из 3 нулей - 000

Какие форматы картинок можно прикреплять к сообщению?

jpeg, jpg, png, gif

Какие форматы видео можно прикреплять к сообщению?

mp4, mpeg, mov, webm, ogv, 3gp

Какие форматы файлов можно прикреплять к сообщению?

doc, dot, docx, xls, xlsx, ppt, pptx, pdf, odt, zip, psd, vcard, vcf

Сколько файлов можно прикрепить к сообщению?

10 файлов

Какие форматы аудио можно прикреплять к сообщению?

mp3, wav, ogg

Куда передаются данные из пользовательских переменных?

Они сохраняются до тех пор пока не создастся заявка и отправится уведомление, в котором они будут указаны

Куда могут отправляться уведомления о заявках?

Почта, WhatsApp, Telegram, amoCRM, внешние скрипты через http запросы

Расширение возможностей конструктора через стороннее API

Для включения такой возможности достаточно в окне редактирования шага указать тип диалога - HTTP запрос.

На данный момент поддерживаются методы GET и POST.

Запрос

В теле запроса приходят все пользовательские переменные полученные на предыдущих шагах и контакт пользователя.

Пример запроса:


{
    "variables": [
        {
            "name": "Город",
            "value": "Москва"
        }
    ],
    "contact": {
        "name": "Дмитрий",
        "messenger": "whatsapp",
        "phone": "79999999999"
    }
}

Время ожидания соединения: 3 секунды

Ответ

В случае успеха, сервер должен ответить кодом 200, а тело должно содержать текст для пользователя.

В случае ошибки (например валидации), вы можете сообщить пользователю об этом. Для этого сервер должен ответить кодом 422, а тело должно содержать сообщение для пользователя.

В таком случае не забудьте указать переменную в конструкторе для данного шага, в которую запишется ответ пользователя и отправиться на ваш сервер еще раз.

Текст должен быть форматирован под стандарты WhatsApp. Форматирование под другие мессенджеры происходит автоматически на нашем сервере.

Время получения ответа: 5 секунд

Прием платежей в ботах WhatsApp, Viber, Telegram

Общая схема

Чтобы принимать платежи в ботах WhatsApp, Viber, Telegram нужно в разделе Интеграции подключить платежную систему ЮKassa.

Заполните соответствующие поля во вкладке Основное и нажмите кнопку Сохранить, после чего система сгенерирует webhook (ссылку), который нужно скопировать и сохранить в личном кабинете сервиса ЮKassa в настройках в поле URL для уведомлений.

Во вкладке Оповещения вы можете указать URL для уведомлений (только https), на который будет приходить информация о платежах. Ответ должен содержать код состояния 200. В случае ошибки, система будет пытаться доставить уведомление в течение суток, постепенно увеличивая интервал между запросами.

О каких статусах вы будете получать уведомления:

  • pending - платеж создан, но не завершен.
  • waiting_for_capture - платеж выполнен и ожидает подтверждения.
  • succeeded - платеж успешно завершен.
  • canceled - платеж отменен.

Подробнее о статусах сервиса ЮKassa смотрите по ссылке: https://yookassa.ru/docs/guides/#platezhi

Пример оповещения для статуса pending. Платеж на 900 руб.


{
    "id": 1,
    "provider": "yandex_kassa",
    "provider_id": "12345678-1234-1234-1234-123456789ab",
    "currency": "RUB",
    "amount": 90000,
    "state": "pending",
    "created_at": 1554717083,
    "payload": null,
    "order": [
         {
             "name": "Название товара",
             "description": "Описание товара",
             "amount": 900
         }
    ],
    "contact": {
         "id": 1,
         "name": "Дмитрий",
         "messenger": "whatsapp",
         "phone": "79999999999"
    }
}

Поле amount содержит сумму в минимальной еденице измерения валюты.

Пример оповещения для статуса waiting_for_capture


{
    "id": 1,
    "provider": "yandex_kassa",
    "provider_id": "12345678-1234-1234-1234-123456789ab",
    "currency": "RUB",
    "amount": 90000,
    "state": "waiting_for_capture",
    "created_at": 1554717099,
    "payload": {
        "type": "notification",
        "event": "payment.waiting_for_capture",
        "object": {
            "id": "12345678-1234-1234-1234-123456789ab",
            "status": "waiting_for_capture",
            "paid": true,
            "amount": {
                "value": "900.00",
                "currency": "RUB"
            },
            "authorization_details": {
                "rrn": "858585858585",
                "auth_code": "555444"
            },
            "created_at": "2019-04-08T09: 51: 35.762Z",
            "description": "[ID1] Дмитрий +79999999999",
            "expires_at": "2019-04-15T09: 51: 38.488Z",
            "metadata": [

            ],
            "payment_method": {
                "type": "bank_card",
                "id": "12345678-1234-1234-1234-123456789ab",
                "saved": false,
                "card": {
                    "first6": "555555",
                    "last4": "4444",
                    "expiry_month": "12",
                    "expiry_year": "2021",
                    "card_type": "MasterCard"
                },
                "title": "Bank card *4444"
            },
            "recipient": {
                "account_id": "123456",
                "gateway_id": "654321"
            }
        }
    },
    "order": [
        {
            "name": "Название товара",
            "description": "Описание товара",
            "amount": 900
        }
    ],
    "contact": {
        "id": 1,
        "name": "Дмитрий",
        "messenger": "whatsapp",
        "phone": "79999999999"
    }
}

Настройка приема платежей в Телеграм

Для Телеграм вы можете подключить встроенные платежи, для этого в разделе Каналы добавьте для Телеграм платежный токен, выданный ботом @BotFather.

Вы можете указать URL для уведомлений (только https), на который будет приходить информация о платежах. Ответ должен содержать код состояния 200. В случае ошибки, система будет пытаться доставить уведомление в течение суток, постепенно увеличивая интервал между запросами.

О каких статусах вы будете получать уведомления:

  • pending - платеж создан, но не завершен.
  • pre_checkout_query - система готова принять платеж.
  • succeeded - платеж успешно завершен.
  • canceled - платеж отменен.

Пример оповещения для статуса pending. Платеж на 900 руб.


{
   "id": 1,
   "provider": "telegram",
   "provider_id": null,
   "currency": "RUB",
   "amount": 90000,
   "state": "pending",
   "created_at": 1554717025,
   "payload": null,
   "order": [
      {
         "name": "Название товара",
         "description": "Описание товара",
         "amount": 900
      }
   ],
   "contact": {
      "id": 1,
      "name": "Дмитрий Иванов",
      "messenger": "telegram",
      "phone": "79999999999",
      "telegram_id": "1234567",
      "telegram_username": "superman"
   }
}

Поле amount содержит сумму в минимальной еденице измерения валюты.

Пример оповещения для статуса pre_checkout_query


{
   "id": 1,
   "provider": "telegram",
   "provider_id": null,
   "currency": "RUB",
   "amount": 90000,
   "state": "pre_checkout_query",
   "created_at": 1554717052,
   "payload": {
      "id": "12345678901234567",
      "from": {
         "id": 1234567,
         "is_bot": false,
         "first_name": "Дмитрий",
         "last_name": "Иванов",
         "username": "superman",
         "language_code": "ru"
      },
      "currency": "RUB",
      "total_amount": 90000,
      "invoice_payload": "ba9ff39b297685db6102df93f97c8f66"
   },
   "order": [
      {
         "name": "Название товара",
         "description": "Описание товара",
         "amount": 900
      }
   ],
   "contact": {
      "id": 1,
      "name": "Дмитрий Иванов",
      "messenger": "telegram",
      "phone": "79999999999",
      "telegram_id": "1234567",
      "telegram_username": "superman"
   }
}

Обратите внимание на то, что Телеграм принимает платежи в диапазоне 1-10000$ USD.