Местоположение - входящее сообщение

POST

https://ВашWebhook

На ваш URL приходит JSON запрос следующего формата.

CAUTION

Для получения статусов и входящих сообщений от абонента, Вам необходимо реализовать "приемщик" (webhook) на своей стороне, разместить на своем сервере и задать его методом SetWebhook

CHECK

"typeRequest": "inboxmsg"
"type": "location"

Request

Header Params

X-API-KEY

string

required

Ваш X-API-KEY, который вы задали через "Установить WebHook - setwebhook"

Example:

123

Body Params application/json

typeRequest

string

required

Тип запроса. Для входящих сообщений inboxmsg

Example:

inboxmsg

string

required

ID входящего сообщения

Example:

D6A10943-23F0-4CDB-ACFE-B11E0B8EE679

receivedAt

string

required

Дата и время сообщения

Example:

2024-12-20 12:38:36

channel

string

required

Номер канала на который отправлено сообщение

Example:

77009999999

payload

object

required

type

string

required

Тип входящего сообщения. Для местоположения - location

Example:

text

payload

object

required

sender

object

required

phone

string

required

Номер отправителя

Example:

77771234567

name

string

required

Никнейм в системе WhatsApp

Example:

Abai

context

object

required

Структура доступна если абонент процитировал ваше сообщение или переслал сообщение вам от другого абонента

string

required

ID вашего исходящего сообщения, которое цитирует абонент

Example:

POA10943-23F0-4CDB-ACFE-B11E0B8EE679

forwarded

string

required

true - абонент переслал вам это сообщение от другого абонента

Example:

false

frequently_forwarded

string

required

true - это часто пересылаемое сообщение

Example:

false

Example

{
  "typeRequest": "inboxmsg",
  "id": "D6A10943-23F0-4CDB-ACFE-B11E0B8EE679",
  "receivedAt": "2024-12-20 12:38:36",
  "channel": "77009999999",
  "payload": {
    "type": "location",
    "payload": {
      "longitude": "76.817924499512",
      "latitude": "43.204887390137"
    }
  },
  "sender": {
    "phone": "77771234567",
    "name": "Abai"
  },
  "context": {
    "id": "POA10943-23F0-4CDB-ACFE-B11E0B8EE679",
    "forwarded": "false",
    "frequently_forwarded": "false"
  }
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://ВашWebhook' \
--header 'X-API-KEY: 123' \
--header 'Content-Type: application/json' \
--data-raw '{
    "typeRequest": "inboxmsg",
    "id": "D6A10943-23F0-4CDB-ACFE-B11E0B8EE679",
    "receivedAt": "2024-12-20 12:38:36",
    "channel": "77009999999",
    "payload": {
        "type": "location",
        "payload": {
            "longitude": "76.817924499512",
            "latitude": "43.204887390137"
        }
    },
    "sender": {
        "phone": "77771234567",
        "name": "Abai"
    },
    "context": {
        "id": "POA10943-23F0-4CDB-ACFE-B11E0B8EE679",
        "forwarded": "false",
        "frequently_forwarded": "false"
    }
}'

Responses

🟠404Record Not Found

text/html

Body

object {0}

Example

Сервис недоступен, попробуйте позднее

Modified at 2025-03-18 05:04:00

Медиа (изображение, аудио, видео, документ, стикер) - входящее сообщение

Нажатие на кнопку быстрого ответа

Местоположение - входящее сообщение

На ваш URL приходит JSON запрос следующего формата.#

Request

Request samples

Responses

На ваш URL приходит JSON запрос следующего формата.