API WhatsApp Business Management

QR-коды и короткие ссылки

В этом руководстве рассказывается, как создавать QR-коды с помощью WhatsApp Business Management API и управлять ими.

Клиенты могут легко начать переписку с вашей компанией, отсканировав QR-код. API WhatsApp Business Management позволяет создавать и открывать эти QR-коды и связанные с ними короткие ссылки.

Если вы можете работать с QR-кодами через Business Manager, а не через API, обратитесь к статье об управлении QR-кодами WhatsApp.

Прежде чем начать

Вам понадобится:

Создание QR-кода

Чтобы создать QR-код, отправьте запрос POST к конечной точке Номер телефона WhatsApp Business > Message Qrdls.

Добавьте в тело запроса объект, в свойстве prefilled_message которого указан текст сообщения, а в свойстве generate_qr_image — нужный формат изображения (SVG или PNG).

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

curl 'https://graph.facebook.com/v19.0/106540352242922/message_qrdls' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer EAAJB...' \
-d '
{
  "prefilled_message": "Cyber Monday",
  "generate_qr_image": "SVG"
}'

Пример ответа

{
  "code": "4O4YGZEG3RIVE1",
  "prefilled_message": "Cyber Monday 1",
  "deep_link_url": "https://wa.me/message/4O4YGZEG3RIVE1",
  "qr_image_url": "https://scontent-iad3-2.xx.fbcdn.net/..."
}

Получение списка QR-кодов

Чтобы получить список всех QR-кодов для номера телефона компании, отправьте запрос GET к конечной точке Номер телефона WhatsApp Business > Message Qrdls.

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

curl 'https://graph.facebook.com/v19.0/106540352242922/message_qrdls' \
-H 'Authorization: Bearer EAAJB...'

Пример ответа

{
  "data": [
    {
      "code": "4O4YGZEG3RIVE1",
      "prefilled_message": "Cyber Monday",
      "deep_link_url": "https://wa.me/message/4O4YGZEG3RIVE1"
    },
    {
      "code": "WOMVT6TJ2BP7A1",
      "prefilled_message": "Tell me more about your production workshop",
      "deep_link_url": "https://wa.me/message/WOMVT6TJ2BP7A1"
    }
  ]
}

Получение QR-кода

Чтобы получить информацию о конкретном QR-коде, отправьте запрос GET к конечной точке Номер телефона WhatsApp Business > Message Qrdls, указав ID QR-кода в качестве параметра пути.

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

curl 'https://graph.facebook.com/v19.0/106540352242922/message_qrdls/4O4YGZEG3RIVE1' \
-H 'Authorization: Bearer EAAJB...'

Пример ответа

{
  "data": [
    {
      "code": "4O4YGZEG3RIVE1",
      "prefilled_message": "Cyber Monday",
      "deep_link_url": "https://wa.me/message/4O4YGZEG3RIVE1"
    }
  ]
}

Обновление QR-кода

Чтобы обновить QR-код, отправьте запрос POST к конечной точке Номер телефона WhatsApp Business > Message Qrdls.

В теле запроса укажите в свойстве code ID QR-кода, который нужно обновить, а в свойстве prefilled_message — новый текст QR-кода.

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

curl 'https://graph.facebook.com/v19.0/106540352242922/message_qrdls' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer EAAJB...' \
-d '
{
    "code": "4O4YGZEG3RIVE1",
    "prefilled_message": "Cyber Tuesday"
}'

Пример ответа

{
  "code": "4O4YGZEG3RIVE1",
  "prefilled_message": "Cyber Tuesday",
  "deep_link_url": "https://wa.me/message/4O4YGZEG3RIVE1"
}

Удаление QR-кода

Срок действия QR-кодов не заканчивается автоматически. Чтобы удалить QR-код, отправьте запрос DELETE к конечной точке Номер телефона WhatsApp Business > Message Qrdls, указав ID QR-кода в качестве параметра пути.

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

curl -X DELETE 'https://graph.facebook.com/v19.0/106540352242922/message_qrdls/4O4YGZEG3RIVE1' \
-H 'Authorization: Bearer EAAJB...'

Пример ответа

{
  "success": true
}

Справка

Дополнительная информация