Download the PHP package kirimi/kirimi-php without Composer
On this page you can find all versions of the php package kirimi/kirimi-php. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download kirimi/kirimi-php
More information about kirimi/kirimi-php
Files in kirimi/kirimi-php
Package kirimi-php
Short Description Official PHP client library for the Kirimi WhatsApp API. Send messages, handle OTP verification, and manage WhatsApp communication with ease.
License MIT
Homepage https://github.com/yolkmonday/kirimi-php
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package kirimi-php
Kirimi PHP Client
Official PHP client library for the Kirimi WhatsApp API. This library provides a simple and efficient way to send WhatsApp messages, handle OTP generation and validation, and manage WhatsApp communication from your PHP applications.
🚀 Features
- ✅ Send WhatsApp messages (text and media)
- ✅ Generate and validate OTP codes
- ✅ Support for multiple package types (Free, Lite, Basic, Pro)
- ✅ PSR-4 autoloading support
- ✅ Comprehensive error handling
- ✅ Type hints and modern PHP features
- ✅ Health check monitoring
- ✅ Service classes for common use cases
📦 Installation
Install via Composer:
🔧 Requirements
- PHP 7.4 or higher
- Guzzle HTTP client (installed automatically)
- ext-json (usually included in PHP)
🔧 Setup
Get your User Code and Secret Key from the Kirimi Dashboard.
📖 API Reference
Constructor
Parameters:
$userCode(string): Your unique user code from Kirimi Dashboard$secret(string): Your secret key for authentication$endpoint(string): API endpoint URL (optional)
Send Message
Send WhatsApp messages with optional media support.
Parameters:
$deviceId(string): Your device ID$receiver(string): Recipient's phone number (with country code)$message(string): Message content (max 1200 characters)$mediaUrl(string|null): URL of media file to send (optional)
Package Support:
- Free: Text only (with watermark)
- Lite/Basic/Pro: Text + Media support
Generate OTP
Generate and send a 6-digit OTP code to a WhatsApp number.
Parameters:
$deviceId(string): Your device ID$phone(string): Phone number to receive OTP
Requirements:
- Package must be Basic or Pro
- Device must be connected and not expired
Validate OTP
Validate a previously sent OTP code.
Parameters:
$deviceId(string): Your device ID$phone(string): Phone number that received the OTP$otp(string): 6-digit OTP code to validate
Notes:
- OTP expires after 5 minutes
- Each OTP can only be used once
Health Check
Check the API service status.
🎯 Quick Start
Check out the examples/demo.php file for a complete demonstration of all features:
💡 Usage Examples
Basic WhatsApp Messaging
OTP Verification Flow
Notification Service
Laravel Integration
📋 Package Types & Features
| Package | ID | Features | OTP Support |
|---|---|---|---|
| Free | 1 | Text only (with watermark) | ❌ |
| Lite | 2, 6, 9 | Text + Media | ❌ |
| Basic | 3, 7, 10 | Text + Media + OTP | ✅ |
| Pro | 4, 8, 11 | Text + Media + OTP | ✅ |
⚠️ Error Handling
The library provides comprehensive error handling using KirimiException:
🔒 Security Notes
- Always keep your secret key secure and never expose it in client-side code
- Use environment variables to store credentials
- Validate phone numbers before sending messages
- Implement rate limiting in your application
🚦 Rate Limits & Quotas
- Each message sent reduces your device quota (unless unlimited)
- OTP codes expire after 5 minutes
- Device must be in 'connected' status to send messages
- Check your dashboard for current quota and usage statistics
🧪 Testing
Run the test suite:
Run tests with coverage:
Check code style:
Fix code style:
🤝 Contributing
Contributions are welcome! Please follow these steps:
- Fork the repository
- Create a feature branch
- Follow PSR-12 coding standards
- Add tests for new features
- Submit a pull request
📄 License
👨💻 Author
Ari Padrian - [email protected]
📚 Additional Resources
Made with ❤️ for the PHP and WhatsApp automation community
