Как использовать?
Привязать номер
Подключите ваш или любой другой номер через QR-код для тестирования
Тестирование методов API
Начните уже через 1 минуту, благодаря удобному инструменту для разработчиков
Настройка Хуков
Выберите и настройте webhook на любое событие в WhatsApp для отправки и получения сообщений
Что такое Whapi.Cloud?
Whapi.Cloud — это современный шлюз WhatsApp API, разработанный для оптимизации решений по обмену сообщениями для бизнеса и разработчиков. Он обеспечивает бесшовную интеграцию с инструментами для автоматизации рабочих процессов, управления группами, массовой рассылки сообщений и улучшения взаимодействия с клиентами.
Созданный для гибкости, Whapi.Cloud предлагает мощные функции, выходящие за рамки официального API, такие как поддержка управления сообществами и обновления пользовательских статусов. Благодаря прозрачному ценообразованию, качественной документации и удобным SDK, это идеальный выбор для масштабирования операций WhatsApp с сохранением эффективности и надежности.
Ознакомьтесь с API WhatsApp
Мы регулярно обновляем новые функции для улучшения вашего опыта. Если вы ищете отсутствующую функцию, пожалуйста, свяжитесь с нашей службой поддержки.
Документация по WhatsApp API PHP SDK
Установка
composer require whapi-cloud/whatsapp-api-sdk-php
Начальная настройка
use OpenAPI\Client\Api\MessagesApi;
use OpenAPI\Client\Configuration;
// Initialize the client
$config = OpenAPI\Client\Configuration::getDefaultConfiguration()
->setApiKey('token', "your_token")
->setAccessToken("your_token");
$apiInstance = new OpenAPI\Client\Api\MessagesApi(
new GuzzleHttp\Client(),
$config
);
API сообщений
Отправка текстовых сообщений
// Create text message object
$sender_text = new \OpenAPI\Client\Model\SenderText();
$sender_text->setTo('13016789891'); // Include country code
$sender_text->setBody('Your message here'); // Message content
// Optional parameters
$sender_text->setEphemeral(3600); // Message visibility time in seconds
$sender_text->setViewOnce(true); // View once setting
$sender_text->setTypingTime(5.0); // Typing simulation duration
$sender_text->setNoLinkPreview(false); // Enable/disable link previews
// Send the message
$result = $apiInstance->sendMessageText($sender_text);
print_r($result);
Отправка изображений с подписями
// Create image message object
$sender_image = new \OpenAPI\Client\Model\SenderImage();
$sender_image->setTo('13016789891'); // Recipient's number
$sender_image->setCaption('Image caption');
$sender_image->setMedia('https://example.com/image.jpg');
// Send the image
$result = $apiInstance->sendMessageImage($sender_image);
print_r($result);
Получение сообщений
Получение нескольких сообщений
// Parameters
$count = 100; // Number of messages to retrieve
$offset = 0; // Pagination offset
// Get messages
$result = $apiInstance->getMessages($count, $offset);
print_r($result);
Получение одного сообщения
// Get message by ID
$message_id = "your_message_id";
$result = $apiInstance->getMessage($message_id);
print_r($result);
API групп WhatsApp
Создание групп
$apiInstance = new OpenAPI\Client\Api\GroupsApi(
new GuzzleHttp\Client(),
$config
);
// Create group request
$create_group_request = [
"subject" => "Group Name",
"participants" => [
"13016789891",
"13016789892"
]
];
// Create the group
$result = $apiInstance->createGroup($create_group_request);
print_r($result);
Важные примечания
- Номера телефонов:
- Всегда включайте код страны (например, '13016789891' для номера в США)
- Не используйте специальные символы или пробелы
- URL медиафайлов:
- Должны быть общедоступны
- Поддерживаются популярные форматы изображений (JPEG, PNG и т. д.)
- Опции сообщений:
- Эфемерные: время в секундах до удаления сообщения
- ViewOnce: сообщение можно просмотреть только один раз
- TypingTime: имитация задержки при наборе текста
Обработка ошибок
try {
$result = $apiInstance->sendMessageText($sender_text);
print_r($result);
} catch (Exception $e) {
echo "Error: " . $e->getMessage();
}
- Избегайте отправки слишком большого количества сообщений за короткий промежуток времени
- Реализуйте надлежащую обработку ошибок
- Сохраняйте и управляйте ID сообщений для отслеживания
- Регулярно отслеживайте ответы API
- Поддерживайте корректное ведение логов для отладки