PHPackages                             nhanchaukp/zalo-bot-sdk - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. nhanchaukp/zalo-bot-sdk

ActiveLibrary[Utility & Helpers](/categories/utility)

nhanchaukp/zalo-bot-sdk
=======================

Zalo Bot SDK for Laravel - A comprehensive SDK for building Zalo Bots

v1.0.2(8mo ago)81811MITPHPPHP ^8.2

Since Aug 28Pushed 8mo agoCompare

[ Source](https://github.com/nhanchaukp/zalo-bot-sdk)[ Packagist](https://packagist.org/packages/nhanchaukp/zalo-bot-sdk)[ Docs](https://github.com/nhanchaukp/zalo-bot-sdk)[ RSS](/packages/nhanchaukp-zalo-bot-sdk/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependencies (14)Versions (5)Used By (0)

Zalo Bot SDK for Laravel
========================

[](#zalo-bot-sdk-for-laravel)

[![Latest Version on Packagist](https://camo.githubusercontent.com/b63a72c4e73fab7131999a3c2003ced72e78441879dade24d89c7346e2d23d1c/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6e68616e636861756b702f7a616c6f2d626f742d73646b2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/nhanchaukp/zalo-bot-sdk)[![Total Downloads](https://camo.githubusercontent.com/da07e7188e473d287a17050b50e8efbd643655438610b96e1bee0ff0b837bc14/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6e68616e636861756b702f7a616c6f2d626f742d73646b2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/nhanchaukp/zalo-bot-sdk)

Một SDK mạnh mẽ và dễ sử dụng để xây dựng Zalo Bot trên Laravel. Package này được thiết kế với cấu trúc tương tự như Telegram Bot SDK, giúp việc phát triển và bảo trì trở nên đơn giản.

Tính năng
---------

[](#tính-năng)

- ✅ Hỗ trợ nhiều bot cùng lúc
- ✅ Hệ thống command mạnh mẽ và mở rộng
- ✅ Cấu hình linh hoạt và dễ dàng
- ✅ HTTP Client tùy chỉnh (mặc định sử dụng GuzzlePHP)
- ✅ Laravel Facade hỗ trợ
- ✅ Webhook handling
- ✅ Command groups và shared commands
- ✅ Auto-discovery commands
- ✅ Exception handling

Cài đặt
-------

[](#cài-đặt)

Bạn có thể cài đặt package qua Composer:

```
composer require nhanchaukp/zalo-bot-sdk
```

Publish Config
--------------

[](#publish-config)

Publish file config để tùy chỉnh:

```
php artisan vendor:publish --tag="zalo-bot-config"
```

Hoặc:

```
php artisan vendor:publish --provider="NhanChauKP\ZaloBotSdk\ZaloBotServiceProvider" --tag="config"
```

Cấu hình
--------

[](#cấu-hình)

### Biến môi trường

[](#biến-môi-trường)

Thêm các biến sau vào file `.env`:

```
ZALO_BOT_TOKEN=your-zalo-bot-token
ZALO_WEBHOOK_URL=https://yourapp.com/webhook/zalo
ZALO_BASE_BOT_URL=https://bot-api.zapps.me/bot
ZALO_ASYNC_REQUESTS=false
```

### Cấu hình nhiều bot

[](#cấu-hình-nhiều-bot)

Trong file `config/zalo-bot.php`:

```
'bots' => [
    'default' => [
        'token' => env('ZALO_BOT_TOKEN'),
        'webhook_url' => env('ZALO_WEBHOOK_URL'),
        'commands' => [
            // App\ZaloBots\Commands\StartCommand::class
        ],
    ],

    'support_bot' => [
        'token' => env('ZALO_SUPPORT_BOT_TOKEN'),
        'webhook_url' => env('ZALO_SUPPORT_WEBHOOK_URL'),
        'commands' => [
            // App\ZaloBots\Commands\SupportCommand::class
        ],
    ],
],

'default' => 'default', // Bot mặc định
```

Sử dụng cơ bản
--------------

[](#sử-dụng-cơ-bản)

### Gửi tin nhắn

[](#gửi-tin-nhắn)

```
use NhanChauKP\ZaloBotSdk\Facades\ZaloBot;

// Sử dụng bot mặc định
ZaloBot::sendMessage('chat_id', 'Xin chào!');

// Sử dụng bot cụ thể
ZaloBot::bot('support_bot')->sendMessage('chat_id', 'Chúng tôi có thể giúp gì?');
```

### Gửi hình ảnh

[](#gửi-hình-ảnh)

```
ZaloBot::sendPhoto('chat_id', 'https://example.com/image.jpg', 'Caption cho hình ảnh');
```

### Gửi sticker

[](#gửi-sticker)

```
// Lấy sticker từ https://stickers.zaloapp.com/
ZaloBot::sendSticker('chat_id', 'sticker_id_from_stickers_zaloapp_com');
```

### Hiển thị trạng thái (sendChatAction)

[](#hiển-thị-trạng-thái-sendchataction)

Tham khảo tài liệu:

```
use NhanChauKP\ZaloBotSdk\Enums\ChatAction;

// Đang soạn tin nhắn
ZaloBot::sendChatAction('chat_id', ChatAction::Typing);

// Đang tải ảnh (sắp ra mắt)
ZaloBot::sendChatAction('chat_id', ChatAction::UploadPhoto);
```

### Webhook

[](#webhook)

```
// Set webhook
ZaloBot::setWebhook('https://yourapp.com/webhook/zalo');

// Xóa webhook
ZaloBot::deleteWebhook();

// Lấy thông tin webhook
$webhookInfo = ZaloBot::getWebhookInfo();
```

Tạo Commands
------------

[](#tạo-commands)

### Tạo Command class

[](#tạo-command-class)

```