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. Шаблонные сообщения

Сообщение со всеми параметрами - заголовок изображение

POST
https://kazinfoteh.orh/wasender/sendwamsg

Используйте этот метод для отправки шаблонных сообщений по каналу WhatsApp.#

Если запрос принят к исполнению, сервер возвращает ответ с кодом 200, содержащий JSON-объект с идентификатором запроса, который присвоила система. Если первичная проверка запроса окончилась ошибкой, то возвращается ответ с кодом ошибки.
 
Информация о результате отправки сообщения адресату придет на установленный вами вебхук.
 
INFO
| Адрес |
| https://kazinfoteh.org/wasender/sendwamsg |
INFO
Для отправки запросов Вам потребуется X-API-KEY выданный Вашим менеджером.
INFO
В примере рассматривается зарегистированный шаблон
Имя шаблона - myTemplate. Для получаения имен шаблонов используйте метод gettemplate
Заголовок - Изображение
Текст тело - Привет {{1}}, для тебя скидка {{2}}, только до {{3}}. Твой промокод {{4}} и логин {{5}}
Подпись - Ваш любимый магазин
Две кнопки быстрого ответа:
Название кнопки: Интересует
Название кнопки: Хочу отписаться
INFO
Пояснение
Заголовок - URL изображение указывается в запросе
Текст тело - Переменные {{1}}, {{2}}, {{3}}, {{4}}, {{5}} указываеются в запросе. (весь текст не указывается, только переменные)
Подпись - (береться из шаблона, в запросе не указывается)
Две кнопки быстрого ответа - название кнопок берется из шаблона, в запросе указывается только payload (ваш индификатор кнопок, вы его получите в входящем сообщении если абонент нажмет на кнопку)
CAUTION
Для получению статусов и входящих сообщений от абонента, Вам необходимо реализовать "приемущик" (webhook) на своей стороне, разместить на своем сервере и задать его методом SetWebhook
INFO
Для получаения имен шаблонов и примеров текста, которые вы подавали на регистрацию используйте метод gettemplate
CHECK
"contentType": "TEMPLATE"

Request

Header Params
X-API-KEY
string 
required
Example:
123
Body Params application/json
requestId
string 
optional
Ваш индификтор запроса
Example:
test-01
to
string 
required
Номер телефона абонента в формате 7XXXXXXXXXX
>= 11 characters<= 15 characters
Example:
77771234567
content
object 
required
whatsappContent
object 
required
Example
{
    "requestId": "test-001",
    "to": "77771234567",
    "content": {
        "whatsappContent": {
            "contentType": "TEMPLATE",
            "name": "myTemplate",
            "bodyParameters": {
                "param1": "Алекс",
                "param2": "20",
                "param3": "20.06.2024",
                "param4": "1ERTB3",
                "param5": "myLogin"
            },
            "header": {
                "type": "image",
                "url": "https://kazinfoteh.kz/img/display.png"
            },
            "keyboard": {
                "rows": {
                    "buttons": [
                        {
                            "type": "QUICK_REPLY",
                            "payload": "1"
                        },
                        {
                            "type": "QUICK_REPLY",
                            "payload": "2"
                        }
                    ]
                }
            }
        }
    }
}

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://kazinfoteh.orh/wasender/sendwamsg' \
--header 'X-API-KEY: 123' \
--header 'Content-Type: application/json' \
--data-raw '{
    "requestId": "test-001",
    "to": "77771234567",
    "content": {
        "whatsappContent": {
            "contentType": "TEMPLATE",
            "name": "myTemplate",
            "bodyParameters": {
                "param1": "Алекс",
                "param2": "20",
                "param3": "20.06.2024",
                "param4": "1ERTB3",
                "param5": "myLogin"
            },
            "header": {
                "type": "image",
                "url": "https://kazinfoteh.kz/img/display.png"
            },
            "keyboard": {
                "rows": {
                    "buttons": [
                        {
                            "type": "QUICK_REPLY",
                            "payload": "1"
                        },
                        {
                            "type": "QUICK_REPLY",
                            "payload": "2"
                        }
                    ]
                }
            }
        }
    }
}'

Responses

🟢200OK
application/json
Body
status
string 
required
Статус запроса
ok - первичная проверка прошла успешно, сообщение отпарвленно в WhatsApp (финальные статус доставлено, не доставлено, ошибка) вы получите на ваш webhook
requestId
string 
required
ID запроса
Example
{
    "status": "ok",
    "requestId": "43"
}
🟠401Unauthorized
🟠400Bad Request
🟠404Record Not Found
Previous
Общее описание запроса
Next
Сообщение со всеми параметрами - заголовок текст
Built with