SDK · PHP

WhatsApp API для PHP

waix/waix-php собирает запросы к API v1, передаёт ключ авторизации и возвращает ответы WAIX. Вы работаете с сообщениями и кодами подтверждения из своего приложения.

Как проходит сообщение

SDK · PHPСобытие вашей системыWAIX API v1Шаблон и данные клиентаWhatsAppСообщение, ответ, статус

Ответы и статусы возвращаются в вашу систему через вебхуки. Настройка выполняется один раз.

Подготовьте подключение

PHP 8.1 или новее, расширения cURL и JSON. Установка через Composer, автозагрузка PSR-4.

Для сообщений подключите свой номер и создайте API-ключ. Найдите Connection ID в кабинете, одобрите шаблон order_ready с одной переменной или замените пример на свой шаблон.

Установите SDK

Пакет опубликован в Packagist. Русская инструкция, примеры и исходный код доступны в его репозитории.

composer require waix/waix-php:^0.2

Пакет в Packagist →

Отправьте уведомление о заказе

Ключ и Connection ID читаются из переменных окружения на сервере. UUID операции сохраните в базе до вызова SDK. Пример использует шаблон с одной переменной — номером заказа.

<?php
require 'vendor/autoload.php';

$waix = new Waix\Client(getenv('WAIX_API_KEY'));
// $eventId — UUID, уже сохранённый в записи заказа.
$result = $waix->messages->send([
    'connection_id' => getenv('WAIX_CONNECTION_ID'),
    'to' => '+77071234567', 'type' => 'template',
    'template' => [
        'name' => 'order_ready',
        'language' => ['code' => 'ru'],
        'components' => [[
            'type' => 'body',
            'parameters' => [['type' => 'text', 'text' => '42']]
        ]]
    ]
], $eventId);

Обработайте результат

Методы возвращают весь ответ API, включая data и курсор следующей страницы. HTTP 202 означает, что сообщение поставлено в очередь. Статус доставки проверяется по вебхуку или в журнале.

При ошибке доступны status, errorCode, requestId, retryAfter. Тайм-аут по умолчанию — 30 секунд. Автоматических повторов нет: при сетевом сбое сохраните исходные параметры и ключ идемпотентности.

OTP и подписи вебхуков

Для OTP создайте sandbox-проект и ключ с нужными правами. Доступны создание тестового кода, проверка и статус. Для реальных сообщений нужны ключ Live-проекта и действующий OTP-пакет. Sandbox не подтверждает владение телефоном и не подходит для входа настоящих пользователей.

Проверяйте HMAC вебхука на исходных байтах до разбора JSON. SDK учитывает подпись и время запроса. В приложении также сохраняйте ID события, чтобы не обработать повторную доставку дважды.

Полная инструкция SDK PHP →OTP API →Проверка вебхуков →

Исходный код, тесты и релизы ↗

Сколько стоит подключение

Для собственного номера оплачивается подписка WAIX в тенге, а сообщения — напрямую Meta с карты в вашем WhatsApp Business Account. Количество номеров и сумму можно рассчитать на странице тарифа. Для OTP доступен отдельный пакет; проверить интеграцию можно в бесплатном sandbox.

Рассчитать подписку →Оплата сообщений Meta →

Проверьте интеграцию на своём сценарии

Начните с подключения номера и одного сообщения. Если внедряете WhatsApp клиентам, приглашайте их по своей партнёрской ссылке — она появится в кабинете после регистрации.

Создать аккаунт →Партнёрская программа