KiT Docs Portal
  1. Шаблонные сообщения
KiT Docs Portal
  • KiT Docs Portal
  • Личный кабинет
  • WhatsApp API
    • Типы сообщений
    • Форматирование в текстовых сообщениях
    • Форматы WhatsApp Media
    • Коды ошибок платформы WABA
    • Шаблонные сообщения
      • Категории шаблонов
      • Типы заголовков в шаблонных сообщениях
      • Тело шаблонного сообщения
      • Кнопки в шаблонных сообщениях
      • Общее описание запроса
        POST
      • Сообщение со всеми параметрами - заголовок изображение
        POST
      • Сообщение со всеми параметрами - заголовок текст
        POST
      • Сообщение изображение и текст
        POST
      • Сообщение изображение, текст и подпись сообщения
        POST
      • Сообщение изображение, текст и 2 кнопки - переход на сайт и позвонить
        POST
      • Сообщение изображение, текст и 3 кнопки быстрого ответа
        POST
      • Сообщение с кнопками содержащие динамическое дополнение к основному URL
        POST
      • Сообщение местоположение и текст
        POST
      • Сообщение динамиечский текст тело сообщения
        POST
      • Сообщение динамиечский текст тело сообщения и заголовка сообщения
        POST
      • Сообщение статичный текст
        POST
      • Получить имена всех шаблонов - gettemplate
        POST
    • Авторизационныe сообщения
      • Авторизационное сообщение
    • Чат сообщения
      • Сообщение текстовое
      • Сообщение с изображением
      • Сообщение аудиозапись
      • Сообщение с документом
      • Сообщение с видео
      • Сообщение со стикерам
      • Сообщение с списками
      • Сообщение с кнопками ответа
      • Сообщение с кнопкой перехода на URL
      • Сообщение с местоположением
      • Сообщение запрос местоположения
    • Входящие сообщения от абонента
      • Входящие сообщения от абонента
      • Текстовое входящее сообщение
      • Медиа (изображение, аудио, видео, документ, стикер) - входящее сообщение
      • Местоположение - входящее сообщение
      • Нажатие на кнопку быстрого ответа
      • Нажатие на кнопку из списка (из листа)
    • Установить WebHook - setwebhook
      POST
    • Статусы сообщений на WebHook
      POST
  • HTTP SMS API
    • sendMessage
    • getMessageByID
    • reporturl
  • JSON SMS API
    • send
    • sendBulk
    • reportByID
    • reportByExtraID
    • reportByBulkID
    • reportByPeriod
    • getSenders
    • notify_url
  • SOAP SMS API
    • sendMessage
    • sendBulkMessage
    • getInfoByID
    • getBulkInfoByID
    • getAbonents
    • getReport
    • getSenders
  • XML SMS API
    • sendMessage
    • sendBulkMessage
    • getInfoByID
  • MobiCheck SMS API. OTP/2FA
    • sendRequest
    • verifyPin
    • verifyRequest
  • SMPP SMS API
    • SMPP 3.4
  1. Шаблонные сообщения

Кнопки в шаблонных сообщениях

TIP
Кнопки в шаблонных сообщених являеются не обязательным параметром
В шаблонные сообщения можно добавить до 10 кнопок (в совокупности всех видов)
URL - переход по указанному URL. В сообщении может быть только две кнопки с данным типом
Номер телефона (PHONE) - звонок по указанному телефону. В сообщении может быть только одна кнопка с данным типом.
Бытрый ответ (REPLY) - кнопка, при нажатии на которую вам прийдет входящее сообщение от абонента с индификатором нажатой кнопке. В сообщении может быть до 10 кнопок с данным типом.
Копировать промо код (CODE) - кнопка, при нажатии на которую копируются код в буфер обмена, который вы задали. В сообщении может быть только одна кнопка данного типа.
DANGER
В шаблоне не может быть более 10 кнопок в совокупности всех видов.
DANGER
Если в вашем шаблоне есть только кнопки URL и/или PHONE, то струтктура "keyboard" не заполняется, при условии если вы не используете кнопки содержащие динамическое дополнение к основному URL.
Название кнопок, URL, номер телефона, указывается при регистрации шаблона и автоматически подставляются из шаблонов.
Если же в вашем шаблоне используются кнопки быстрого ответа или копировать промо код или кнопки перехода по URL содержащие динамическое дополнение к основному URL то необходимо заполнить структуру "keyboard" и указать параметры.
💡
Кнопки перехода по URL содержащие динамическое дополнение к основному URL - персонализированная ссылка для клиента
Основной URL задается на момент регистрации шаблона и его изменить нельзя.
Например, при регистарции шаблона мы указали
Кпопка 1 Название - "Перейти на сайт" и его основной URL https://kazinfoteh.kz/
Кпопка 2 Название "Ваш купон" и его основной URL https://kazinfoteh.kz/
В запросе вы можете указать дополнение к нему, например.
К кнопке 1 - waba.html
К кнопке 2 - get.php?code=12345&userId=120
В итоге по нажатию на
кнопку 1 абонент перейдет https://kazinfoteh.kz/waba.html
кнопку 2 абонент перейдет https://kazinfoteh.kz/get.php?code=12345&userId=120
Перед указанием дополенение, проверьте как вы зарегистировали шаблон и как передаете дополенение, чтобы получился правильный URL
Например, вы при регистарции шаблона указали основной URL как https://kazinfoteh.kz/
а параметр передаете /waba.html
В итоге получиться https://kazinfoteh.kz//waba.html
что приведет к неверному URL
Пример запрос с двумя кнопками быстрого ответа (REPLY)#
	    "keyboard": {
                "rows": {
                    "buttons": [
                        {
                             "type": "QUICK_REPLY",
                            "payload": "ConnectOperator"
                        },
                        {
                            "type": "QUICK_REPLY",
                            "payload": "More"
                        }
                    ]
                }
            }
Пример запрос с двумя кнопками быстрого ответа (REPLY) и одной кнопкой копировать код (CODE)#
	    "keyboard": {
                "rows": {
                    "buttons": [
                        {
                             "type": "QUICK_REPLY",
                            "payload": "1"
                        },
                        {
                            "type": "QUICK_REPLY",
                            "payload": "2"
                        }
                        ,
                        {
                            "type": "CODE",
                            "payload": "1YF56NB4"
                        }
                    ]
                }
            }
 
type - Тип кнопки, для кнопок быстрого ответа QUICK_REPLY, для копировать код - CODE | обязательный параметр
payload - Ваш индификатор кнопки, данный индификатор прийдет вам в входящем сообщении от абонента, если абонент нажал кнопку или промо код для кнопки с типом копировать код | обязательный параметр
Пример запрос с двумя кнопками содержащие динамическое дополнение к основному URL#
	    "keyboard": {
                "rows": {
                    "buttons": [
                        {
                            "type": "URL-BTN1",
                            "url": "/code=1234"
                        },
						   {
                            "type": "URL-BTN2",
                            "url": "/code=345"
                        }
                    ]
                }
            }
 
type - Тип кнопки, URL-BTN1 или URL-BTN2 | обязательный параметр
url - Дополнение к основному URL | обязательный параметр
Пример запрос с одной кнопкой быстрого ответа (REPLY) и двумя кнопками содержащие динамическое дополнение к основному URL#
	 "keyboard": {
                "rows": {
                    "buttons": [
						{
                            "type": "QUICK_REPLY",
                            "payload": "1"
                        },
                        {
                            "type": "URL-BTN1",
                            "url": "/code=1234"
                        },
						   {
                            "type": "URL-BTN2",
                            "url": "/code=345"
                        }
                    ]
                }
            }
Previous
Тело шаблонного сообщения
Next
Общее описание запроса
Built with