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

Типы сообщений

WhatsApp позволяет отправлять два вида исходящих сообщений. Это Шаблонные исходящие - сообщения и Чат - сообщения в произвольной форме, ответы на сообщения от абонента.

Шаблонные - сообщения#

Данный вид сообщений может быть отправлен Вашей платформой абоненту без его первого вступления в диалог. Вы инициируете диалог с абонентом либо просто отправляете исходящее собщение (например, информацию об акции или код доступа).
💡
Для данного вида сообщений необходимо зарегистрировать исходящие шаблоны и использовать только их. Сообщения не соответствующие шаблонам не будут доставлены до абонента.
 
Шаблоны так же имеют категории и тарифицируются согласно категории зарегистрированного шаблона. Маркетинг, Служебные, Авторизация. Подробнее про типы шаблонов
Шаблонные сообщения могут содержать:
Заголовок — Текст или изображение или видео или документ или местоположение (не обязательный параметр)
Тело — Текст (обязательный параметр)
Подпись — Текст (не обязательный параметр)
Кнопки — В шаблонные сообщения можно добавить до 10 кнопок (в совокупности всех видов) (не обязательный параметр). Подробнее в секции "Кнопки в шаблонных сообщениях"
Пример шаблонного сообщения
TIP
Шаблонные сообщения могут содержать индвидуальные переменные для каждого абонента:
одну переменные в заголовке (если тип заголовка "текст");
до пяти переменных в теле сообщения;
Например: Привет, Алекс. Твоя персональная скидка 20%, только до 15.06.2024
В данном примере в зарегистрированный шаблон передаются три переменных: Алекс, 20 и 15.06.2024
 
💡
Типы заголовоков в шаблонных сообщениях
💡
Тело сообщения в шаблонных сообщениях
💡
Кнопки в шаблонных сообщениях
💡
Сообщение со всеми параметрами
💡
Сообщение со всеми параметрами 2

Шаблонные - Авторизационныe сообщения#

С помощью шаблонов категории "Аутентификация" вы помогаете пользователям проходить аутентификацию, используя одноразовые коды (обычно 4–8-значные буквенно-цифровые коды), например в процессе многошагового входа (подтверждение аккаунта, восстановление аккаунта, проблемы с целостностью аккаунта).

Шаблоны категории "Аутентификация" имеют наибольшие ограничения, вы не можете менять текст сообщения, только подставлять нужные коды.

Основной текст:
Ваш код подтверждения: {{1}}
А так же на момент регистриации шаблона вы можете указать дополнительную инфомацию (текст изменить нельзя)
Из соображений безопасности никому не сообщайте этот код
и/или
Срок действия этого кода истекает через N минут.
Примеры текстов:
"Ваш код подтверждения: {{1}}".
"Ваш код подтверждения: {{1}}. Из соображений безопасности никому не сообщайте этот код".
"Ваш код подтверждения: {{1}}. Срок действия этого кода истекает через 15 минут".
Для изменения текста на Казахский язык, при регистрации шаблона укажите язык - Казахский, тогда текст автоматически будет изменен на
{{1}} — сіздің растау кодыңыз.
{{1}} — сіздің растау кодыңыз. Қауіпсіздігіңіз үшін бұл кодпен бөліспеңіз.
{{1}} — сіздің растау кодыңыз. Қауіпсіздігіңіз үшін бұл кодпен бөліспеңіз.
Кодтың мерзімі 10 минуттан кейін аяқталады.
Так же если необходимо изменить текст на Английский, выберите язык шаблона - Английский
{{1}} is your verification code. For your security, do not share this code.
💡
Авторизационныe сообщения

Чат – сообщения#

Если абонент ответил на Ваше шаблоннное сообщение или первый написал Вам сообщения (без вашего первого исходящего сообщения), вы можете отправлять ему сообщения в произвольной форме не придерживаясь шаблонов в течении 24 часов с момент последнего полученного от абонента сообщения
Чат сообщения могут быть следующего вида:
 

#

В сообщениях с запросом местоположения показывается текст тела и кнопка для отправки местоположения. После нажатия этой кнопки пользователи WhatsApp видят экран предоставления геоданных.
 

#

В аудиосообщениях показывается значок аудио и ссылка на аудиофайл. Когда пользователь WhatsApp нажимает на значок, клиент WhatsApp загружает этот аудиофайл и воспроизводит его.
 

#

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

#

Сообщения с изображениями — это сообщения, в которых показываются одно изображение и необязательная подпись.
 

#

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

#

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

#

Сообщения с местоположением позволяют отправить широту и долготу местоположения пользователю WhatsApp.
 

#

В сообщениях со стикерами показываются анимированные или статические изображения стикеров в сообщении WhatsApp.
 

#

Текстовые сообщения — это сообщения, содержащие только текстовое тело и необязательный предпросмотр ссылки.
 

#

В видеосообщениях показывается миниатюра предпросмотра видео и необязательная подпись. Когда пользователь WhatsApp нажимает предпросмотр, видео загружается и воспроизводится.
 
 
📌
Email: support@kazinfoteh.kz
Тел.: +7 (727) 292-15-93
Тел.: +7 (771) 765 76 45
Тел.: +7 (771) 753 77 60
WhatsApp: +7 (771) 765 76 45
Web: kazinfoteh.kz
Instagram: @kazinfoteh_kz
Facebook: @kazinfotehkz
Previous
WhatsApp API
Next
Форматирование в текстовых сообщениях
Built with